Upgrade Ubuntu on the XCO Host - Multi-Node

Upgrade Ubuntu in multi-node deployments.

Before you begin

Ensure that you XCO 3.2.0 is up and running.
Ensure that the nodes are healthy and the XCO services are up and running.

About this task

XCO is supported on Ubuntu 16.04, 18.04, and 20.04 as described in Supported Platforms and Deployment Models for Fabric Skill. You can upgrade from 16.04 to 18.04 and 18.04 to 20.04 while XCO is installed.

Note

This process is not supported for deployments of XCO on TPVM. For TPVM upgrade, see Upgrading SLX-OS, TPVM, and XCO Together, TPVM Complete Package Upgrade, and TPVM Incremental Upgrade.
Ensure that the node you are upgrading is connected to the internet. The Ubuntu Release Notes indicate that there is no offline upgrade option.

Procedure

Update the Ubuntu package database, and then upgrade all Ubuntu packages for standalone deployments.
```
sudo apt update && sudo apt upgrade -y
```
To upgrade Ubuntu in a two-node cluster, take the following steps.
1. Run the following command to install the packages that have been kept back:
  Ensure that you complete this step one after the other for all the packages that have been kept back.
```
sudo apt-get upgrade <package-name>
```
2. Upgrade one node in the cluster and reboot the system. Preferably, the standby node.
```
# sudo do-release-upgrade
```
  If you run the upgrade on an active node, then failover to the standby node occurs. XCO is not operational during the failover.
  Both the nodes must have the sudo apt update and sudo apt upgrade -y command present.
3. Upgrade the second node using the same procedure as used on the first node of the cluster.
  Note
  If an upgrade fails due to dependencies, run the following command to upgrade all the dependencies at a time:
  sudo apt-get upgrade <package1> <package2> <package3> ........
4. Verify that the nodes are at the new version by running uname -a and cat /etc/os-release command.
```
device$ uname -a
Linux xco-101-93 4.15.0-194-generic #205-Ubuntu SMP Fri Sep 16 19:49:27 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux
device$ cat /etc/os-release 
NAME="Ubuntu"
VERSION="20.04 LTS (Bionic Beaver)"
ID=ubuntu
ID_LIKE=debian
PRETTY_NAME="Ubuntu 18.04.6 LTS"
VERSION_ID="18.04"
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
VERSION_CODENAME=bionic
UBUNTU_CODENAME=bionic
```
5. Verify that XCO is operational. Perform the following (from the XCO command line) on both nodes.
  - Run efa status to verify that both nodes are up.
  - Run sudo efactl status to verify that all pods on the active node are in Running state.
  - Run sudo efactl db-status to verify that the MariaDB is active (running).