The lscontroller command returns a concise list, or a detailed view, of controllers that are visible to the cluster.
The list report style can be used to obtain two styles of
report:
- A list containing concise information about controllers. (Each entry in the list corresponds to a single controller.)
- The detailed information about a single, user-specified controller.
Syntax
>>- svcinfo -- -- lscontroller -- ------------------------------> >--+--------------------------------+-- --+----------+-- -------> '- -filtervalue -- attrib=value -' '- -nohdr -' >--+-----------------------+-- -- --+-----------------+---------> '- -delim -- delimiter -' '- -filtervalue? -' >--+-------------------+--------------------------------------->< +- controller_id ---+ '- controller_name -'
Parameters
- -filtervalue attrib=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 SAN Volume Controller 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.
- When using a wildcard, enclose the filter entry within double
quotation marks (""), as follows:
svcinfo lscontroller -filtervalue "name=md*"
- -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.
- -filtervalue?
- (Optional) Displays the valid filter attributes. The following
filter attributes for the svcinfo lscontroller command
are valid:
- controller_id
- id
- 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 cluster.
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 shown on the cluster, list the storage controllers by issuing the svcinfo lscontroller command. Record the controller name or ID for the controller that you want to determine. For the controller in question, issue the svcinfo 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.
Notes:
- The mdisk_link_count value is the number of Mdisks currently using this controller as their active 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. This value is reset by specific maintenance procedures and when the cluster error log is cleared.
- The controller path_count value is the sum of the MDisk path_count values for MDisks currently using this controller port as their active controller port.
- The controller max_path_count value is the highest value that the controller path_count has reached since it was last reset to the path_count value. This value is reset by specific maintenance procedures and when the cluster error log is cleared.
- The allow_quorum value shows whether the controller is currently enabled to support quorum disks. Quorum support is either enabled or disabled depending on the controller hardware type.
A concise invocation example
svcinfo lscontroller -delim :
The concise resulting output
id:controller_name:ctrl_s/n:vendor_id:product_id_low:product_id_high 7:controller7:3EK0J5Y8:SEAGATE :ST373405:FC 8:controller8:3EK0J6CR:SEAGATE :ST373405:FC 9:controller9:3EK0J4YN:SEAGATE :ST373405:FC 10:controller10:3EK0GKGH:SEAGATE :ST373405:FC 11:controller11:3EK0J85C:SEAGATE :ST373405:FC 12:controller12:3EK0JBR2:SEAGATE :ST373405:FC 13:controller13:3EKYNJF8:SEAGATE :ST373405:FC 14:controller14:3EK0HVTM:SEAGATE :ST373405:FC
A detailed invocation example
svcinfo 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