Manually upgrading the IBM Storage Scale management GUI

You can upgrade the IBM Storage 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 Storage Scale on other nodes to ensure high availability.

Prerequisite

Ensure that you are aware of the following details before you start the upgrade process:
  • The management GUI package must be upgraded after all other required IBM Storage Scale components such as gpfs.base, gpfs.java, or gpfs.gss.pmcollector are successfully updated.
  • If you are upgrading from IBM Storage Scale 5.0.0 or earlier versions and you store your LDAP, AD, or GUI SSL configuration in /opt/ibm/wlp/usr/servers/gpfsgui/server.xml then you need to back up your settings. After the upgrade, recreate your configuration with mkldap for LDAP or AD and with sethttpskeystore for GUI SSL certificates. For more information, see Configuring external authentication for GUI users .
  • 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 Storage 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 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 Storage 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 Storage Scale GUI from 4.2.0.0 or later to the latest version.
Perform the following steps to manually upgrade the management GUI:
  1. Upgrade the GUI package.

    For upgrading the previously installed package, use rpm -Fvh or rpm -Uvh options on RHEL or SLES. 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 upgrading on Ubuntu, use dpkg -i. By issuing the dpkg -s gpfs.gui command, you can check more properties about your management GUI installation. If the status in the command output is install ok installed then the upgrade is performed successfully.

    • On RHEL or SLES, issue the following command:
      rpm -Fvh gpfs.gui-5.2.3-x.noarch.rpm
    • On Ubuntu, issue the following command:
      dpkg -i gpfs.gui_5.2.3-x_all.deb
  2. After installing the packages, you can configure the performance monitoring tools by using the management GUI, if it is required. For more information, see Enabling performance tools in management GUI.
  3. If the minimum release level set for IBM Storage 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 upgrade to a new level of IBM Storage Scale.
  4. Issue the systemctl status gpfsgui command to verify the GUI service status.
  5. Issue the systemctl status pmcollector and systemctl status pmsensors commands to verify the status of the performance tool.

Creating a CSI administrator after new installation or upgrade

The Container Storage Interface (CSI) needs an administrator user in the GUI and REST API user base to manage the CSI Driver for IBM® file storage configuration. These users need to hold the CSI Administrator role. You need to assign this user role manually as no user holds this role by default. The steps that are used to create a user with this role differ depending on upgrade or a new installation scenario.

Adding a group that holds the CSI admin role after system upgrade

The CSI administrator group is created by default when you install the IBM Storage Scale management GUI. If you are upgrading the system from 5.0.3 or earlier, this user group does not get created by default. To create the user group with CSI administrator role, perform the following:

  1. Go to Services > GUI > Groups.
  2. Click Create Group. The Create User Group dialog appears.
  3. Type the name of the user group, for example, csiAdmin, in the User group name field.
  4. Select CSI Administrator from the list of user roles.
  5. Click Create to create the user group with the CSI Administrator user role.

Assigning CSI Administrator user role after new installation or upgrade

For new installations and for upgrades, you must add members to the new group with the CSI Administrator role. If you create a new user, the approach is as follows:
  1. Go to Services > GUI > User
  2. Click Create User. The Create User dialog appears.
  3. Type the name of the user in the Name field.
  4. Select csiAdmin from the list of user groups.
  5. Create a temporary password for the user.
  6. Click Create to complete user creation process.
Alternatively, you can add the existing users to a group by using the Manage Group option that is available in the Actions menu.