mmchcomp command

Changes attributes associated with one or more storage components.

Synopsis

mmchcomp Component
            [--part-number PartNumber] [--serial-number SerialNumber]
            [--display-id DisplayId] [--name Name] [--dry-run]

mmchcomp -F StanzaFile [--dry-run]

Availability

Available with the Elastic Storage Server.

Description

The mmchcomp command changes the various attributes associated with one or more components.

Parameters

Component

Specifies the current name, serial number, or ID of a single component for which one or more attributes are to be changed.

--part-number PartNumber

Specifies a new part number to be assigned to the component. You cannot specify a part number that would change the component type.

--serial-number SerialNumber

Specifies a new serial number to be assigned to the component.

--display-id DisplayID

Specifies a new display ID to be assigned to the component. This applies to storage enclosures only. After setting this attribute, use mmsyncdisplayid to update the storage enclosure hardware.

--name Name

Specifies a new name 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
 partNumber=PartNumber
 serialNumber=SerialNumber
 name=Name
 displayId=DisplayId
 nodeNumber=NodeNumber

where:

compID=Component: Specifies the current name, serial number, or ID of a single component for which one or more attributes are to be changed. This is a required parameter.
partNumber=PartNumber: Specifies a new part number to be assigned to the component. You cannot specify a part number that would change the component type.
serialNumber=SerialNumber: Specifies a new serial number to be assigned to the component.
name=Name: Specifies a name to be assigned to the component. A default name is assigned if one is not specified.
displayId=DisplayId: Specifies a new display ID to be assigned to the component. This applies to storage enclosures only. After setting this attribute, use mmsyncdisplayid to update the storage enclosure hardware.

--dry-run

Indicates that the changes resulting 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 mmchcomp 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

To update the name of an enclosure (in this case, the third enclosure) so that the name includes the product serial number, and to see the result, enter the following commands:

mmchcomp 3 --name G1E3-SX98760044
mmlscomp --type storageenclosure

The system displays output similar to this:

    Storage Enclosure Components
 
Comp ID  Part Number  Serial Number  Name                Display ID
-------  -----------  -------------  ------------------  ----------
      1  1818-80E     SV12345001     1818-80E-SV12345001  21
      2  1818-80E     SV12345007     1818-80E-SV12345007  01
      3  1818-80E     SV12345003     G1E3-SX98760044     13
      4  1818-80E     SV12345005     1818-80E-SV12345005  05
      5  1818-80E     SV12345004     1818-80E-SV12345004  37
      6  1818-80E     SV12345002     1818-80E-SV12345002  25
      7  1818-80E     SV12345008     1818-80E-SV12345008  17
      8  1818-80E     SV12345006     1818-80E-SV12345006  33

Location

/usr/lpp/mmfs/bin