Upgrading object packages

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.

Attention:

All protocol nodes must be upgraded to the newer code level along with the base GPFS.
The object storage packages on all protocol nodes must be upgraded to the same level at the same time.
Online upgrade of the object protocol is not supported because of changes that make it incompatible with servers that are running on the previous level. The upgrade must be scheduled at a time when downtime is appropriate.
If you are upgrading from an IBM Storage Scale version earlier than 5.1.x and the node operating system version is earlier than Red Hat® Enterprise Linux® 8.x, the nodes need to be upgraded to Red Hat Enterprise Linux 8.x during the upgrade. For more information, see Instructions for removing object protocol packages when upgrading protocol nodes to Red Hat Enterprise Linux 8.x.
The object protocol is not supported in IBM Storage Scale 5.1.0.0. If you want to deploy object, upgrade to the IBM Storage Scale 5.1.0.1 or a later release.

From one of the protocol nodes, run the following command to stop all object services on all protocol nodes:
```
mmces service stop obj -a
```
On all protocol nodes, update the spectrum-scale-object package to the newer version as follows:
- Use the yum command to update spectrum-scale-object on Red Hat Enterprise Linux.
  1. If needed, set up a yum repository for object packages by creating a new file in /etc/yum.repos.d, such as /etc/yum.repos.d/gpfs_object.repo, with the following content:
```
[gpfs_object]
name=gpfs_object
baseurl=file:///usr/lpp/mmfs/VERSION/object_rpms/rhel8
enabled=1
gpgcheck=0
```
    Make sure that the path in the baseurl property corresponds to the path to the newer object packages on the system.
  2. 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 information on how to set up these repositories, see OpenStack repository configuration required by the object protocol.
  3. After the repository is set up, run the following command to update the spectrum-scale-object package:
```
yum upgrade -y spectrum-scale-object
```
  4. Repeat these steps on each protocol node to update the spectrum-scale-object package on all protocol nodes to the newer version.
  5. If a repository file in /etc/yum.repos.d is created in a preceding step, remove the file after the upgrade completes.

Migrate the existing object protocol configuration to be consistent with the level of installed packages after you upgrade all protocol nodes to the newer version of the spectrum-scale-object package.

Note: Use the following command to find the list of configured protocol nodes:

mmlsnode -N CESNodes

From one of the protocol nodes, run the following command:
```
mmobj config manage --version-sync
```
This command needs to be issued only one time in the cluster to update the configuration on all protocol nodes.
Run the following command to start object protocol-related services on all protocol nodes:
```
mmces service start obj -a
```