Manual Pages
Table of Contents
na_fcp - Commands for managing Fibre Channel target
adapters and the FCP target protocol.
fcp command argument ...
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.
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
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.
na_igroup(1), na_iscsi(1), na_lun(1), na_san(1),
na_sysconfig(1), na_uptime(1)
Table of Contents