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, bring target adapter ports up and down, show protocol statistics, and list client adapters connected to the controller.

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 ] [ mediatype { ptp auto | loop } ] [ speed { 1 | 2 | 4 | 8 | 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 where X is an integer and y is a letter (for example 4a).

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 taken offline. They cannot be made online again until FCP service is started by the fcp start command.

The mediatype option can be used to set the link topology. You can set the link topology to ptp for point-to-point, loop for arbitrated loop, or auto for auto negotiation. The default is auto negotiation.

The speed option is used to set the Fibre Channel link speed of an adapter. Adapters that support 8Gbps can be set to 2, 4, 8 or auto. Adapters that support 4Gbps can be set to 1, 2, 4 or auto. Adapters that support 2Gbps can be set to 1, 2 or auto. Adapters that support 10Gbps 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 nameserver [ -v ] [ -u ] show [ adapter ]

Displays entries in the zoned fabric nameserver database. If no adapter is specified, nameserver entries for all adapters are shown. The nameserver database contains entries for all devices registered into the fabric. The -v option displays verbose output of the nameserver including the symbolic names of the registered devices. The -u option can be used to display entries from the unzoned fabric nameserver database. The use of -v and -u is optional.

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 controller can be displayed if the nodename argument is not given.

The FCP service must be stopped 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 ping [ -s ] [ -v ] [ -p payload ] adapter address

Sends an ECHO ELS frame from the Fibre Channel target adapter to the specified address location. The address is a Fibre Channel port identifier 0xXXXXXX where X is a hexadecimal value or a Fibre Channel world wide port name of the form XX:XX:XX:XX:XX:XX:XX:XX where X is a hexadecimal value. If payload is specified, that string will be included in the payload of the ECHO frame. The payload string can have a maximum of 255 characters. If the payload string includes white space characters, the entire string should be wrapped in quotes. When the -s flag is specified, fcp ping sends one ELS ECHO frame per second and prints one line of output for every response it receives and computes the round-trip time and frame loss statistics. When the command is terminated with a ^C, the summary statistics is displayed. If no payload is specified, a default payload will be sent. For a port speed of 2, 4 or 8 Gbps, the default frame size will be 50 bytes. For a port supporting 10 or 16 Gbps the default payload is 248 bytes. The default payload will a carry special pattern to verify the signal integrity of the Fibre Channel connection. If the -v flag is specified, additional round-trip statistics will be printed in the summary statistics output. The -v flag is ignored without the -s flag.

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.

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.

fcp portname [ -f ] swap adapter1 adapter2

Swaps WWPNs of two local Fibre Channel target adapters. 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.

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 adapters.

fcp show cfmode

This command displays the current cfmode setting. This command has been deprecated.

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 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: This records the number of times 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 perform a vendor specific 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 transmit 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 controller's VTIC adapters in an HA pair.

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 are brought online.

fcp status

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

fcp stop

Stops FCP service and takes the Fibre Channel target adapters offline.

On HA systems, fcp stop will shut down adapters on one controller, but the adapters on the partner controller are not affected. In order to prevent all access to the LUNs on one controller, all local and partner adapters need to be stopped.

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

fcp topology [ -v | -z ] show [ adapter ]

Displays fabric topology information. If no adapter is specified, topology information for all adapters are shown. The topology information lists the switches in the fabric. The option -v lists verbose output which would include all ports in the fabric. Ports that are visible to the Fibre Channel target adapter from a fabric zoning perspective are marked with an asterisk. The option -z lists only ports that are in the same zone as the Fibre Channel target adapter specified.

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 an alias the -f option must be used.

You may set up to 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 option displays the wwpn associated with the alias if set. The -w option displays all aliases associated with the wwpn

fcp zone show [ adapter ]

Displays the active zone set in the fabric. If no adapter is specified, zoning information for all adapters are shown. The zoning information contains a list of all defined zones and their zone members. Some values indicated with a dash are not currently reportable. For example, if the zone contains a physical port interface, its existence is noted as a Member Interface. However, the port interface value is not retrievable.

HA CONSIDERATIONS

The fcp show cfmode command only applies to HA configured controllers.

SEE ALSO

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


Table of Contents