Preparing a Utility Node

These instructions outline the steps to deploy systems with protocols from an x86 Utility Node management server.

The hostnames that are used in this procedure are only examples.

Table 1. Supported configurations
Management server	Supported nodes
IBM® Storage Scale System Utility Node	IBM Storage Scale System 3000 nodes IBM Storage Scale System 3200 nodes IBM Storage Scale System 3500 nodes IBM Storage Scale System 5000 nodes IBM Storage Scale System 6000 nodes IBM Storage Scale System Utility Node management server IBM Power9 management server IBM Power9 protocol node IBM Storage Scale System 3500 protocol node (virtual machine) IBM Storage Scale System Utility Node protocol node
IBM Power9 management server	IBM Storage Scale System 3000 nodes IBM Storage Scale System 3200 nodes IBM Storage Scale System 3500 nodes IBM Storage Scale System 5000 nodes IBM Power9 management server IBM Power9 protocol node IBM Storage Scale System 3500 protocol node (virtual machine)
Bring your own management server (BYOMS)	IBM Storage Scale System 3500 nodes IBM Storage Scale System 3500 protocol node (virtual machine) BYOMS (virtual machine)

The following flow contains high-level steps to deploy the Utility Node management server, single IBM Storage Scale System 3500 building-block, and single Utility Node Protocol Node.

Attention: Check Troubleshooting before you start the deployment.

Corroborate that the SSR completed the installation (racking, cabling, software updates, hardware checkout).
To download the EMSVM-23E.qcow2.xz image:
1. Go to IBM Fix Central, select the IBM Storage Scale System product and version, and click Continue.
2. To download the package, click the Scale_System_VM-<x.x.x.x>-x86_64-UTILITY-EMS.tgz file link.
3. Go to /serv and extract the Scale_System_VM-<x.x.x.x>-x86_64-UTILITY-EMS.tgz file. This .tgz file contains the /emsvm/EMSVM-23E.qcow2.xz file and the checksum file.
To download the deployment tool of the management server virtual machine:
1. Go to https://github.com/IBM/EMSVM.
2. Click Code (green button).
3. Click Download ZIP.
Download the x86 container image from IBM Fix Central. Select the IBM Storage Scale System product and version, click Continue > Unified License > Scale_System_Unified-6.2.3.0-EMS.
Download the IBM Storage Scale installation toolkit (DAE or DME) from IBM Storage Scale.
Copy all downloaded software to the /serv directory on the Utility Node host of the management server virtual machine.
Extract the EMSVM script package in the /serv directory.

Check the Utility Node.

cd /serv/EMSVM-main ; ./emsvm --check-host

Start the Utility Node.
```
./emsvm --start-EMS
```
Connect to the Utility Node.
```
./emsvm --connect-EMS
```
Press Enter and log in to the Utility Node VM (root/ibmesscluster) and change the password when prompted.
Configure the network, such as management, BMC, and campus IPs by the SSR tool.
1. Type ess_ssr_setup and press Enter.
2. Follow the instructions that are displayed in system output.
Exit the console and go back to the host. By using the SFTP, transfer the x86 container to the VM (/home/deploy) over the virtual bridge IP (10.23.16.2).

Note: The virtual bridge is not always the same; it varies from 10.23.16.2 to 10.23.16.6.
Complete the following substeps in the Utility Node VM.
1. Set up /etc/hosts, and ensure that /etc/hosts contains the following items:
  - Utility Node VM (management and high speed)
  - I/O nodes (management and high speed)
  - Protocol node VM (management and high speed)
  - Protocol node host (management)
  - CES IPS
2. Set the fully qualified domain name (FQDN).
```
hostnamectl hostname <FQDN>
```
  FQDN must include complete domain name, for example, server.test.net.
3. Decompress the package.
```
cd /home/deploy ; xz --decompress <xz package>
```
4. Uncompress the compressed tarball.
```
tar xvf <uncompressed tarball>
```
To access the container and complete its deployment configuration, follow the next substeps.
1. Run the following command with the newly untarred binary file.
```
sh <untarred binary file>
```
  This substep takes you to the container.
  Note: When you start the container, delete the existing inventory file so that a new inventory file is generated. Because starting from the 7.0.1.x release, the VM and Utility Node are updated simultaneously. If an inventory file is not properly created, the VM and Utility Node upgrade does not complete successfully.
2. Load the configuration by running the following command, which determines the node information based on vital product data (VPD) and exchanges the SSH keys.
```
essrun -N utilityBareMetal config load
```
  utilityBareMetal specifies an x86 Utility Node management server.
  Check the configuration.
```
essrun -N MSVM,<IOnode1>,<IOnode2> config load -p
```
  -p requests the password that is used for root login to the nodes. For more information, see essrun command in the IBM Storage Scale Systems Command Reference.
3. Check the nodes.
```
essrun -N utilityBareMetal,MSVM,<IOnode1>,<IOnode2> update --precheck
```
4. To exit the container, type exit.
  
  Or, to detach from the container, press Ctrl+p, then press Ctrl+q.
Shut down the VM.
```
shutdown -h now
```
Reboot the Utility Node host.
```
systemctl reboot
```
Use ssh to get back to the management server host.

Start the management server.

cd /serv/EMSVM-main ; ./emsvm --start-EMS

Use ssh to access to the management server VM.
In the management server VM, go to the extracted deployment directory.
```
cd /home/deploy/<extracted .dir>
```
Restart the container.
```
./essmkyml --restart
```

Check the nodes.

essrun -N utilityBareMetal,MSVM,<IOnode1>,<IOnode2> update --precheck