controller ‑list

Returns status and configuration information for one or both Controllers.

SYNOPSIS

controller ‑list 
   [‑details]
   [{ [‑controller controller‑id‑or‑fqn [,controller‑id‑or‑fqn]... ]
      [‑diagnostics]
      [‑master]
      [‑linkAggregation]
    | ‑port [controller[/slot[/port]] [,controller[/slot[/port]]]... ]
    }]

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

Run the controller ‑list command to obtain the fully qualified names of the Controllers.

Run the controller ‑list ‑details command to obtain status and configuration information for the Controllers and their components. Additional options are available to inquire about the network interface ports. The port information can optionally include the link aggregation status.

Note: Administrators with primary administrator, admin1, admin2, monitor, or support roles can run the controller ‑list command and most of the options. However, only administrators with primary administrator, admin1, or support roles are authorized to run the ‑master option.

OPTIONS

‑controller

Specifies the fully qualified name (FQN) or unique identifier (ID) of one or more Controllers. When specifying more than one Controller, provide commas to separate the FQNs or IDs.

‑details

Returns the following information for each of the specified Controllers:

The temperature status, serial number, and revision number of the Controller.
The service type of the Controller: nas, san, nasBias, or sanBias
The port provisioning settings for each HBA, if the ‑port option is included. Includes the link aggregation settings of the ports, if ‑linkAggregation is included.
The status and configurations of the Controller, the power supplies, and the power supply fans.
The fully qualified name of the master Controller, if the ‑controller option is included. In a peer-to-peer configuration, the master Controller assumes the functioning of the failed Controller and operates in a conservative mode.

‑diagnostics

Returns the most recent diagnostics report for the specified Controller.

‑linkAggregation

Returns the link aggregation settings that show individual HBA ports that are linked to present their combined throughput to the network as a single port. Only two ports on a given HBA card can be link aggregated.

‑master

Returns the fully qualified name or ID of the Controller that is designated to be the master Controller. In the Oracle FS System, the master Controller maintains the system configuration information, and communicates with the Pilot.

Only administrators with primary administrator, admin1, or support roles are authorized to run this option.

‑port

Returns information about one or more ports. To specify a port, use the following format: controller/slot/port. Specify each portion of the variable by providing the following values:

For the controller portion of the variable, provide a string that includes the fully qualified name or ID of the Controller.
For the slot portion of the variable, specify the HBA slot number.
For the port portion of the variable, specify the port number. You can optionally provide “Port” as a label before the number.

Separate each element in the string with a forward slash character (/). If you do not specify a port, controller ‑list returns information about all of the ports.

EXAMPLE

Task

Before replacing a failed FRU, Oracle Customer Support requests that you verify that the Controller has failed over to the partner Controller.

Parameters

None

$ fscli controller ‑list ‑details