Preparing the IBM Storage Scale Erasure Code Edition cluster using the installation toolkit

In the 3rd phase of incorporating IBM Storage Scale Erasure Code Edition in an ESS cluster, use the installation toolkit to create a new cluster definition file that would be used to create an unconfigured IBM Storage Scale Erasure Code Edition cluster within the ESS cluster.

Note: The steps in this phase need to be done on IBM Storage Scale Erasure Code Edition candidate nodes, not on the ESS nodes.
  1. From IBM® Fix Central, download IBM Storage Scale Erasure Code Edition 5.x.y.z installation package on your installer node.
  2. Extract IBM Storage Scale Erasure Code Edition 5.x.y.z installation package to a directory on the installer node that is different from the installer directory that you used for the initial installation and deployment in phase 2. For example, /usr/lpp/mmfs/5.x.y.z_ECE_New/.
    
    /DirectoryPathToDownloadedCode/Spectrum_Scale_Erasure_Code-5.x.y.z-x86_64-Linux-install 
    --dir /usr/lpp/mmfs/5.x.y.z_ECE_New/
  3. Change the directory to the new directory in which the package was extracted.
    # cd /usr/lpp/mmfs/5.x.y.z_ECE_New/ansible-toolkit
  4. Change the setup type of the installer node to ece.

    In this command example, 198.51.100.1 is the IP address of the scale-out node that is designated as the installer node.

    # ./spectrumscale setup -s 198.51.100.1 -st ece
    
    [ INFO ] Installing prerequisites for install node
    [ INFO  ] Found existing Ansible installation on system.
    [ INFO ] Install Toolkit setup type is set to ECE (Erasure Code Edition).
    [ INFO ] Your Ansible control node has been configured to use the IP 198.51.100.1 to communicate
    with other nodes.
    [ INFO ] Port 10080 will be used for package distribution.
    [ INFO ] SUCCESS
    [ INFO ] Tip : Designate scale out, protocol and admin nodes in your environment to use
    during install:./spectrumscale node add <node> -p -a -so
    
    Verify the node details.
    # ./spectrumscale node list
    
    [ INFO ] List of nodes in current configuration:
    [ INFO ] [Installer Node]
    [ INFO ] 198.51.100.1
    [ INFO ]
    [ INFO ] [Cluster Details]
    [ INFO ] No cluster name configured
    [ INFO ] Setup Type: Spectrum Scale
    [ INFO ]
    [ INFO ] [Extended Features]
    [ INFO ] File Audit logging : Disabled
    [ INFO ] Watch folder : Disabled
    [ INFO ] Management GUI : Disabled
    [ INFO ] Performance Monitoring : Disabled
    [ INFO ] Callhome : Enabled
    [ INFO ]
    [ INFO ] No nodes configured. Use 'spectrumscale node add' to add nodes.
    [ INFO ] If a cluster already exists use 'spectrumscale config populate ‐N node_in_cluster' to
    sync toolkit with existing cluster.
  5. Add the same IBM Storage Scale Erasure Code Edition candidate nodes and any other nodes that you added previously for functions such as file audit logging to the cluster.
    Note:
    • Designate one of IBM Storage Scale Erasure Code Edition candidate nodes as an admin node.
    • Do not add the EMS node in this part of the configuration.
    # ./spectrumscale node add 198.51.100.1 -a -so
    
    [ INFO ] Setting node1.example.com as an admin node.
    [ INFO  ] Setting node1.example.com as a scale-out node.
    [ INFO  ] Configuration updated.
    
    # ./spectrumscale node add 198.51.100.2 -so
    
    [ INFO  ] Setting node2.example.com as a scale-out node.
    [ INFO  ] Configuration updated
    
    # ./spectrumscale node add 198.51.100.3 -so
    
    [ INFO  ] Setting node3.example.com as a scale-out node.
    [ INFO  ] Configuration updated.
    
    # ./spectrumscale node add 198.51.100.4 -so
    
    [ INFO  ] Setting node4.example.com as a scale-out node.
    [ INFO  ] Configuration updated.
    
    
    # ./spectrumscale node add 198.51.100.5 -so
    
    [ INFO  ] Setting node5.example.com as a scale-out node.
    [ INFO  ] Configuration updated.
    
    # ./spectrumscale node add 198.51.100.6 -so
    
    [ INFO  ] Setting node6.example.com as a scale-out node.
    [ INFO  ] Configuration updated.
    
    Verify the node details.
    # ./spectrumscale node list
    
    [ INFO ] List of nodes in current configuration:
    [ INFO ] [Installer Node]
    [ INFO ] 198.51.100.1
    [ INFO ]
    [ INFO ] [Cluster Details]
    [ INFO ] No cluster name configured
    [ INFO ] Setup Type: Erasure Code Edition
    [ INFO ]
    [ INFO ] [Extended Features]
    [ INFO ] File Audit logging : Disabled
    [ INFO ] Watch folder : Disabled
    [ INFO ] Management GUI : Disabled
    [ INFO ] Performance Monitoring : Disabled
    [ INFO ] Callhome : Enabled
    [ INFO ]
    [ INFO  ] GPFS               Admin  Quorum  Manager   NSD   Protocol  Callhome   Scale-out   OS   Arch
    [ INFO  ] Node                Node   Node     Node   Server   Node    Server      Node                  
    [ INFO  ] node1.example.com    X                                                   X         rhel7  x86_64
    [ INFO  ] node2.example.com                                                        X         rhel7  x86_64
    [ INFO  ] node3.example.com                                                        X         rhel7  x86_64
    [ INFO  ] node4.example.com                                                        X         rhel7  x86_64
    [ INFO  ] node5.example.com                                                        X         rhel7  x86_64
    [ INFO  ] node6.example.com                                                        X         rhel7  x86_64
    
    [ INFO ]
    [ INFO ] [Export IP address]
    [ INFO ] No export IP addresses configured
  6. Do an installation pre-check by using the installation toolkit.
    # ./spectrumscale install -pr
  7. Install the defined IBM Storage Scale Erasure Code Edition configuration by using the installation toolkit.
    # ./spectrumscale install