lscontroller

Use the lscontroller command to display a concise list or a detailed view of controllers that are visible to the system.

Syntax

lscontroller [ -filtervalueattribute=value ] [ -nohdr ] [ -delimdelimiter ] [ -filtervalue? ] [ { controller_id | controller_name } ]

Parameters

-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard, which must be the first or last character in the string.
-filtervalue?
(Optional) Displays the valid filter attributes. The following filter attributes for the lscontroller command are valid:
  • controller_name
  • id
-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delimdelimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
controller_id | controller_name
(Optional) Specifies the name or ID of a controller. When you use this parameter, the detailed view of the specific controller is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the controller_id | controller_name parameter, the concise view displays all controllers that match the filtering requirements that are specified by the -filtervalue parameter.

Description

This command returns a concise list, or a detailed view, of controllers visible to the system.

The following values are applicable to the data in the output views:
degraded no, yes

To differentiate the name of a storage controller from the name that is shown on the system, list the storage controllers by issuing the lscontroller command. Record the controller name or ID for the controller that you want to determine. For the controller in question, issue the lscontrollercontroller name | id command, where controller name | id is the controller name or ID. Record the worldwide node name (WWNN) for the controller. You can use the WWNN to determine the actual storage controller by launching the native controller user interface, or by using the command line tools that it provides to verify the actual controller that has the WWNN.

Notes:
  1. The mdisk_link_count value is the number of MDisks currently associated with this storage controller.
  2. The max_mdisk_link_count value is the highest value that the mdisk_link_count reaches since it was last reset to the mdisk_link_count value.
    Remember: This value is reset by specific maintenance procedures or when the event log is cleared.
  3. A SAN connection from a node or node canister port to a controller port for a single MDisk is a path. The controller port path_count value is the number of paths that are currently being used to submit input/output (I/O) data to this controller port.
  4. The storage controller max_path_count value is the highest value that the storage controller path_count reaches since it was last reset to the path_count value. This value is reset by specific maintenance procedures or when the system error log is cleared.
    Important: The max_path_count value is the highest value that the path_count reaches since it was last reset to the path_count value.
    Remember: This value is reset by specific maintenance procedures or when the event log is cleared.
  5. The allow_quorum value identifies if the controller is enabled to support quorum disks. Quorum support is either enabled or disabled depending on the controller hardware type.
  6. The ctrl_s/n value is the controller serial number.
    Important: This data comes from vendor-controlled sources and might not be available.
lscontroller output provides the attribute values that can be displayed as output view data.
This table provides the attribute values that can be displayed as output view data.
Table 1. lscontroller output
Attribute Possible Values
id Indicates the controller ID.
name Indicates the controller name.
WWNN Indicates the worldwide node name (WWNN). This field is blank for iSCSI controllers.
mdisk_link_count Indicates the MDisk link count.
max_mdisk_link_count Indicates the maximum MDisk link count.
degraded Indicates whether the controller has degraded MDisks.
vendor_id Indicates the vendor identification name or number.
product_id_low Indicates the product identification.
product_id_high Indicates the product identification.
product_revision Indicates the product revision.
ctrl_s/n Indicates the controller serial number.
allow_quorum Indicates that the controller can support quorum disks.
WWPN Indicates the worldwide port name (WWPN). This field is blank for iSCSI controllers.
path_count Indicates the number of paths that are currently being used to submit input/output (I/O) data to the controller port.
max_path_count Indicates the maximum number of paths that are currently being used to submit input/output (I/O) data to the controller port.
site_id Indicates the site value for the controller. This numeric value is 1, 2, 3, or blank.
site_name Indicates the site name for the controller. This value is an alphanumeric value or is blank.
fabric_type Indicates a Fibre Channel (FC) or SAS controller.
  • fc indicates an FC controller
  • sas_direct indicates an SAS direct-attached controller
  • multiple indicates multiple controllers (either FC, SAS, or both)
  • iscsi indicates an iSCSI controller
iscsi_port_id Indicates the I/O port identifier, which is the same as the WWPN value from the FC domain. This value shows the iSCSI port ID for the iSCSI controller and is blank for other controllers. This value must be a numeric value.

This ID refers to the row number in output from the lsiscsistorageport command. The lsiscsistorageport can be used to find the controller IQN.

ip Indicates the IP address that is associated with the iscsi_port_id. This value shows the IP value for the iSCSI controller and is blank for other controllers. This value must be an IPv4 or IPv6 address.
physical_capacity Indicates the physical capacity of the controller. This value is always blank or empty for controllers that do not report physical capacity information.

A concise invocation example for an iSCSI controller

lscontroller -delim :

The concise resulting output:

id:controller_name:ctrl_s/n:vendor_id:product_id_low:product_id_high:WWNN:degraded:fabric_type:site_id:site_name
0:controller0::IBM:1726-4xx:FAStT::no:iscsi:1:snpp1
1:controller1::IBM:1726-4xx:FAStT::no:iscsi:2:snpp2
7:controller7:3EK0J5Y8:SEAGATE :ST373405:FC:200600A0B851061E:yes:fc:1:snpp1
8:controller8:3EK0J6CR:SEAGATE :ST373405:FC:200600A0B851061D:no:fc:2:snpp2
9:controller9:3EK0J4YN:SEAGATE :ST373405:FC:200600A0B851061C:no:fc:3:snpp3
10:controller10:3EK0GKGH:SEAGATE :ST373405:FC:200600A0B851061B:no:fc:1:snpp4
11:controller11:3EK0J85C:SEAGATE :ST373405:FC:200600A0B851061A:no:fc:2:snpp5
12:controller12:3EK0JBR2:SEAGATE :ST373405:FC:200600A0B851062A:no:fc:3:snpp6
13:controller13:3EKYNJF8:SEAGATE :ST373405:FC:200600A0B851062B:no:fc:1:snpp7
14:controller14:3EK0HVTM:SEAGATE :ST373405:FC:200600A0B851062C:no:fc:2:snpp8 

A detailed invocation example for a Fibre Channel controller

lscontroller -delim = 7

The detailed resulting output:

id=7
controller_name=controller7
WWNN=20000004CF2412AC
mdisk_link_count=1
max_mdisk_link_count=1
degraded=no
vendor_id=SEAGATE 
product_id_low=ST373405
product_id_high=FC      
product_revision=0003
ctrl_s/n=3EK0J5Y8
allow_quorum=no

WWPN=22000004CF2412AC
path_count=1
max_path_count=1
WWPN=21000004CF2412AC
path_count=0
max_path_count=0
fabric_type=sas_direct
iscsi_port_id=
ip=physical_capacity=20.0GB

A detailed invocation example for an iSCSI controller

lscontroller 0

The detailed resulting output:

id 0
controller_name controller0
WWNN 
mdisk_link_count 4
max_mdisk_link_count 4
degraded no
vendor_id IBM
product_id_low 1726-4xx
product_id_high   FAStT
product_revision 0617
ctrl_s/n
allow_quorum no
fabric_type iscsi
site_id
site_name
WWPN
path_count 4
max_path_count 4
iscsi_port_id 1
ip 10.10.10.1
WWPN
path_count 4
max_path_count 4
iscsi_port_id 2
ip 10.10.10.2
physical_capacity 40.0GB