Upgrading IBM Storage Scale on AWS

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:
```
[root@test-vm1 installer]# ./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>/
```