Manually upgrading the IBM Spectrum Scale management GUI

You can upgrade the IBM Spectrum Scale™ management GUI to the latest version to get the latest features. You can upgrade one GUI node at a time without shutting down IBM Spectrum Scale on other nodes to ensure high availability.

Prerequisite

Ensure that you are aware of the following details before you start the upgrade process:

Upgrading the GUI from previous release to the latest release overwrites the customizations that are made in the property file that is located at: /usr/lpp/mmfs/gui/conf/gpfsgui.properties. It is recommended to take backup of the property file to save all such customizations before you upgrade the GUI. If sudo wrappers are in use, the GPFS_ADMIN attribute in the gpfsgui.properties file must be set again after you upgrade the GUI to 4.2.2 or 4.2.3.
If an external authentication server, such as AD or LDAP, is used to authenticate the GUI users, connections to AD and LDAP systems are stored in the /opt/ibm/wlp/usr/servers/gpfsgui/server.xml file. This file is overwritten during the upgrade. Ensure that you save the edited server.xml file to make the similar changes on the replaced file after the upgrade.
Local users, user groups, user roles, and snapshot rules are not affected with an upgrade, because they exist in the cluster configure repository (CCR).
Data in the postgres database is retained.
All IBM Spectrum Scale packages must be of the same release on the GUI node. For example, do not mix the 4.2.3 GUI rpm with a 4.2.2 base rpm. However, GUI PTFs and fixes can usually be applied without having to install the corresponding PTF or fix of the base package. This method is helpful if you just want to resolve a GUI issue without changing anything on the base layer
Release levels can be different in GUI nodes and other nodes of the cluster. However, the minimum release level of the cluster must be 4.2.0.0 or later for the GUI to function.
The user ID "scalemgmt" must not be already used as the GUI requires this user ID to run IBM Spectrum Scale GUI Websphere Java™ process.
The ports 80, 443, 474080, and 47443 must not be already used by other processes.
You can directly upgrade the IBM Spectrum Scale GUI from 4.2.0.0 or later to the latest version.

Perform the following steps to upgrade the management GUI from 4.2.1.x or later to 4.2.2.x or later:

Stop the GUI services on the node by issuing the systemctl stop gpfsgui command.
Ensure that the latest packages are available at the required location. For more information on the latest packages that are required for different platforms, see Manually installing IBM Spectrum Scale management GUI.
For information about the location of extracted installation images, see Location of extracted packages.
Upgrade the GUI package. For upgrading the previously installed package, use rpm -Fvh or rpm -Uvh options. The rpm -Fvh is used for upgrading the existing installed package and rpm -Uvh is used for installing the package and upgrading the package as well.
For example: rpm -Fvh gpfs.gui-4.2.3-0.noarch.rpm
If there is a Java version upgrade, upgrade the Java package as shown in the following example:
```
rpm -Fvh gpfs.java-4.2.3-0.x86_64.rpm
```
Note: If you are upgrading the GUI (gpfs.gui) package, the GPFS™ Java (gpfs.java) package must also be upgraded to the same version.
Java packages are platform-dependent. For more information on the latest Java package that is required for each platform, see Manually installing IBM Spectrum Scale management GUI.
After installing the packages, enable the performance monitoring tools in the GUI, if it is required. For more information, see Enabling performance tools in management GUI.
If the minimum release level set for IBM Spectrum Scale is not same as the GUI version, change the release level by issuing the mmchconfig release=LATEST command. As changing the minimum release level affects the cluster behavior, refer the mmchconfig command man page and other related topics before you make this configuration change. For more information, see Completing the migration to a new level of IBM Spectrum Scale.
Start the GUI by issuing the systemctl start gpfsgui command.
To make sure that the GUI and performance tool are started on the boot process, issue the following commands:
```
systemctl enable gpfsgui.service
systemctl enable pmsensors.service
systemctl enable pmcollector.service
```
Issue the systemctl status gpfsgui command to verify the GUI service status.
Issue the systemctl status pmcollector and systemctl status pmsensors commands to verify the status of the performance tool.