controller ‑remove

Removes the configuration information that is stored on disk for a Controller or an HBA.

SYNOPSIS

controller ‑remove 
   ‑controller controller‑id‑or‑fqn
   [ ‑slot hba‑slot‑number ]

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

DESCRIPTION

After a Controller is forced to fail over to a partner Controller, a field service representative can power down the Controller, and physically remove it from the Oracle FS System. When the system marks the Controller as missing, the Oracle Customer Support representative can issue a controller ‑remove ‑controller controller-id-or-fqn command to delete the Controller from the configuration database that is stored on disk. Similarly, the Oracle Customer Support representative can issue a controller ‑remove ‑controller controller‑id‑or‑fqn ‑hba hba‑slot‑number command to delete the HBA from the configuration database that is stored on disk. Only Controllers and HBAs that are in a missing state can be removed from the configuration database that is stored on disk. The Oracle FS System does not allow you to remove Controllers or HBAs in any other state.

Note: Removing a Controller without providing a replacement Controller compromises the high availability access to user data. To prevent this risk, the field support representative may choose to install a replacement Controller while the faulty Controller is being serviced.

Note: Only administrators with support roles are authorized to run controller ‑remove command.

OPTIONS

‑controller: Specifies the fully qualified name (FQN) or unique identifier (ID) of the Controller for which the configuration information that is stored on disk is removed.
‑slot: Specifies the HBA slot-number for which the configuration information that is stored on disk is to be removed. If specified, only the HBA configuration information is removed.

EXAMPLE

Task

The Oracle Customer Support representative removes a Controller from the Oracle FS System by deleting the configuration information about the Controller that is stored on disk.

Parameters

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

$ fscli controller ‑remove ‑controller /⁠CONTROLLER-0