Upgrade Ubuntu on the EFA Host - Multi-Node

Upgrade Ubuntu in multi-node deployments.

Before you begin

Ensure that EFA is at release 3.1.0 or later. Upgrade if necessary. For more information, see EFA Upgrade.

Ensure that the nodes you want to upgrade are healthy and that EFA services are operating.

About this task

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

Note

This process is not supported for deployments of EFA on TPVM. For TPVM upgrade, see Upgrading SLX-OS, TPVM, and EFA Together, 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

Update the Ubuntu package database, and then upgrade all Ubuntu packages for standalone deployments.
```
sudo apt update && sudo apt update -y
```
To upgrade Ubuntu in a two-node cluster, take the following steps.
1. Upgrade one node in the cluster and reboot the system. Preferably, the standby node.
```
# sudo do-release-upgrade
```
  If you run the upgrade on the active node, then failover to the standby node occurs. EFA is not operational during the failover.
  Both the nodes must have the sudo apt update and sudo apt upgrade -y step present.
2. Upgrade the second node using the same procedure as used on the first node of the cluster.
3. Verify that the nodes are at the new version by executing uname -a and cat /etc/os-release.
```
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="18.04.6 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
```
4. Verify that EFA is operational. Perform the following (from the EFA 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)