Upgrading to the Latest SCS Version

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 properly 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.
Installing a new Swarm Storage component version does not automatically activate the version for PXE booting; the new version must be explicitly activated. Run the below command and choose the new version to activate:
```
scsctl storage software activate
```

Refer to the following steps to upgrade SCS:

Install the new RPM.
```
rpm -Uvh swarm-scs-[version].x86_64.rpm
```
Run the following command.
```
scsctl diagnostics upgrade_check
```

Run the diagnostics check.

scsctl diagnostics config scan_missing

It shows the below output:

Running step [11/11]: Show the next steps after this wizard
  ********************************************************************************
  Congratulations, your Swarm Cluster Services server has been upgraded!
  Please reboot, then run the following to ensure your system is fully configured:

Reboot the system.
Re-initialize DHCP:

scsctl init dhcp --dhcp-reserve-lower [integer]

Troubleshooting Notes

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

systemctl restart swarm-platform && sleep 90

```
scsctl platform software activate
```
Choose the version that matches the recently installed RPM.
Proceed with re-initializing DHCP as listed above.

Info

A customer might see the below error in the output while upgrading to SCS 1.7 or above, but this is safe to ignore it.

Running step [4/11]: Re-enable systemd management of SCS Linux services
  Disabling service "swarm-platform.service" for pod "swarm-platform"...
  Failed to disable services: b'Failed to execute operation: No such file or directory\n'
  Deleting service file for pod "swarm-platform": /etc/systemd/system/swarm-platform.service [exists: False, symlink: True]
  Retry: Disabling service "swarm-platform.service" for pod "swarm-platform"...