controller ‑completeFru

Notifies the Oracle FS System that the maintenance operations that were performed on the Controller are complete.

SYNOPSIS

controller ‑completeFru 
   ‑controller controller‑id‑or‑fqn
   { ‑powerSupply powerSupply‑fru‑number
   | ‑fan fan‑fru‑number
   | ‑mb mb‑fru‑number
   | ‑chassis chassis‑fru‑number
   | ‑cpu cpu‑fru‑number
      [‑memory memory‑fru‑number]
   | ‑esm esm‑fru‑number
   | ‑pcieRiser pcieRiser‑fru‑number
   | ‑nicHba nicHba‑fru‑number
   | ‑sasHba sasHba‑fru‑number
   }

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

DESCRIPTION

After the field support representative replaces a FRU or upgrades the Controller hardware, the Oracle Customer Support representative might request that you run the controller ‑completeFru command. Before issuing the command, the Oracle Customer Support representative might request that you verify that the following conditions have been met:

The Oracle FS System has marked the upgraded or replaced FRU with a NORMAL status in the output of the controller ‑list ‑details command.
The Controller is marked as NORMAL in the output of the controller ‑list ‑details command.
The partner Controller is no longer marked as CONSERVATIVE in the output of the system ‑list ‑details command.

Note: If one or more memory or HBA cards were added to the system, the Oracle FS System first runs acceptance tests on the Controllers before allowing them to rejoin the system. The Oracle Customer Support representative might request that you check the Management State of both Controllers and verify that both Controllers are marked as AVAILABLE. The Oracle Customer Support representative might also request that you run the controller ‑list ‑details command to verify that all of the new memory or HBA cards have also passed the acceptance tests.

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

OPTIONS

‑chassis

Specifies the FRU number for the chassis in the Controller that was replaced. The value for the chassis is 0. The system brings the Controller online by performing the following operations:

The system powers up the Controller and runs acceptance tests.
The system fails back to the restored Controller from the partner Controller.
The restored Controller is brought online.
The partner Controller is taken out of a conservative mode.

‑controller

Specifies the fully qualified name (FQN) or unique identifier (ID) of the repaired Controller.

‑cpu

Specifies the CPU in the Controller that was replaced. Runs acceptance tests on the CPU and Controller. If the hardware components pass the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. Values are 0 or 1.

Note: If the ‑memory option is specified, indicates the CPU on which the replaced DIMM or NVDIMM resides.

‑esm

Specifies the energy storage module that was replaced. Runs acceptance tests on the new energy storage module and Controller. If the Controller passes the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. Values are 0 and 1.

‑fan

Specifies the fan that was replaced. Runs acceptance tests on the fan and the Controller. After the fan and Controller pass the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. The values for fans are 0 through 4.

‑mb

Specifies the motherboard that was replaced. Runs acceptance tests on the new motherboard and on the Controller. If the motherboard and Controller pass the acceptance tests, the Controller is placed online. The Controller is taken out of a conservative mode. There is only one motherboard in the Controller. The value is 0.

‑memory

Specifies the memory slot on the CPU in which the replaced DIMM or NVDIMM memory card resides. Values are 0 through 7.

Note: In addition to the slot number, you must specify the CPU in which the memory card resides by specifying a value for the ‑cpu option. The DIMM cards reside in slots 0 through 7 on CPU 0, and in slots 2 through 7 on CPU 1. The NVDIMM cards reside in slots 0 and 1 on CPU 1.

‑nicHba

Specifies the network interface HBA card that was replaced. The system also enables and brings online the PCIe riser in which the HBA card resides. Runs acceptance tests on the following components:

The HBA card
The PCIe riser
The Controller

If the hardware components pass the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. If the Controller is set to automatically provision the network interface cards, the provisioning protocols are automatically configured for the HBA ports. The values for the network interface HBA cards are 0 through 5.

‑pcieRiser

Specifies the PCIe riser to enable and bring online. The HBA cards that are inserted into the new riser are also enabled and brought online. PCIe riser values are 0, 1, or 2.

