Upgrading to the Latest SCS Version for CentOS 7

Important

This document is intended to provide upgrading steps for SCS 1.7.1 for CentOS only. If you are planning to migrate from CentOS 7 to Rocky Linux 8, refer to Migrating Swarm Components from CentOS 7 to Rocky Linux 8.

Directly upgrading from SCS 1.2 to SCS 1.3 is not supported, but this limitation is removed starting with SCS 1.4. Swarm supports upgrading from SCS 1.1, 1.2, or 1.3 to SCS 1.4 and booting from Storage bundle v15.0 with multicast disabled.

Upgrade Notes

Any version before SCS 1.4 cannot boot versions of Swarm storage that include the optional multicast feature (version 15.0 and later). This is due to changes required in SCS to support this feature.
Complete the SCS upgrade first if upgrading both SCS and Swarm Storage simultaneously. Then add the new Swarm Storage component to the SCS repo (using scsctl repo component add ...). During this process, scsctl will prompt as to whether or not to enable multicast for the storage cluster by asking to set a value for cip.multicastEnabled. Select True to enable the use of multicast (this matches the behavior of prior versions of Swarm), or False to disable it. If you are unsure which to choose, contact DataCore Support.

Refer to the following steps to upgrade SCS for CentOS 7:

Disable the SELinux.
1. Check if SELinux is enabled or disabled. In a default RL8 installation, it will be Enforcing. However, if it is already disabled, skip to step 2.
  getenforce
2. Disable SELinux, by editing the /etc/selinux/config file, commenting out the line SELINUX=enforcing or SELINUX=permissive, and adding the line SELINUX=disabled. Then reboot the server after saving the file.
  vi /etc/selinux/config ... #SELINUX=enforcing SELINUX=disabled ... reboot
If static IP addresses were previously assigned using instance level node.cfg overrides , this need to be removed prior to upgrading. This procedure is fully explained in Configuring Swarm for Static IPs with Swarm Cluster Services (SCS). Static IPs can be defined using the procedure explained in Configuring Swarm for Static IPs with Swarm Cluster Services (SCS) .
Install the new RPM.
rpm -Uvh swarm-scs-[version].x86_64.rpm
Run the following command.

Note

Refer to the following step if an error occurs during the upgrade_check command:

Run the diagnostics check.
It shows the below output:
Reboot the system.
Re-initialize DHCP.
Choose the SCS version to activate the latest version.

We would need some additional necessary steps to upgrade directly from SCS 1.4 to 1.7.1 under the following conditions:

The current instance is using static IP assignments for storage nodes, using the node.cfg template method.
The storage cluster supported by the current instance is running a version of CAStor that does not support direct IP assignment, a version of CAStor that does not include the setting, “network.useStaticAddresses”.

When these conditions are true, the upgrade process requires additional steps:

After SCS is upgraded to 1.7.1, the storage software must be upgraded to the most recent version or any version that supports direct IP assignment and includes the “network.useStaticAddresses” setting.
After the new storage software version is activated, the storage cluster must be rebooted before any direct IP assignment is performed.

After these additional steps, the direct assignment of static IPs and the unsetting of the node.cfg templates can proceed as usual. The cluster gets rebooted again once that process is completed.

When restarting an entire cluster all at once, verify nodes that were already part of the cluster are restarted first. Once they are fully online, it is safe to boot any new nodes being added into the cluster. Booting these new nodes too early can lead to IP address conflicts, and the new nodes will fail to come online.