enclosure ‑modify

Changes the configuration of a Drive Enclosure.

SYNOPSIS

enclosure ‑modify 
   ‑enclosure enclosure‑id‑or‑fqn
   [{ [‑displayNumber enclosure‑display‑number]
      [‑comment enclosure‑descriptive‑comment]
    | ‑acceptDrive drive‑slot‑number [, drive‑slot‑number ]...
    | ‑remove
    | ‑resetOverheatState
    }]

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

DESCRIPTION

Use the enclosure ‑modify command to perform the following configuration changes:

Change the display number that appears on the outside of the Drive Enclosure.
Provide a string of optional text to describe the Drive Enclosure.

If you are replacing a failed drive, an Oracle Customer Support representative might request that you run the enclosure ‑modify ‑enclosure enclosure-id-or-fqn ‑acceptDrive drive-slot-number command to accept the replaced drive into the system. If the drive is accepted, the Oracle Customer Support representative might request that you finalize the FRU replacement process by running the enclosure ‑completeFru ‑enclosure enclosure-id-or-fqn ‑diskDrive drive-slot-number command.

If you are removing a Drive Enclosure from a Oracle FS System, the Oracle Customer Support representative might request that you run the enclosure ‑modify ‑remove ‑enclosure enclosure-id-or-fqn command before physically removing the Drive Enclosure from the Oracle FS System.

Only administrators with primary administrator, admin1, or support roles are authorized to run the enclosure ‑modify ‑remove option. Only administrators with primary administrator or admin1 roles are authorized to run the other enclosure ‑modify options.

OPTIONS

‑enclosure: Specifies the fully qualified name (FQN) or unique identifier (ID) of the Drive Enclosure to modify. The FQN includes the chassis ID, which is displayed on the front of the Drive Enclosure.
‑displayNumber: Specifies the number that is displayed on the outside of the Drive Enclosure. Values range from 01 to 99 and A0 to FF. The display number is included in the fully qualified name of the Drive Enclosure.
‑comment: Specifies a string of 256 characters that you provide to further identify the Drive Enclosure.
‑acceptDrive: Specifies the slot number of one or more new drives. Instructs the Drive Enclosure to accept the drive, and adds the new drive capacity to the overall physical capacity available to Oracle FS System. Slot numbers range from 0 to 23, 0 to 11, or 0 to 5, depending on the hardware configuration of the Drive Enclosure.
‑remove: Specifies the fully qualified name (FQN) or unique identifier (ID) of the Drive Enclosure to remove. The FQN includes the chassis ID, which is displayed on the front of the Drive Enclosure. Determines the drive’s capacity and subtracts it from the calculations of total physical storage capacity available for use on the Oracle FS System.

Note: To prepare a Drive Enclosure for removal, you must ensure that the disks in the Drive Enclosure are not members of a drive group. Exclude any drive groups on the Drive Enclosure from their storage domain, and then delete the drive groups. Also, you must power down the Drive Enclosure and remove connections to the Oracle FS System.
‑resetEnclosureOverheatState: Resets the overheat status on the Drive Enclosure.

EXAMPLE

Task

Change the display number for a Drive Enclosure to a new number that is not in use.

Parameters

The name of the Drive Enclosure preceded by a forward slash: /⁠⁠ENCLOSURE-01
The new display number: 05

$ fscli enclosure ‑modify ‑enclosure /⁠ENCLOSURE-01 ‑displayNumber 05