fcp

Table of Contents

NAME

fcp – Commands for managing Fibre Channel target adapters and the FCP target protocol.

SYNOPSIS

fcp command argument

DESCRIPTION

The fcp family of commands manages the Fibre Channel Target adapters and the FCP target protocol. These commands can start and stop FCP target service, up and down the target adapters, show protocol statistics and list client adapters connected to the filer.

FCP service must be licensed before the fcp command can be used to manage FCP services. If FCP service is not license, then the fcp command will return an error.

USAGE

fcp config [ adapter [ up | down ] [ partner { adapter | None } | -partner ] [ mediatype { ptp | auto | loop } ] [ speed { 1 | 2 | 4 | auto } ] ]

Configures the Fibre Channel target adapters. When no arguments are given or if only the adapter argument is given, the config subcommand returns configuration information about the adapter(s).

The adapter argument is of the form Xy or Xy_z where X and z are integers and y is a letter (for example 4a or 4a_1). The format depends on the system cfmode setting. When the system cfmode is set to standby, partner or single_image the format is Xy. When the system cfmode is set to mixed or dual_fabric the format is Xy_z. The latter introduces multiple virtual target adapters associated with a physical adapter. Xy_0 is the local port which serves local traffic. Xy_1 is the standby port which takes over the partner WWPN/WWNN during a cluster takeover. Xy_2 is the partner port which will ship SCSI commands over the cluster interconnect to the partner, when not in takeover mode. This will continue to serve data on the partner’s behalf when in takeover mode.

The up and down keywords can bring the adapter online or take the adapter offline. If FCP service is not running, then the adapters are automatically offlined. They cannot be onlined again until FCP service is started by the fcp start command.

The partner option sets the name of the partner adapter which the local adapter should takeover.

To prevent the adapter from taking over any partner adapter port, the keyword None is given as an argument to the partner option.

The -partner option removes the name of the partner adapter which the local adapter should takeover and allows the adapter to takeover a default adapter, based on the cfmode of the configuration. If the system is running in standby mode, then the default adapter for the "b" ports is the "a" port of the partner adapter with the same pci slot number. The default adapter for "a" ports is None. When in mixed, dual_fabric, or single_image mode, the default adapter for a given port is the partner adapter with the same name. 4a will takeover 4a and 5b will takeover 5b. When an adapter is taking over the default partner adapter, changing the cfmode will automatically update the default adapter for a given port.

The mediatype option has been deprecated for clustered filers unless running in the single_image cfmode. Single node systems, and clustered systems running in fcp cfmode single_image can still use the mediatype keyword to set the link topology.

The speed option is used to set the Fibrechannel link speed of an adapter. Adapters that support 4Gb/s can be set to 1, 2, 4 or auto. Adapters that support 2Gb/s can be set to 1, 2 or auto. By default, the link speed option is set to auto to enable auto negotiation. Setting the link speed to a specific value disables auto negotiation. Under certain conditions, a speed mismatch will prevent the adapter from coming online. Note that the actual link speed is reported in the output of fcp show adapter -v, in the Link Data Rate field, while the speed setting is reported in the output of fcp config.

fcp help sub_command

Displays the Help information for the given sub_command.

fcp nodename [ -f ] [ nodename ]

Establishes the nodename which the Fibre Channel target adapters register in the fabric. This nodename is in the form of a Fibre Channel world wide name, which is in the form XX:XX:XX:XX:XX:XX:XX:XX where X is a hexadecimal digit. The current nodename of the filer can be displayed if the nodename argument is not given.

All FCP adapters must be down before the nodename can be changed. When selecting a new nodename, use the following format to fit with NetApp’s registered names: 50:0a:09:80:8X:XX:XX:XX where XX:XX:XX is some integral value. If the -f flag is given, the format of the nodename does not need to comply with the above format.

fcp portname show [ -v ]

Displays a list of WWPNs used by local Fibre Channel target adapters and names of the corresponding adapters. If the -v flag is given, it also displays valid, but unused, WWPNs for local Fibre Channel target adapters. These WWPNs are marked as unused in the output.

This command only applies to local Fibre Channel target adapters in standby or single_image cfmode. It does not apply to standby adapters in standby cfmode.

fcp portname set adapter wwpn

Assigns a new WWPN to an adapter. You must offline and then online the adpter using the fcp config command before and after changing its WWPN. The WWPN must be one of the valid and unused WWPNs displayed by the fcp portname show -v command. The original WWPN of this adapter is reset to be unused.

This command only applies to local Fibre Channel target adapters in standby or single_image cfmode.

fcp portname swap adapter1 adapter2

Swaps WWPNs of two local Fibre Channel target adapters in standby or single_image cfmode. You must offline and then online adapter1 and adapter2 using the fcp config command before and after changing their WWPNs.

This command only applies to local Fibre Channel target adapters in standby or single_image cfmode.

fcp show adapter [ -v ] [ adapter ]

If no adapter name is given, information about all adapters are shown.

This command displays information such as nodename/portname and link state about the adapter.

If the -v flag is given, this command displays additional information about the the adapters.

fcp show cfmode

This command displays the current cfmode setting.

fcp show initiator [ -v ] [ adapter ]

If no adapter name is given, information about all initiators connected to all adapters are shown.

The command displays the portname of initiators that are currently logged in with the the Fibre Channel target adapters. If the portname is in an initiator group setup through the igroup command, then the group name is also displayed. Similarly, all aliases set with the fcp wwpn-alias command for the portname are displayed as well.

