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.



  1. Update the Ubuntu package database, and then upgrade all Ubuntu packages for standalone deployments.
    sudo apt update && sudo apt update -y
  2. 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 
      VERSION="18.04.6 LTS (Bionic Beaver)"
      PRETTY_NAME="Ubuntu 18.04.6 LTS"
    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)