controller ‑command

Issues one or more native Controller commands on the Controller.

SYNOPSIS

controller ‑command 
   ‑controller controller‑id‑or‑fqn
   ‑commandString command‑string
   [‑parameters parameter‑string]
   [‑environment envname1:value1 [, envname2:value2]... ]
   [‑timeout timeout‑value]

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

DESCRIPTION

When diagnosing an environmental issue, to check the configuration, or to verify the health of the components in the Controller, Oracle Customer Support might require that you issue native Controller commands directly on the Controller. These commands bypass the Oracle FS System management software. Use only as instructed by Oracle Customer Support.

Note: In a production environment, do not attempt to issue native commands on a Controller that are potentially disruptive unless the Controller is already excluded from the system, or Oracle Customer Support has forced the Controller to fail. Verify that the partner Controller has assumed the responsibilities of the failed Controller. Before issuing native Controller commands, check the status of the FailoverFailbackState field in the output of the controller ‑list ‑details command.

Note: Only administrators with primary administrator, admin1, or support roles are authorized to run controller ‑command command.

OPTIONS

‑commandString: Specifies the native Controller command. Specify the command name only. If any parameters are required, specify the parameters as variables to the ‑parameters option.
‑controller: Specifies the fully qualified name (FQN) or the unique identifier (ID) of the Controller to which the native Controller command is sent. Run the controller ‑list ‑details command to obtain the FQN or ID.
‑environment: Sets one or more native Controller environmental variables. Set each environmental variable by providing a colon-separated name and value pairing. Use commas when specifying more than one environmental variable pairing.
‑parameters: Specifies the native Controller command parameters. When specifying two or more parameters, use a space to separate each parameter in the string. Enclose the entire string in quotes.
‑timeout: Specifies the time in seconds for the native Controller command to run. If a timeout value is not specified, then the command runs until it fails, succeeds, or continues until Oracle Customer Support cancels the command.

EXAMPLE

Task

Oracle Customer Support issues a native Controller netstat command on a Controller.

Parameters

The name of the Controller preceded by a forward slash: /⁠CONTROLLER-0
The name of the native Controller command: netstat

$ fscli controller ‑command ‑controller /⁠CONTROLLER-01 ‑commandString netstat