‑powerSupply

Specifies the power supply to enable and bring online. Runs acceptance tests on the power supply and the Controller. After the power supply passes the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. The values for the power supplies are 0 or 1.

‑sasHba

Specifies the SAS HBA card to enable and bring online. Runs acceptance tests on the HBA card, on the PCIe riser, and on the Controller.

After each of the hardware components pass the acceptance tests, the Controller is placed online. The partner Controller is taken out of a conservative mode. The system updates the private interconnect topology to include the new SAS HBA card. The values for the SAS HBA cards are 0 through 5.

GLOBAL OPTIONS FOR SUBCOMMANDS

The following global options can be used for fscli command-subcommand pairs that do not include other command-line options:

‑help: Returns the context-sensitive help for the specified subcommand.
‑usage: Returns the subcommand syntax for the given command, including all of the options that are available for the command-subcommand pair.

GLOBAL OPTIONS FOR COMMANDS

The following global options can be used for fully formed fscli commands:

‑example

Returns sample output from the specified command.

Note: To see the output in XML format, include the ‑o xml option.

‑timeout timeout-in-seconds

Specifies the length of time (timeout-in-seconds) that the command line interface waits before another command is allowed to run. If the command takes longer to run than the specified time limit, the system continues processing the command, but the command prompt is made available so that you can issue another command. If the -timeout option is omitted, the command line interface blocks until the one of the following conditions is met:

The command completes successfully.
The command returns with an error.
The session times out.

Note: Be sure to check the state of the system after initiating a long running command with the ‑timeout option. Many fscli commands run a series of underlying commands in sequence. When the timeout value is reached before all of the underlying commands have completed, the fscli command does not complete with the outstanding tasks reporting a failure status.

‑outputformat | ‑o { text | xml }: Controls the type of the output the system returns from a command. If the ‑outputformat option is not included, the format of the output defaults to simple text. If xml is provided, the output is a collection of XML elements.
Note: For XML output, if internal errors occur during command execution, each error is included in a separate <ErrorList> tag.

‑verify: Inspects the validity of the command syntax, not the semantics. Used to test the structure of a command without running the command. Does not determine whether errors would be produced if you issue a structurally correct command with the input provided.
‑sessionkey: Directs the CLI to prompt you to supply a session key when you issue the command. The CLI displays Sessionkey: as the prompt. To obtain a session key, log in with the ‑returnKey option specified. After the session is established, the session key is displayed in STDOUT. If you request a session key, the ‑sessionkey option is required syntax for all commands that are issued in a given session. In environments with more than one Oracle FS System, the session key is used to determine to which Oracle FS System to direct the command for validation. Session keys are also used to establish two or more CLI sessions when using a shared administrator account.
‑u admin-user ‑oracleFS oracle‑fs-system: Routes the command to a particular Oracle FS System for execution. This option passes the name of the administrator account to use when opening the session on the specified system. Identify a specific Oracle FS System by its IP address or by the name that is recorded in the domain name system (DNS). When logging in to the Oracle FS System using the ‑u option and the ‑oracleFS option, the fscli application prompts you for a password on the command line interface for access. The Oracle FS System and the account login information are used to authenticate the current session. Establishing a login session by specifying an Oracle FS System and an account does not change the credentials that are associated with the active sessions that are running on other clients.
Caution
Oracle recommends that you not use the Cygwin command line interface to run the fscli application on Windows platforms. If you are running the Cygwin interface and include the ‑u option as a part of the ‑list subcommand, the password for the specified account is included in the results. Exposing the password can cause a breach in security.

EXAMPLE

Task

Oracle Customer Support instructs you to complete the process of replacing a failed power supply. After preparing the Controller for the replacement procedure, you remove the failed supply and insert a replacement. The controller -completeFru command performs acceptance tests and brings the new power supply online.

Parameters

The name of the Controller preceded by a forward slash: /⁠CONTROLLER-00
The FRU number of the power supply: 0

$ fscli controller ‑completeFru ‑controller /⁠CONTROLLER-00 ‑powerSupply 0