If the -v flag is given, the command displays the Fibre Channel host address and the nodename/portname of the initiators as well.

fcp stats [ -z ] [ adapter ]

If no adapter name is given, information about all initiators connected to all adapters are shown. The -z option zeros all statistics except `Initiators Connected’.

The command displays statistics about the Fibre Channel target adapters and the VTIC partner adapter.

These are the Fibre Channel target adapter statistics.

Read Ops: This counts the number SCSI read ops received by the HBA.

Write Ops: This counts the number SCSI write ops received by the HBA.

Other Ops: This counts the number other SCSI ops received by the HBA.

KBytes In; This counts the KBytes of data received by the HBA.

KBytes Out: This counts the KBytes of data sent by the HBA.

Adapter Resets: This counts the number of adapter resets occurred.

Frame Overruns: This counts the frame overruns detected by the adapter during write requests.

Frame Underruns: This counts the frame underruns detected by the adapter during read requests.

Initiators Connected: This counts the total number of initiators connected to this target adapter.

Link Breaks: Ihis records the number of times that the link breaks.

LIP Resets: This counts the number of times that a selective Reset LIP (Loop Initialization Primitive) occurred. LIP reset is used to preform a verndorspecific reset at the loop port specified by the AL-PA value.

SCSI Requests Dropped: This reports the number of SCSI requests being dropped.

Spurious Interrupts: This reports the spurious interrupt counts.

Total Logins/Total Logouts: This counts the times of initiators added/removed. Each time a new initiator is added, the total logins is incremented by 1. Each time an initiator is removed, the total logouts is incremented by 1.

CRC Errors: This reports the total CRC errors occurred.

Queue Depth: This counts the queue depth on the target HBA.

These are the stats for the VTIC adapter

Read Ops: This counts the number SCSI read ops received from the partner.

Write Ops: This counts the number SCSI write ops received from the partner.

Other Ops: This counts the number other SCSI ops received from the partner.

KBytes In; This counts the KBytes of data received from the partner.

KBytes Out: This counts the KBytes of data sent by the partner.

out_of_vtic_cmdblks,
out_of_vtic_msgs,
out_of_vtic_resp_msgs,
out_of_bulk_msgs, out_of_bulk_buffers, out_of_r2t_buffers: These are counters that track various out of resource errors.

The remaining statistics count the different messages exchanged by the VTIC adapters on filer in a cluster.

fcp stats -i interval [ -c count ] [ -a | adapter ]

Displays statistics about fcp adapters over the given interval. The interval is given in seconds. If no adapter is specified, all adapters, with nonzero statistics, are shown.

The -c option will cause the stats to stop after count intervals.

The -a option will cause all HBAs to be listed, including HBAs with zero statistics. This option can not be used if an adapter is specified.

The statistics are

r/s
The number of SCSI read operations per second.

w/s
The number of SCSI write operations per second.

o/s
The number of other SCSI operations per second.

ki/s
Kilobytes per second receive traffic for the HBA

ko/s
Kilobytes per second send traffic for the HBA.

asvc_t
Average in milliseconds to process a request through the HBA.

qlen
The average number of outstanding requests pending.

hba
The name of the HBA

fcp start

Starts FCP service. When FCP service is started, the adapters brought online.

fcp status

Displays status information about whether FCP service is running or not.

fcp stop

Stops FCP service and offlines the Fibre Channel target adapters.

On clustered systems, fcp stop will shutdown adapters on one head, but the adapters on the partner node are not affected. If any adapter on the partner node is running in partner mode, they can export the local filer’s luns. In order to prevent all access to the luns on one head, all adapters, on both local and partner filer nodes, need to be stopped.

The cf disable does not stop any fcp scsi commands from being sent to the partner filer via the interconnect.

fcp wwpn-alias set [ -f ] alias wwpn

Set an alias for a wwpn (WorldWide PortName). The alias can be no more than 32 characters long and may include A-Z, a-z, 0-9, `_’, ‘-‘, ‘.’, ‘{‘, ‘}’ and no spaces. You may use these aliases in the other fcp and igroup commands that use initiator portnames. Please note that you may set multiple aliases for a wwpn, but only one wwpn per alias. To reset the wwpn associated with with an alias the -f option must be used.

You may set upto 1024 aliases in the system.

fcp wwpn-alias remove { -a alias | -w wwpn }

Removes all alias(es) set for a given wwpn or all alias(es) provided.

fcp wwpn-alias show [ -a alias | -w wwpn ]

Display all aliases and the corresponding wwpn’s if no arguments are supplied. The -a displays the wwpn associated with the alias if set. The -w option displays all aliases associated with the wwpn

CLUSTER CONSIDERATIONS

When the system is not in takeover mode, the adapters running on the local node will be online to monitor the state of the link. These adapters cannot be offlined by the fcp config command, nor can they be displayed with the fcp show commands. The nodename/portname they register with a fabric are different from the filer’s nodename/portname. The mediatype and partner configurations under the fcp config command can be set on these adapters.

Once takeover occurs, these adapters will initialize with the partner node’s nodename/portname and can be managed through the partner command.

The fcp show cfmode command only applies to clustered filers.

SEE ALSO

igroup , iscsi , lun , san , sysconfig , uptime


Table of Contents

Copyright © 1994-2008 NetApp, Inc. Legal Information

7-mode Manual Pages , , , ,

  1. No comments yet.
  1. No trackbacks yet.



This site is not affiliated or sponsored in anyway by NetApp or any other company mentioned within.
%d bloggers like this: