Adding components to the cluster’s configuration

This section discusses how to add components to the cluster's configuration in an ESS system. Sample output in this topic might not match the output produced on your system.

Before adding any components, you might want to view the available component specifications. To do so, you can use the mmlscompspec command, which lists the defined component specifications, identified by part number.

$ mmlscompspec
 
    Rack Specifications
 
Part Number  Height  Description
-----------  ------  --------------------------------------------------
1410HEA          42  42U 1200mm Deep Expansion Rack
1410HPA          42  42U 1200mm Deep Primary Rack
 
    Server Specifications
 
Part Number  Height  Description
-----------  ------  -------------------
824722L           2 IBM Power System S822L
 
    Storage Enclosure Specifications
 
Part Number  Height  Description                  Vendor ID  Product ID  Drive Slots  Has Display ID
-----------  ------  ---------------------------  ---------  ----------  -----------  --------------
1818-80E          4  DCS3700 Expansion Enclosure  IBM        DCS3700              60               1

If this was the first component command run on the cluster, you will see some initialization messages before the command output. The list of component specifications will be short because it only includes supported ESS hardware.

You can use mmdiscovercomp to define some of the cluster's components. This command finds supported storage enclosures attached to any of the cluster nodes and adds them to the cluster's configuration. (In your version of IBM Storage Scale, mmdiscovercomp might find additional component types.) The output below resembles a cluster that includes two GL4 units.

$ mmdiscovercomp all
Adding enclosure: serial number = SV12345001; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345007; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345003; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345005; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345004; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345002; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345008; vendor ID = IBM; product ID = DCS3700
Adding enclosure: serial number = SV12345006; vendor ID = IBM; product ID = DCS3700
 
Storage Enclosures
 
Status  Comp ID  Component Type    Part Number  Serial Number  Name                Display ID
------  -------  ----------------  -----------  -------------  ------------------  ----------
new           1  storageEnclosure  1818-80E     SV12345001     1818-80E-SV12345001  00
new           2  storageEnclosure  1818-80E     SV12345007     1818-80E-SV12345007  00
new           3  storageEnclosure  1818-80E     SV12345003     1818-80E-SV12345003  00
new           4  storageEnclosure  1818-80E     SV12345005     1818-80E-SV12345005  00
new           5  storageEnclosure  1818-80E     SV12345004     1818-80E-SV12345004  00
new           6  storageEnclosure  1818-80E     SV12345002     1818-80E-SV12345002  00
new           7  storageEnclosure  1818-80E     SV12345008     1818-80E-SV12345008  00
new           8  storageEnclosure  1818-80E     SV12345006     1818-80E-SV12345006  00

In this example, mmdiscovercomp found eight storage enclosures that were not already in the cluster configuration. Notice that each component gets a default name. Below we will discuss how you can change the name to some identifier that is more suitable for your environment. You may run mmdiscovercomp a second time, in which case it should not find any new components.

Note: The serial numbers used by IBM Storage Scale to identify 1818-80E storage enclosures do not match the product serial numbers shown on the outside of the enclosure. You may want to record this visible serial number as part of the enclosure's name. For example, you could rename an enclosure to S1E3-SX98760044, which would stand for "storage server 1" (S1), "enclosure 3" (E3), with product serial number SX98760044. For details about how to change the name of a component using the mmchcomp command, see Updating component attributes.

The other essential components are racks to hold the storage enclosures. Use the mmlscompspec command to see the available rack part numbers, then use the mmaddcomp command to define the racks. This example shows how to define a 42U 1200mm Deep Primary Rack and give it the name R01C01.

$ mmaddcomp 1410HPA --name R01C01
$ mmlscomp
 
    Rack Components
 
Comp ID  Part Number  Serial Number  Name
-------  -----------  -------------  ------
      9  1410HPA                     R01C01
 
    Storage Enclosure Components
 
Comp ID  Part Number  Serial Number  Name                Display ID
-------  -----------  -------------  ------------------  ----------
      1  1818-80E     SV12345001     1818-80E-SV12345001
      2  1818-80E     SV12345007     1818-80E-SV12345007
      3  1818-80E     SV12345003     1818-80E-SV12345003
      4  1818-80E     SV12345005     1818-80E-SV12345005
      5  1818-80E     SV12345004     1818-80E-SV12345004
      6  1818-80E     SV12345002     1818-80E-SV12345002
      7  1818-80E     SV12345008     1818-80E-SV12345008
      8  1818-80E     SV12345006     1818-80E-SV12345006