The commonly used commands for adding, removing, and displaying FC devices are as follows:
fcinfo – Collects and displays administrative information about FC-HBA ports on hosts, remote ports, and configured logical units. For more information, see the fcinfo(8) man page. The following examples show the most common administration operations that can be performed by using the fcinfo command:
Example 2 Display Information of the HBA Ports and Their Link StatisticsTo list information of the HBA ports and their link statistics use the fcinfo hba-port -l command.
# fcinfo hba-port -l
HBA Port WWN: 2100000e1ec95100
Port Mode: Initiator
Port ID: 150300
OS Device Name: /dev/cfg/c6
Manufacturer: QLogic Corp.
Model: 7023303
Firmware Version: 8.05.00
FCode/BIOS Version: BIOS: 3.19; fcode: 4.02; EFI: 5.36;
Serial Number: 463916R+1606293054
Driver Name: qlc
Driver Version: 161214-5.06a
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1ec95100
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Max NPIV Ports: 253
NPIV port list:
HBA Port WWN: 2100000e1ec95101
Port Mode: Initiator
Port ID: 20801
OS Device Name: /dev/cfg/c7
Manufacturer: QLogic Corp.
Model: 7023303
Firmware Version: 8.05.00
FCode/BIOS Version: BIOS: 3.19; fcode: 4.02; EFI: 5.36;
Serial Number: 463916R+1606293054
Driver Name: qlc
Driver Version: 161214-5.06a
Type: NL-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1ec95101
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 37825
Invalid CRC Count: 0
Max NPIV Ports: 253
NPIV port list:
Example 3 Display All The Remote Ports on All the HBAs
To list all the remote ports on all the HBAs, use the fcinfo remote-port command.
# fcinfo remote-port
HBA Port WWN: 2100000e1ec95100
Count of Remote Port(s): 4
Remote Port WWN: 10000000c97ecedc
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 150400
Port Symbolic Name:
Node WWN: 20000000c97ecedc
Remote Port WWN: 21000024ff41d9a4
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 150200
Port Symbolic Name: qlc(0,0)
Node WWN: 20000024ff41d9a4
Remote Port WWN: 201600a0b82a38bc
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 150700
Port Symbolic Name: SUN CSM200_R 0660
Node WWN: 200600a0b82a38bc
Remote Port WWN: 21000024ff51bb4a
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 150100
Port Symbolic Name: qlt0,0
Node WWN: 20000024ff51bb4a
HBA Port WWN: 2100000e1ec95101
Count of Remote Port(s): 11
Remote Port WWN: 10000000c9c07a6d
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20b00
Port Symbolic Name:
Node WWN: 20000000c9c07a6d
Remote Port WWN: 21000024ff2cd75a
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20200
Port Symbolic Name:
Node WWN: 20000024ff2cd75a
Remote Port WWN: 202200a0b85a8c82
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 20400
Port Symbolic Name: SUN LCSM100_F 0735
Node WWN: 200200a0b85a8c82
Remote Port WWN: 21000024ff2cd75b
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20300
Port Symbolic Name:
Node WWN: 20000024ff2cd75b
Remote Port WWN: 10000000c97ecedd
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20900
Port Symbolic Name:
Node WWN: 20000000c97ecedd
Remote Port WWN: 202300a0b85a8c82
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 20600
Port Symbolic Name: SUN LCSM100_F 0735
Node WWN: 200200a0b85a8c82
Remote Port WWN: 203200a0b85a8c82
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 20700
Port Symbolic Name: SUN LCSM100_F 0735
Node WWN: 200200a0b85a8c82
Remote Port WWN: 2100001b321a45e5
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20100
Port Symbolic Name:
Node WWN: 2000001b321a45e5
Remote Port WWN: 203300a0b85a8c82
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 20500
Port Symbolic Name: SUN LCSM100_F 0735
Node WWN: 200200a0b85a8c82
Remote Port WWN: 2101001b323a45e5
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20000
Port Symbolic Name:
Node WWN: 2001001b323a45e5
Remote Port WWN: 10000000c9c07a6c
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 20a00
Port Symbolic Name:
Node WWN: 20000000c9c07a6c
Example 4 Display All the Remote Ports Visible Through a Local HBA Port
and Their Link Statistics
To list all the remote ports visible through a local HBA port and their link statistics, use the fcinfo remote-port -ls -p PWWN command.
# fcinfo remote-port -ls -p 2100000e1ec95100
HBA Port WWN: 2100000e1ec95100
Count of Remote Port(s): 4
Remote Port WWN: 10000000c97ecedc
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 150400
Port Symbolic Name:
Node WWN: 20000000c97ecedc
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 6
Loss of Signal Count: 2
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 33
Invalid CRC Count: 0
Remote Port WWN: 21000024ff41d9a4
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 150200
Port Symbolic Name: qlc(0,0)
Node WWN: 20000024ff41d9a4
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 4
Invalid CRC Count: 0
Remote Port WWN: 201600a0b82a38bc
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 150700
Port Symbolic Name: SUN CSM200_R 0660
Node WWN: 200600a0b82a38bc
Link Error Statistics:
Link Failure Count: 12
Loss of Sync Count: 1024
Loss of Signal Count: 20842
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 21000024ff51bb4a
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 150100
Port Symbolic Name: qlt0,0
Node WWN: 20000024ff51bb4a
Link Error Statistics:
Link Failure Count: 1
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: COMSTAR
OS Device Name: Unknown
Example 5 Display All the Logical Units and Its Information
To list all the logical units and its information, use the fcinfo lu -v command.
OS Device Name: /dev/rmt/3n
HBA Port WWN: 2100000e1ec95101
Controller: /dev/cfg/c7
Remote Port WWN: 500104f000ad3d19
LUN: 0
State: unknown
Class:
Vendor: SUN
Product: EXAMPLE-TD7
Device Type: Tape Device
Unformatted capacity: 0.000 MBytes
OS Device Name: /dev/rmt/5n
HBA Port WWN: 2100000e1ec95101
Controller: /dev/cfg/c7
Remote Port WWN: 500104f000ad3d0e
LUN: 0
State: unknown
Class:
Vendor: SUN
Product: EXAMPLE-TD5
Device Type: Tape Device
Unformatted capacity: 0.000 MBytes
Example 6 Display All the Logical Units on a Remote Port
To list all the logical units on a remote port, use the fcinfo lu -v -P PWWN command.
# fcinfo lu -v -P 500104f000ad3d19
OS Device Name: /dev/rmt/0n
HBA Port WWN: 2100000e1ec95101
Controller: /dev/cfg/c7
Remote Port WWN: 500104f000ad3cfe
LUN: 0
State: unknown
Class:
Vendor: STK.EXAMPLE
Product: T10000A
Device Type: Tape Device
Unformatted capacity: 0.000 MBytes
cfgadm – Dynamically reconfigures storage devices and FC devices. This command is used most frequently to configure storage devices on a SAN. This command also provides configuration administration operations on dynamically reconfigurable hardware resources. For more information, see the cfgadm(8) man page. The following examples shows the different administration operations that can be performed by using the cfgadm command:
Example 7 Display All the Attachment PointsThe cfgadm command lists all attachment points except dynamic attachment points.
# cfgadm Ap_Id Type Receptacle Occupant Condition c1 scsi-sas connected configured unknown c2 scsi-sas connected configured unknown c3 scsi-sas connected configured unknown c4 scsi-sas connected configured unknown c5 scsi-sas connected configured unknown c6 fc-fabric connected unconfigured unknown c7 fc-public connected unconfigured unknown c8 scsi-sas connected configured unknown c9 scsi-sas connected configured unknown hca:10E00001430070 IB-HCA connected configured ok ib IB-Fabric connected configured ok usb0/1 unknown empty unconfigured ok usb0/2 unknown empty unconfigured okExample 8 Display the Current Configurable Hardware Information
To list the current configurable hardware information, including those represented by dynamic attachment points, use the cfgadm -al command.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c1 scsi-sas connected configured unknown c1::dsk/c1t0d0 CD-ROM connected configured unknown c2 scsi-sas connected configured unknown c2::w5000cca0162922a1,0 disk-path connected configured unknown c3 scsi-sas connected configured unknown c3::w5000cca0162b81b5,0 disk-path connected configured unknown c4 scsi-sas connected configured unknown c4::w5000cca0162b899d,0 disk-path connected configured unknown c5 scsi-sas connected configured unknown c5::w5000cca0162a6bcd,0 disk-path connected configured unknown c6 fc-fabric connected unconfigured unknown c6::10000000c97ecedc unknown connected unconfigured unknown c6::201600a0b82a38bc disk connected unconfigured unknown c6::21000024ff41d9a4 unknown connected unconfigured unknown c6::21000024ff51bb4a unknown connected unconfigured unknown c7 fc-public connected unconfigured unknown c7::10000000c97ecedd unknown connected unconfigured unknown c7::10000000c9c07a6c unknown connected unconfigured unknownExample 9 Display the Status of the LUN
To know the status of the LUN, use the cfgadm -al -o show_SCSI_LUN command. For example:
# cfgadm -al -o show_SCSI_LUN Ap_Id Type Receptacle Occupant Condition c6 fc-fabric connected configured unknown c6::10000000c97ecedc unknown connected configured unknown c6::201600a0b82a38bc disk connected unconfigured unknown c6::21000024ff41d9a4 unknown connected unconfigured unknown c6::21000024ff51bb4a unknown connected unconfigured unknown c7 fc-public connected unconfigured unknown c7::10000000c97ecedd unknown connected unconfigured unknown c7::10000000c9c07a6c unknown connected configured unknown c7::10000000c9c07a6d unknown connected unconfigured unknown c7::202200a0b85a8c82 disk connected unconfigured unknown c7::202300a0b85a8c82 disk connected unconfigured unknown c7::203200a0b85a8c82 disk connected unconfigured unknown c7::203300a0b85a8c82 disk connected unconfigured unknown c7::2100001b321a45e5 unknown connected unconfigured unknown c7::21000024ff2cd75a unknown connected unconfigured unknown c7::21000024ff2cd75b unknown connected configured unknown c7::2101001b323a45e5 unknown connected unconfigured unknown
fcadm – Performs administrative operations on FC HBA ports on a host. This command can reinitialize the ports, and also create and delete NPIV and FCoE ports. For more information, see Configuring IPFC SAN Devices, Configuring FCoE Ports and the fcadm(8) man page.
format – Identifies devices that are connected to the system, and provides the ability to label disk devices. For more information, see the format(8) man page.