controller ‑replaceFru

Prepares the Controller for maintenance.

SYNOPSIS

controller ‑replaceFru 
   ‑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
   }
   [‑abort]

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

DESCRIPTION

Oracle Customer Support might request that you issue a controller ‑replaceFru command to prepare the Controller for the following maintenance operations:

Replacing FRUs
Upgrading Controllers
Adding or removing network interface HBA cards
Adding or removing SAS HBA cards
Adding or removing memory (NVDIMM or DIMM)

Note: Immediately after you run the controller ‑replaceFru command, the FSCLI returns with a successful status if the specified Controller is in an AVAILABLE management state. Receiving the successful status does not mean that the Controller is fully prepared for a FRU replacement procedure. Instead, the Oracle FS System must complete the following processes before it is safe to power off the Controller:

The Controller fails over to the partner Controller.
The partner Controller assumes the responsibilities of the failed over Controller.
The system places the partner Controller into a conservative operational mode.
The system marks the prepared Controller as FAILED_OVER.

Note: When preparing the Controller for the replacement of a failed component, specify a FRU number. To obtain the FRU number, use one of the following methods:

The system_alert ‑list ‑details command provides information to identify the component. For some of the components, the FRU number is displayed in the slot field.
The controller ‑list ‑details command marks a failed FRU with a WARNING or CRITICAL status. The Location field provides the FRU number.

Note: The Oracle FS System requires that memory or HBA cards are added to both Controllers in a symmetrical configuration. When adding memory or HBA cards, Oracle Customer Support might request that you run the controller ‑list ‑details command to identify the empty slots. After Oracle Customer Support determines the most appropriate slot to specify as the FRU number, run the controller ‑replaceFru command to prepare one of the Controllers. The Controller fails over to the partner Controller. To prepare the partner Controller, Oracle Customer Support might request that you run a system ‑shutdown command. Before shutting down the Oracle FS System, be sure to stop all I/O traffic to the partner Controller.

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

OPTIONS

‑abort

Cancels the processes that prepare the specified FRU for replacement.

‑chassis

Specifies the FRU number for the chassis in the Controller to prepare for replacement. The value for the chassis is 0. The system performs the following operations:

The system marks the chassis as missing.
The system fails the Controller over to the partnerController.
The prepared Controller is powered off and marked as missing.
The system places the partner Controller into a conservative mode.

‑controller

Specifies the fully qualified name (FQN) or unique identifier (ID) of a Controller to prepare for upgrade or maintenance.

‑cpu

If the ‑memory option is not provided, specifies the CPU to prepare for replacement. The system performs the following operations:

The Controller with the faulty CPU fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

If the ‑memory option is provided, specifies the CPU on which the faulted DIMM or NVDIMM memory card resides.

Values are 0 or 1.

‑esm

Specifies the energy storage module in the Controller to prepare for replacement. Values are 0 and 1. The system performs the following operations:

The Controller with the faulty energy storage module fails over to the partner Controller.
The Controller is powered off and marked as missing.
The system places the failed to Controller into a conservative mode.

‑fan

Specifies the fan to prepare for replacement. The system performs the following operations:

The system powers down the fan and marks it as missing.
The Controller with the faulty fan fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

The values for the fans are 0 through 4.

‑mb

Specifies the motherboard to prepare for replacement. The system performs the following operations:

The system prepares the motherboard for replacement and marks it as missing.
The Controller with the faulty motherboard fails over to the partner Controller.
The Controller is powered off and the Controller is marked as missing.
The system places the partner Controller into 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 faulted DIMM or NVDIMM memory card resides. The system performs the following operations:

The system prepares the DIMM or NVDIMM card for replacement and marks it as missing.
The Controller with the faulty memory card fails over to the partner Controller.
The Controller is powered off and the Controller is marked as missing.
The Oracle FS System places the partner Controller into a conservative mode.

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 to prepare for replacement. The system performs the following operations:

The system disables the card and marks it as missing.
The Controller with the faulty HBA card fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

The values for the network interface HBA cards are 0 through 5.

‑pcieRiser

Specifies the PCIe riser to prepare for replacement. The system performs the following operations:

The system disables the PCIe riser and marks it as missing.
The HBA cards that are inserted into the PCIe riser are marked as missing.
The Controller with the faulty PCIe riser fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

The values for the PCIe riser are 0, 1, or 2.

‑powerSupply

Specifies the power supply to prepare for replacement. The system performs the following operations:

The system disables the power supply and marks it as missing.
The Controller with the faulty power supply fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

Values of the power supplies are 0 or 1.

‑sasHba

Specifies the SAS HBA card to prepare for replacement. The system performs the following operations:

The system disables the SAS HBA card and marks it as missing.
The Controller with the faulty HBA card fails over to the partner Controller.
The Controller is powered off and is marked as missing.
The system places the partner Controller into a conservative mode.

Values of the SAS HBA cards are 0 through 5.

EXAMPLE

Task

To begin the process of replacing a faulty power supply, Oracle Customer Support instructs you to prepare the Controller for a FRU replacement.

Parameters

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

$ fscli controller ‑replaceFru ‑controller /⁠CONTROLLER-0 ‑powerSupply 0