lscontroller
Use the lscontroller command to display a concise list or a detailed view of controllers that are visible to the clustered system (system).
Syntax
>>- lscontroller -- --+-----------------------------------+-----> '- -filtervalue -- attribute=value -' >-- --+----------+-- --+-----------------------+-- -- ----------> '- -nohdr -' '- -delim -- delimiter -' >--+-----------------+--+-------------------+------------------>< '- -filtervalue? -' +- controller_id ---+ '- controller_name -'
Parameters
- -filtervalue attribute=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 Storwize® V3700 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.
- -delim delimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum possible 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 one-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 matching 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.
degraded no, yes
To differentiate the name of a storage controller from the name 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 lscontroller controller 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 it provides to verify the actual controller that has the WWNN.
- The mdisk_link_count value is the number of MDisks currently associated with this storage controller.
- The max_mdisk_link_count value is the highest value that the mdisk_link_count has reached 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.
- 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.
- The storage controller max_path_count value is the highest value that the storage controller path_count has reached 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 has reached 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.
- The allow_quorum value identifies if the controller is currently enabled to support quorum disks. Quorum support is either enabled or disabled depending on the controller hardware type.
- The ctrl_s/n value is the controller serial number. Important: This data comes from vendor-controlled sources and might not be available.
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 if 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 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 is an alphanumeric value or is blank. |
fabric_type | Indicates a Fibre Channel (FC) or SAS 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 associated with the iscsi_port_id. This shows the IP value for the iSCSI controller and is blank for other controllers. This must be an IPv4 or IPv6 address. |
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=
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