logo

Manual Pages


Table of Contents

NAME

na_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 | 8 | 10 | 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 and -partner options are only applicable to clustered filers running the `standby', and `mixed' cfmodes. For all other cfmodes these options have no effect.

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 it's default adapter, which is dependant on the slot and port of the adapter.

In the `standby' cfmode, local ports are the `a', `c', `e', `g' etc ports, while the standby ports are `b', `d', `f', `h', etc. The default behavior is that a standby port will takover the partner's WWPN/WWNN from the previous port. For example controller A 0d will takeover from controller B's 0c port, and controller A's 4b will takeover for controller B's 4a.

In the `mixed' cfmode, each physical port has 3 virtual ports, and the default behavior is to takeover for the filer's virtual standby port (named above as the Xy_1 port) will takeover the partner's local port (named above as Xy_0). For example 0c_1 will takeover 0c_0, and 4b_1 will takeover 4b_0.

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 Fibre Channel link speed of an adapter. Adapters that support 8Gb/s can be set to 2, 4, 8 or auto. 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. Adapters that support 10Gb/s can be set to 10 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 [ -f ] adapter wwpn

Assigns a new WWPN to an adapter. The -f flag may be used to override the warning message about changing the WWPN. You must offline and then online the adapter 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 [ -f ] swap adapter1 adapter2

Swaps WWPNs of two local Fibre Channel target adapters in standby or single_image cfmode. The -f flag may be used to override the warning message about changing the WWPNs. 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 vendorspecific 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.

Adapter Qfulls: This reports the number of SCSI queue full responses that were sent.

Protocol Errors: This reports the number of protocol errors that have occurred.

Invalid Transmit Words: This reports the number of invalid trasmit words.

LR Sent: This reports the number of link resets sent.

LR Received: This reports the number of link resets received.

Discarded Frames: This reports the number of received frames that were discarded.

NOS Received: This reports the number of NOS (Not Operational Sequence) primitives received.

OLS Received: This reports the number of OLS (Offline Sequence) primitives received.

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

These are stats for the SFP/SFF module on the adapter.

Vendor Name: This reports the name of the vendor.

Vendor OUI: This reports the vendor IEEE Organizationally Unique Identifier.

Vendor PN: This reports the vendor product number.

Vendor Rev: This reports the vendor revision.

Serial No: This reports the serial number.

Date Code: This reports the manufacturing date code.

Media Form: This reports the media form factor.

Connector: This reports the connector type.

Wavelength: This reports the wavelength.

Encoding: This reports the encoding scheme used.

FC Speed Capabilities: This reports the speeds supported.

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

na_igroup(1), na_iscsi(1), na_lun(1), na_san(1), na_sysconfig(1), na_uptime(1)


Table of Contents