fcmsutil.1m (2011 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

fcmsutil(1M) fcmsutil(1M)

NAME

fcmsutil - Fibre Channel Mass Storage Utility Command for Fibre Channel Host Bus Adapters

SYNOPSIS

/opt/fcms/bin/fcmsutil

device_ﬁle [options ]

The device_ﬁle speciﬁes the Fibre Channel device special ﬁle associated with the Fibre Channel

HBA port.

The device ﬁle has the format

/dev

/FC_driverX, where X is the instance number of the Fibre

Channel HBA port, as reported by the

ioscan

output.

The [options ] that follow the device ﬁle are the ones listed in the

fcmsutil display usage for

each type of Fibre Channel driver. The usage of

fcmsutil can be seen by running the com-

mand alone. Options listed under the

fcmsutil usage for different HBAs are supported for that

HBA.

In case an invalid device ﬁle is speciﬁed, that is, if the device ﬁle does not belong to the fc class,

the

fcmsutil command will return an error and display the usage options of

fcmsutil.

Note: For all options that take remote-N-Port-ID as an argument, remote-N-Port-ID can be

replaced with

-l loop_id (in Private Loop), or

-w wwn.

SECURITY RESTRICTIONS

The usage of

fcmsutil command is restricted to processes having super user privileges. Some of the

options require detailed knowledge of the device speciﬁc adapter. See privileges (5) for more information

about privileged access on systems that support ﬁne-grained privileges.

DESCRIPTION

For a list of all supported Fibre Channel HBAs, please refer to the HP-UX Fibre Channel Driver Release

Notes for your hardware product.

The fcmsutil command is a common diagnostic tool used for all Fibre Channel Host Bus Adapters sup-

ported on HP-UX. This command provides the ability to perform Fibre Channel Test and Echo func-

tionality, read the card’s registers, and so on. This command requires the use of a device ﬁle to indicate

the interface over which the requested command needs to be performed.

Options

fcmsutil options are described below. Some options are HBA-speciﬁc and, therefore, are not supported

by all Fibre Channel HBAs.

The list of options supported by each HBA may be obtained by running

fcmsutil without specifying

any arguments.

All keywords are case-insensitive and are position dependent.

device_file Can be used alone or with other options.

When used without any options it provides information such as the N_Port ID, Node

World Wide Name and Port World Wide Name of the HBA and the switch (when applica-

ble), Topology, the negotiated Link Speed, Vendor ID, Device ID, the Driver State,

Hardware Path, Maximum Frame Size, and Driver Version.

As per the FC protocol, Node WWN will be numerically one more than the Port WWN.

The following topologies are deﬁned:

UNINITIALIZED.

There is no connectivity to the host bus adapter port or the topology could not be

determined.

UNKNOWN.

The Fibre Channel driver has returned a topology code that the utility does not

understand.

PRIVATE_LOOP.

The host bus adapter is attached to a loop/loopback hood.

PUBLIC_LOOP.

The host adapter is attached to a loop connected to a Fibre Channel switch.

HP-UX 11i Version 3: March 2011 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
fcmsutil(1M) fcmsutil(1M) NAME fcmsutil - Fibre Channel Mass Storage Utility Command for Fibre Channel Host Bus Adapters SYNOPSIS /opt/fcms/bin/fcmsutil device_file [options ] The device_file specifies the Fibre Channel device special file associated with the Fibre Channel HBA port. The device file has the format /dev/FC_driverX, where X is the instance number of the Fibre Channel HBA port, as reported by the ioscan output.
PAGE 2
fcmsutil(1M) fcmsutil(1M) IN_PTTOPT_NPORT/PTTOPT_NPORT. The host bus adapter has come up in a point to point topology. This topology can be an error if the card was expected to come up in loop topology. Not legal in most cases. PTTOPT_FABRIC. The host bus adapter has come up in a point to point topology when connected through a Fibre Channel switch. This topology can be an error if the card was expected to come up in loop topology. The following driver states are defined: LOOPBACK_STATE.
PAGE 3
fcmsutil(1M) fcmsutil(1M) rls remote-N-Port-ID This option is used to send an RLS (Request Link Status) ELS frame on the wire. It requires one parameter, the remote-N-Port-ID. The ELS is sent to this remote-N-Port-ID and the response data is displayed. test remote-N-Port-ID data_size [count ] This option is used to send a TEST ELS on the wire. It requires two parameters, the remote-N-Port-ID and data-size (size of packet to send).
PAGE 4
fcmsutil(1M) fcmsutil(1M) An optional third argument (count ) can be specified for the number of loopback packets to be sent. If the count option is not specified, one packet will be sent. get local get fabric get remote {all|remote-N-Port-ID} This option is used to obtain Fibre Channel login parameters of either the local port, the fabric port, or a remote port. The Fibre Channel HBAs do not support the local option.
PAGE 5
fcmsutil(1M) fcmsutil(1M) the LUN Worldwide Identifier (WWID). Instead of the fcmsutil replace_dsk command, use the scsimgr commands, replace_wwid and replace_leg_dsf, to validate the replacement of devices. See the scsimgr (1M) manpage for more information. [-f] disable This option is used to disable the card. WARNING: This is a DESTRUCTIVE test and communication to all nodes will be terminated. The -f option can be used to suppress the warning message displayed by the Fibre Channel driver utility.
PAGE 6
fcmsutil(1M) fcmsutil(1M) This option requires the name of a binary image file that contains the EFI driver. This operation should only be performed by qualified personnel. Failure to successfully complete the EFI driver update may result in adapter and/or system boot up failure if the boot disks are accessed through this card. [-f] set_int_delay This option is used to set the interrupt delay mode and value, or to turn off interrupt delay. Settings made using this option are not persistent across reboots.
PAGE 7
fcmsutil(1M) fcmsutil(1M) AUTHOR /opt/fcms/bin/fcmsutil was developed by HP.
PAGE 8
(Notes) A (Notes) fA 8 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2011