lscontroller

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

Syntax

Parameters

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.
-filtervalue attribute=value: (Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?: (Optional) Displays a list of valid filter attributes.

controller_id | controller_name: (Optional) Specifies the name or ID of a controller.

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 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 that it provides to verify the actual controller that has the WWNN.

Notes:

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 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.
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 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.
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.
The ctrl_s/n value is the controller serial number.
Important: This data comes from vendor-controlled sources and might not be available.

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_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.
direct_attach_enhanced	Indicates whether the direct attach enhancement feature is enabled. The value can be yes or no. Note: This field is only displayed in the lscontroller detailed view.