Targeted configuration of FC and FCoE devices

Edit online

The cfgmgr -c option is used with Fibre Channel (FC) and Fibre Channel over Ethernet (FCoE) adapters for targeted configuration.

The cfgmgr command can be used with the -c flag as a connection option for a limited scope of device configuration. For FC and FCoE adapters, the syntax is as follows:

cfgmgr -l fscsi0 -c "parameter=val[,parameter=val,...]"
By using the connection filter string, you can limit the scope of device discovery by using one or more of the following parameters:
Table 1. Parameters for the cfgmgr -c flag
Parameter name Description
ww_name Target device world wide port name
node_name Target device world wide node name
scsi_id Target device N_Port ID that maps to the Small Computer System Interface (SCSI) ID for Fibre Channel Protocol (FCP) storage devices
lun_id Logical unit number (LUN)
For example, the following command configures a single LUN of lun_id 0x1000000000000 at the storage target port that has the world wide port name 0x5001738000330191:
# cfgmgr -l fscsi0 -c "ww_name=0x5001738000330191,lun_id=0x1000000000000"
This scan occurs only for the fscsi0 host adapter port.
Notes:
  • The leading characters 0x in the parameter value are optional.
  • All of the parameters must be represented as a hexadecimal number.

In the following example, only one parameter is specified:

# cfgmgr -l fscsi0 -c "lun_id=0x1000000000000"

This command scans all of the storage device ports on the storage area network (SAN) and configures this single logical unit for every SAN target port where this LUN exists.

Guidelines and rules for connection filter parameters

Consider the following points when you use the connection filter parameters:

  • Targeted configuration for FC and FCoE devices applies to switch-attach environments only. If you specify a connection string that is directly attached to a target port, the connection fails with a message indicating that the child devices cannot be found.
  • The -c flag is supported only when accompanied by the -l flag of the cfgmgr command that limits the scope of the command to a single fscsiX device at a time.
  • If you specify -? as the connection string for the -c flag of the cfgmgr command, along with -v flag, the usage information is displayed.
  • If you specify duplicate parameters (for example, lun_id listed twice), it results an error. No devices are detected.
  • Any combination of lun_id, scsi_id, ww_name, and node_name parameters are allowed, except for duplicates. To uniquely identify a LUN, target, or storage node to be configured, you must specify one or preferably two parameters, although more are allowed. The following list specifies the parameter or combination of parameters that is required to uniquely identify a LUN, target, or storage node:
    • The ww_name and lun_id parameters uniquely identify a LUN on a target port to be configured.
    • The scsi_id and lun_id parameters uniquely identify a LUN on a target port to be configured.
    • The node_name and lun_id parameters configure a LUN for all target ports for a specific storage node. These parameters can configure the target ports only if all the target ports have the same node_name parameter, which might be true for some storage devices.
    • The ww_name parameter configures all LUNs for a specific target.
    • The node_name parameter configures all target ports for a specific storage node (only if all target ports have the same node_name parameter, which might be true for some storage devices).
    • The lun_id parameter configures a LUN on all target ports that are visible from that fscsi device.
  • If more than two parameters are specified, the device configuration code uses this extra information to validate the device location. If any of the specified parameter values are in conflict with the reported values on the SAN, the command fails and no devices are configured.