Upgrading IBM Storage Scale

Follow these steps to upgrade your version of IBM Storage Scale.

Download the latest IBM Storage Scale Data Management Bundle from IBM® Fix Central and upload it to the IBM Storage Scale EC2 controller node.
Note: All these steps must be run on the controller node.
Run the following script to extract IBM Storage Scale Data Management Bundle:
```
< Path_of_bundle> --silent
```
Go to the IBM Storage Scale installation toolkit directory.
Note: The IBM Storage Scale installation toolkit is used to upgrade the cluster to the wanted IBM Storage Scale version. For more information, see Upgrading IBM Spectrum® Scale components with the installation toolkit section in the IBM Storage Scale: Concepts, Planning, and Installation Guide.

Specify the newly created modified id_rsa key during the following installation toolkit setup command:

 cd /usr/lpp/mmfs/{{ scale_version }}/ansible_toolkit; ./spectrumscale setup -s <controller_node_ip>

Run the config populate command:
```
./spectrumscale config populate -N <node>
```
Note: The node is the IP address or hostname of any storage node.
Run the setup command again:
```
./spectrumscale setup -s <controller_node_ip>
```
Note: The setup command is run as the config populate command overrides the id_rsa key configuration if the -i option is not specified.
Run the following command to export the flag for SNC:
```
export SS_SNC_ROLLING_UPGRADE=true
```

Run the following upgrade commands:


 ./spectrumscale upgrade precheck
./spectrumscale upgrade run

Run the following command to create a new directory on the controller node that can be used to store all IBM Storage Scale packages for further use after IBM Storage Scale is upgraded:
```
mkdir -p /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>
```

Go to the gpfs_rpms package directory of the upgraded IBM Storage Scale, and copy the following packages to the directory created in step 9.

cd /usr/lpp/mmfs/{{ scale_version }}/gpfs_rpms
cp gpfs.adv* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.base* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.crypto* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.docs* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.gpl* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.gskit* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.gui* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.crypto* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.java* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.license.dm* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.msg.en_US* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/

Go to the zimon_rpms package directory of the upgraded IBM Storage Scale, and copy the following packages to the directory created in step 9:

cd /usr/lpp/mmfs/{{ scale_version }}/zimon_rpms/rhel7/
cp gpfs.pmcollector* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.pmsensors* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/

cd /usr/lpp/mmfs/{{ scale_version }}/zimon_rpms/rhel8/
cp gpfs.pmcollector* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
cp gpfs.pmsensors* /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/

Note: After you upgrade the IBM Storage Scale cluster, any mmcloudworkflows commands must be run only after the following environment variables are set:

export SPECTRUM_SCALE_PACKAGE_LOC= <Location of the IBM Spectrum Scale packages created in step 9)
For example: export SPECTRUM_SCALE_PACKAGE_LOC=/opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/

Go to the /usr/lpp/mmfs/<scale_version>/Public_Keys package directory of the upgraded IBM Storage Scale, and copy the following packages to the directory created in step 9:
```
cd /usr/lpp/mmfs/<scale_version>/Public_Keys 
cp SpectrumScalepublic_key.pgp /opt/IBM/<scale version>/gpfs_cloud_packages_<scale version>/
```

For the instructions to use the installation toolkit to do an upgrade of almost all IBM Storage Scale components from the current version of IBM Storage Scale to the wanted version, see Upgrading IBM Storage Scale components with the installation toolkit.