Upgrade Ubuntu on the XCO Host - Single Node or Multi Node

Upgrade Ubuntu in single-node and multi-node deployments.

Before you begin

Ensure that XCO is at release 3.2.0 or later.
Ensure that the nodes are healthy and 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.

Follow this procedure to Upgrade Ubuntu from 18.04 to 20.04.

Note

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

Procedure

If you already have XCO running on Ubuntu 18.04, take a backup of XCO.

For more information on XCO backup, see Backup Database.

$ efa system backup
Generating backup of EFA...
Backup Location: /var/log/efa/backup/EFA-3.2.0-GA-2023-03-23T13-25-55.105.tar
--- Time Elapsed: 37.543063336s ---

Copy the generated backup archive to a remote server.
Uninstall XCO.
For more information, see Uninstall XCO in a Single-Node or Multi-Node Deployment.
Run the following command to ensure that there are no packages on hold:
```
# apt-mark showhold
```
To un-hold the packages, run the following command.
```
# sudo apt-mark unhold <package-name>
```
Update the Ubuntu package, and then update all the Ubuntu packages on all the available nodes.
If needed, perform reboot after the update.
```
# sudo apt update && sudo apt upgrade -y
```
Upgrade the Ubuntu package on all the available nodes.
Verify that the nodes are at the new version by running the cat /etc/os-release command.
```
# sudo do-release-upgrade
```

Verify that the nodes are at the new version by running the cat /etc/os-release command.

# cat /etc/os-release 
NAME="Ubuntu"
VERSION="20.04.6 LTS (Focal Fossa)"
ID=ubuntu
ID_LIKE=debian
PRETTY_NAME="Ubuntu 20.04.6 LTS"
VERSION_ID="20.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=focal
UBUNTU_CODENAME=focal

Install XCO 3.2.0 in a single-node server or multi-node cluster.
Copy the backup to the /var/log/efa/backup/ directory in the local system.

Run the following restore command:

For more information on XCO restore, see Restore Database

# efa system restore 

1. EFA-3.2.0-GA-2023-03-23T13-25-55.105.tar (Version:3.2.0-GA, Generated by: user) 

Choose backup option:1 
Selected:  EFA-3.2.0-GA-2023-03-23T13-25-55.105.tar
Performing EFA restore using  EFA-3.2.0-GA-2023-03-23T13-25-55.105.tar
Restore operation ID: 4a861b2c-c971-11ed-b7fd-000c292bbb0e
Stopping all EFA services...
All pods are terminated
Restoring databases...
Restore of encryption keys is completed
Restore operation is successful
--- Time Elapsed: 4m33.591911082s ---

When the restore is complete, run source /etc/profile.
You can now log in to XCO.
To enable secure connections, install the certificates on devices.
```
efa certificate device install --ip 10.20.61.92 --cert-type https
```
The command installs the HTTPS or OAuth2 certificate on one or more devices.
To get the current state of the devices, run the efa inventory device update command after you run the restore command.

Verify that XCO is up and running. 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)