mmchcomploc command

Changes the location of one or more storage components.

Synopsis

mmchcomploc Component Container Position [--dry-run]
or 
mmchcomploc -F StanzaFile [--dry-run]

Availability

Available with the Elastic Storage Server.

Description

The mmchcomploc command changes the location (container and position within the container) of one or more storage components.

Parameters

Component
Specifies the current name, serial number, or component ID of a single component for which the location is to be changed.
Container
Specifies the name, serial number, or component ID of the container to be assigned to the component.
Position
Specifies an integer value that identifies the position within the container to be assigned to the component.
-F StanzaFile
Specifies the name of a stanza file from which input values are to be read. The stanza file can include stanzas for multiple components.
The correct format for the component definitions in the stanza file is as follows:
%comp:
 compId=Component
 containerId=Container
 position=Position
where:
compId=Component
Specifies the current name, serial number, or component ID of a single component for which the location is to be changed. This is a required parameter.
containerId=Container
Specifies the name, serial number, or component ID of the container to be assigned to the component. This is a required parameter.
position=Position
Specifies an integer value that identifies the position within the container to be assigned to the component. This is a required parameter.
--dry-run
Indicates that the changes that result from the command are not to be recorded in the configuration file.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmchcomploc 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 more details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

To place a component in a rack and see the result, enter the following commands:

mmchcomploc SV12345003 R01C01 13
mmlscomploc

The system displays output similar to this:

Component           Location
------------------  ------------------
1818-80E-SV12345003 Rack R01C01 U13-16

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin