enclosure ‑replaceFru

Prepares the specified FRU for replacement.

SYNOPSIS

enclosure ‑replaceFru 
   ‑enclosure enclosure‑id‑or‑fqn
   [‑abort ]
   { ‑powerCoolingModule powerCoolingModule‑fru‑number
   | ‑diskDrive diskDrive‑fru‑number
   | ‑chassis chassis‑fru‑number
   | ‑iom io‑module‑fru‑number
      [‑sasPort sasPort‑fru‑number]
   }

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

DESCRIPTION

In most instances, when replacing a FRU, you use Guided Maintenance, not the Oracle FS CLI. In rare instances, however, an Oracle Customer Support representative might direct you to use the FSCLI. When issuing the enclosure commands, follow the instructions that are provided to you by Oracle Customer Support.

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

CAUTION

When replacing several drives in a Drive Enclosure, replace the drives one at a time. To verify that the process has completed, inspect the output of the system_alert ‑list command. After accepting the new drive and bringing the drive group online, the Oracle FS System removes all system alerts that were associated with the failed drive. Wait for the system to remove the alerts before replacing another drive. Replacing a drive before the previous drive replacement procedure has completed can cause data loss.

OPTIONS

‑abort

Cancels the processes that prepare the specified FRU for replacement.

‑chassis

Specifies the FRU number for the chassis in the Drive Enclosure. The value for the chassis is 0. To prepare the chassis for replacement, the system performs the following operations:

Stops all I/O traffic to the Drive Enclosure.
Marks all of the drive groups as missing.
Marks all of the volumes that are provisioned on the Drive Enclosure as offline.
Marks the Drive Enclosure as missing.
Powers down the Drive Enclosure.

‑diskDrive

Specifies the slot number of the drive to replace. The Oracle FS System marks the drive slot as EMPTY and marks the drive in the drive group as MISSING. Values are 0 to 23 for rotating media (performance or archive). Values are 0 to 18 for SSDs.

‑enclosure

Specifies the fully qualified name (FQN) or unique identifier (ID) of the Drive Enclosure that contains the FRU to replace. The FQN includes the chassis ID, which is displayed on the front of the Drive Enclosure.

‑iom

Specifies the FRU number for the I/O module to replace. Valid values are 0 and 1.

‑powerCoolingModule

Specifies the power cooling module to replace. To prepare a power cooling module for replacement, the system powers off the module and marks it as missing. Values are 0 or 1.

‑sasPort

Specifies the SAS port on an I/O Module to replace. The ‑sasPort option must be specified with the -iom option. SAS port values are 0, 1, and 2.

EXAMPLE

Task

Prepare a drive for replacement.

Parameters

The name of the Drive Enclosure preceded by a forward slash: /⁠⁠ENCLOSURE-01
The slot number of the replaced drive: 22

$ fscli enclosure ‑replaceFru ‑enclosure /⁠ENCLOSURE-01 ‑diskDrive 22