Upgrading object packages to IBM Storage Scale 5.1.8 or earlier by using the installation toolkit

Important:
  • CES Swift Object protocol feature is not supported from IBM Storage Scale 5.2.0 onwards.
  • IBM Storage Scale 5.1.8 is the last release that has CES Swift Object protocol.
  • IBM Storage Scale 5.2.0 will tolerate the update of a CES node from IBM Storage Scale 5.1.8.
    • Tolerate means:
      • The CES node will be updated to 5.2.0.
      • Swift Object support will not be updated as part of the 5.2.0 update.
      • You may continue to use the version of Swift Object protocol that was provided in IBM Storage Scale 5.1.8 on the CES 5.2.0 node.
      • IBM will provide usage and known defect support for the version of Swift Object that was provided in IBM Storage Scale 5.1.8 until you migrate to a supported object solution that IBM Storage Scale provides.
  • Please contact IBM for further details and migration planning.
Note: Object packages from IBM Storage Scale version 5.0.x cannot be directly upgraded to IBM Storage Scale version 5.1.9. Before upgrading to the IBM Storage Scale version 5.1.9, you must update the object packages to IBM Storage Scale version 5.1.8 or an earlier version. After the upgrade to IBM Storage Scale version 5.1.8 or earlier is complete, you can attempt the upgrade to IBM Storage Scale version 5.1.9.

Upgrading object packages from IBM Storage Scale version 5.0.x to IBM Storage Scale versions 5.1.0.x through 5.1.8.x by using the installation toolkit requires certain extra steps because the object protocol is not supported on Red Hat Enterprise Linux® 7.x.

In IBM Storage Scale versions 5.1.0.x through 5.1.8.x, the object protocol is supported only on Red Hat Enterprise Linux 8.x. Therefore, object upgrade from IBM Storage Scale version 5.0.x involves a system upgrade from Red Hat Enterprise Linux 7.x to 8.x along with upgrade to IBM Storage Scale versions 5.1.0.x through 5.1.8.x.

The object protocol in IBM Storage Scale 5.1.2.0 and earlier 5.1.x releases requires the OpenStack installation repositories to be available on the protocol nodes to resolve the necessary dependencies. Before beginning the upgrade, ensure that the systems have access to the OpenStack packages. Red Hat Enterprise Linux systems with the Red Hat OpenStack Platform subscription can get the packages from the subscription manager. The packages are also available through publicly accessible repositories, which are described in OpenStack packages for RHEL and CentOS on the OpenStack documentation website.

Do the following steps for upgrading object packages from IBM Storage Scale version 5.0.x to IBM Storage Scale versions 5.1.0.x through 5.1.8.x by using the installation toolkit. Because the object upgrade must be done in the offline mode, all protocol services are down during the duration of this process.

  1. Stop all object services on all protocol nodes by running the following command from one of the protocol nodes. 
    mmces service stop obj -a
  2. Clean up object-related packages on each node by using Instructions for removing object protocol packages when upgrading protocol nodes to Red Hat Enterprise Linux 8.x.
  3. Use leapp upgrade to upgrade from Red Hat Enterprise Linux 7.x to 8.x on each node. For more information, see Upgrading from RHEL 7 to RHEL 8 on the Red Hat documentation website.

The Object protocol in IBM Storage Scale 5.1.2.0 and earlier 5.1.x releases requires OpenStack 16 repositories to be available on all protocol nodes to satisfy the necessary dependencies. For more information about how to set up these repositories, see OpenStack repository configuration required by the object protocol.

Note: The protocol nodes need to be upgraded in the offline mode.

  1. Proceed with the offline upgrade by using the installation toolkit according to the instructions in Performing offline upgrade or excluding nodes from upgrade by using installation toolkit.
    Note: When suspending the protocol nodes as part of the offline upgrade, it is expected to see error messages about missing OpenStack commands.
  2. After the upgrade is completed, start IBM Storage Scale on the protocol nodes and resume these nodes by using the following commands. 
    mmstartup -N ProtocolNodes
mmces node resume -N ProtocolNodes
  3. Migrate the object protocol configuration to the latest version by running the following command from a protocol node. 
    mmobj config manage --version-sync
  4. Restart the object protocol by running the following commands. 
    mmces service stop OBJ -a
mmces service start OBJ -a