mmchenclosure command

A service aid to be run before replacing disk enclosure components. Identifies whether it is safe to complete the repair action or whether IBM Storage Scale needs to be shut down first.

Synopsis

mmchenclosure SerialNumber
              --component { canister | cpu | currentSensor | dcm | dimm | drawer | enclosure | esm | expander | fan | powerSupply | sideplane | tempSensor | voltageSensor }
              --component-id Id

Availability

Available with the Elastic Storage Server.

Description

Use the mmchenclosure command to check whether it is safe to replace a component while the GPFS daemon is active. The command will indicate whether there are issues that would require the GPFS daemon to be stopped before proceeding.

In the case of failures, the field replaceable units are:

Drives.
Enclosure drawers. Any failure that is related to a drawer control module (DCM)'s component ID (component type: dcm) requires a drawer replacement.
Environmental service modules (ESMs).
Expanders.
Fan assemblies.
Power® supplies.
Sideplanes.

Parameters

--serial-number SerialNumber

Specifies the serial number of the storage enclosure (as identified in the output of the mmlsenclosure command).

--component { canister | cpu | currentSensor | dcm | dimm | drawer | enclosure | esm | expander | fan | powerSupply | sideplane | tempSensor | voltageSensor }

Specifies the type of component that needs to be changed. The component types follow:

canister: Is a canister module.
cpu: Is a central processing unit.
currentSensor: Is a current sensor.
dcm: Is a drawer control module.
dimm: Is a memory module.
drawer: Is a drawer.
enclosure: Is a storage enclosure.
esm: Is an environmental service module.
expander: Is a sub-expander.
fan: Is a cooling fan.
powerSupply: Is a power supply.
sideplane: Is an expander board.
tempSensor: Is a temperature sensor.
voltageSensor: Is a voltage sensor.

--component-id Id

Specifies the component ID (as identified in the output of the mmlsenclosure command).

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmchenclosure command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

Before replacing a fan with a component ID of 2_BOT_RIGHT on enclosure SV13306129, run:

mmchenclosure SV13306129 --component fan --component-id 2_BOT_RIGHT

In this example, mmlsenclosure did not show the fan as needing to be replaced. The system displays information similar to this:

 
mmchenclosure: [E] Storage enclosure SV13306129 component fan component id 2_BOT_RGHT is not failed. 
 Service is not required.
Storage enclosure SV13306129 component fan component id 2_BOT_RGHT is not failed. Service is not required.
 mmchenclosure: Command failed.  Examine previous error messages to determine cause.

Before replacing a fan with a component ID of 1_BOT_LEFT on enclosure SV13306129, run:
```
mmchenclosure SV13306129 --component fan --component-id 1_BOT_LEFT
```
The system displays output similar to this:
```
mmchenclosure: Proceed with the replace operation.
```

Before replacing the drawer associated with DCM component ID DCM_0A on enclosure SV13306129, run:

mmchenclosure SV13306129 --component dcm --component-id DCM_0A

The system displays output similar to this:

     mmchenclosure: Shutdown GPFS on the following nodes and then proceed 
     with the replace operation.
     Shutdown GPFS on the following nodes and then proceed with the replace 
     operation.

Before replacing an ESM with a component ID of ESM_A on enclosure SV13306129, run:

mmchenclosure SV13306129 --component esm --component-id ESM_A