Offline upgrade with complete cluster shutdown

You can use the following steps for an offline upgrade.

Important: Online upgrade from an unsupported version of IBM Storage Scale or GPFS is not supported. However, you can use the following manual offline upgrade procedure to upgrade to a supported version of IBM Storage Scale.

Stop all file system operations on the cluster and any external access to the cluster. For example, protocol clients.
If you have protocol nodes, then stop all CES operations.
```
mmces stop Protocol -a
```
Unmount all file systems.
```
mmumount all -a
```
Shut down GPFS on all nodes.
```
mmshutdown -a
```
Verify that the GPFS daemon has terminated and that the kernel extensions are unloaded by using mmfsenv -u. If the mmfsenv -u command reports that it cannot unload the kernel extensions because they are busy, then the installation can proceed, but the node must be rebooted after the installation. Kernel extensions are busy means that a process has a current directory in some GPFS file system directory or it has an open file descriptor. The Linux utility lsof can identify the process and that process can then be killed. Retry mmfsenv -u after killing the process and if the command succeeds, then a reboot of the node can be avoided.
Note:
- The mmfsenv -u command is normally used with assistance from support or for cases where its usage is specifically documented such as in this scenario.
- The mmfsenv -u command only checks the local node from which it is run, not all the nodes in the cluster.
Refer to the IBM Storage Scale FAQ in IBM® Documentation for the supported operating system versions that apply to the IBM Storage Scale release that you are upgrading to.
If the operating system needs to be upgraded, then complete that upgrade.
Extract the IBM Storage Scale installation image so that all installation files (rpm, deb, bff, msi, and so on) are available.
Run the necessary platform-specific commands to upgrade GPFS.
- SLES and RHEL Linux®:
```
rpm -Fvh /usr/lpp/mmfs/5.x.y.z/gpfs_rpms/<OS>{gpfs.adv*.rpm,gpfs.base*.rpm,gpfs.crypto*.rpm,
gpfs.docs*.rpm,gpfs.gpl*.rpm,gpfs.gskit*.rpm,gpfs.msg*.rpm,
gpfs.license.XX*.rpm,gpfs.compression*.rpm}
rpm -Fvh /usr/lpp/mmfs/5.x.y.z/zimon_rpms/<OS>{gpfs.gss.pmsensors*.rpm,gpfs.gss.pmcollector*.rpm}
```
  Where <OS> is the operating system specific directory such as rhel7 or sles15.
  - The gpfs-adv and gpfs-crypto packages are available only with IBM Storage Scale Advanced Edition, IBM Storage Scale Data Management Edition, or IBM Storage Scale Developer Edition.
  - Depending on the IBM Storage Scale edition that you are installing, install the appropriate gpfs.license package.
  - IBM Storage Scale Developer Edition is available only on Red Hat Enterprise Linux on x86_64.
- Ubuntu:
```
dpkg -i /usr/lpp/mmfs/5.x.y.z/gpfs_debs/<OS>{gpfs.adv*.deb,gpfs.base*.deb,gpfs.crypto*.deb,
gpfs.docs*.deb,gpfs.gpl*.deb,gpfs.gskit*.deb,gpfs.msg*.deb,
gpfs.license.XX*.deb,gpfs.compression*.deb}

dpkg -i /usr/lpp/mmfs/5.x.y.z/zimon_debs/<OS>{gpfs.gss.pmsensors*.deb,gpfs.gss.pmcollector*.deb}
```
  Where <OS> is the operating system specific directory such as ubuntu18.
  Note:
  - The gpfs-crypto and the gpfs-adv packages are available only with IBM Storage Scale Advanced Edition and IBM Storage Scale Data Management Edition.
  - Depending on the IBM Storage Scale edition that you are installing, install the appropriate gpfs.license package.
- AIX®:
```
installp -agXYd . gpfs
```
- Windows:
  1. Uninstall the version of GPFS or IBM Storage Scale that you are upgrading from and restart.
  2. Uninstall the license of GPFS or IBM Storage Scale version that you are upgrading from.
  3. Uninstall Open Secure Shell for GPFS on Windows, if applicable.
  4. Disable any SUA daemon, such as OpenSSH, that might be configured. Do not uninstall SUA yet, or you may lose GPFS configuration information.
  5. Install the 64-bit version of Cygwin. For more information, see Installing Cygwin.
  6. Install gpfs.base-5.1.x.x-Windows-license.msi.
  7. Install gpfs.base-5.1.x.x-Windows.msi.
  8. Install IBM® GSKit for GPFS.
  9. Uninstall SUA completely.
  10. Configure passwordless SSH in Cygwin for mixed (Linux, AIX, Windows) clusters or use mmwinservctl on a Windows only cluster.
On Linux systems, rebuild the GPFS portability layer (GPL) with the mmbuildgpl command. For more information, see Building the GPFS portability layer on Linux nodes.
Restart GPFS by issuing the mmstartup command and remount file systems by issuing the mmmount command, as necessary. If you have protocol nodes, start the CES operations by issuing the mmces service start Protocol -a command.
Note: At this point, all code is at the upgraded level, but the cluster is not upgraded and new functions cannot be configured until the upgrade is completed.
Complete the upgrade as documented in Completing the upgrade to a new level of IBM Storage Scale.