Upgrading UFM Software

NVIDIA UFM Enterprise Quick Start Guide v6.10.0

After UFM® installation, UFM detects existing UFM versions previously installed on the machine and prompts you to run a clean install of the new version or to upgrade. We recommend backing up the UFM configuration before upgrading the UFM as specified in section UFM Database and Configuration File Backup.

You can upgrade the UFM standalone server software for InfiniBand from the previous UFM version.

To upgrade the UFM server software:

  1. Create a temporary directory (for example /tmp/ufm).

  2. Open the UFM software zip file that you downloaded. The zip file contains the following installation files for:

    • RedHat 7/CentOS 7/OEL 7: ufm-X.X -XXX.el7.x86_64.tgz

    • RedHat 8/CentOS 8/OEL 8: ufm-X.X -XXX.el8.x86_64.tgz

    • Ubuntu 18.04: ufm-X.X -XXX.ubuntu18.x86_64.tgz

    • Ubuntu 20.04: ufm-X.X -XXX.ubuntu20.x86_64.tgz

  3. Extract the installation file for your system's OS to the temporary directory that you created.

  4. Stop the UFM server. Run:

    Copy
    Copied!
                

    /etc/init.d/ufmd stop

  5. From within the temporary directory, run the following command as root:

    Copy
    Copied!
                

    ./upgrade.sh

    Warning

    A configuration backup file will be created in the running directory (e.g. /tmp/ufm). The backup file name is ufm_X.X.X_bkp.zip (X.X.X is the previous version).

    1. Upgrade from the previous version: the existing UFM data and configuration are preserved.

    2. In case upgrade.sh script stops before completion (e.g. missing prerequisite), the upgrade procedure can be resumed by fixing the issue (e.g. installing missing prerequisite) and rerunning ./upgrade.sh again.

  6. Restart the UFM server. Run:

    Copy
    Copied!
                

    systemctl start ufm-enterprise.service

    Warning

    /etc/init.d/ufmd start - Available for backward compatibility.

  7. After the upgrade, remove the temporary directory

You can upgrade the UFM server HA software for InfiniBand from the previous release. The upgrade is performed on both servers.

To upgrade the UFM server software:

  1. Stop UFM HA cluster

    Copy
    Copied!
                

    ufm_ha_cluster stop

  2. Open the UFM software zip file that you downloaded. The zip file contains the following installation files:

    • RedHat 7/CentOS 7/OEL 7: ufm-X.X -XXX.el7.x86_64.tgz

    • RedHat 8/CentOS 8/OEL 8: ufm-X.X -XXX.el8.x86_64.tgz

  3. Extract the installation file for your system's OS to a temporary directory.

  4. From the installation folder, run the following command:

    Copy
    Copied!
                

    ./upgrade.sh

  5. Install the latest UFM HA package. Follow steps 3-5 in Installing UFM Server Software for High Availability.

    Important

    There is no need to configure the UFM HA package after the installation procedure.

  6. After the upgrade, start the UFM HA cluster. Run:

    Copy
    Copied!
                

    ufm_ha_cluster start

You can upgrade the UFM server HA software for InfiniBand from the previous release. The upgrade is performed on both servers.

To upgrade the UFM server software:

  1. Stop UFM HA cluster:

    Copy
    Copied!
                

    master# ufm_ha_cluster stop

  2. Extract the new UFM package:

    Copy
    Copied!
                

    master# tar -xzf ufm-6.10.0-3.ubuntu18.mofed5.tgz

  3. Enter to the installation folder:

    Copy
    Copied!
                

    master# cd /tmp/ufm-6.10.0-3.ubuntu18.mofed5

  4. Run the below command to backup the previous UFM version:

    Copy
    Copied!
                

    master# ./ufm_backup.sh 6.9.1

  5. Move the generated backup file into a temporary folder:

    Copy
    Copied!
                

    master# mv ufm_6.9.1_bkp.zip /tmp/

  6. Run the following command to cleanup the UFM HA cluster on the master node:

    Copy
    Copied!
                

    master# ufm_ha_cluster cleanup

  7. Run the following command to cleanup the UFM HA cluster on the standby node:

    Copy
    Copied!
                

    slave# ufm_ha_cluster cleanup

  8. On the master node, remove the UFM HA indicator file:

    Copy
    Copied!
                

    master# rm -rf /opt/ufm/files/config_ha /opt/ufm/indicators/ufm_ha|| true

  9. On the standby node, remove the UFM HA indicator file:

    Copy
    Copied!
                

    slave# rm -rf /opt/ufm/files/config_ha /opt/ufm/indicators/ufm_ha || true

  10. On the master node, run the following upgrade command

    Copy
    Copied!
                

    master# cd /tmp/ufm-6.10.0-3.ubuntu18.mofed5 && ./upgrade.sh

  11. Wait until the upgrade procedure on the master node is done.

  12. On the standby node, run the following upgrade command:

    Copy
    Copied!
                

    slave# cd /tmp/ufm-6.10.0-3.ubuntu18.mofed5 && ./upgrade.sh

  13. On the master node, run the following command to restore the backup file of the previous version.

    Copy
    Copied!
                

    master# /opt/ufm/scripts/ufm_restore.sh -f /tmp/ufm_6.9.1_bkp.zip -u

  14. On the master node, configure UFM HA. Run:

    Copy
    Copied!
                

    master# configure_ha_nodes.sh --cluster-password 123456 --main-hostname swx-ci-29 --main-ip 10.209.36.143 --main-sync-interface enp5s0f0 --standby-hostname swx-ci-30 --standby-ip 10.209.36.45 --standby-sync-interface enp5s0f0 --virtual-ip 10.209.36.253

  15. Run the following to check the UFM HA cluster status:

    Copy
    Copied!
                

    # ufm_ha_cluster status

  16. The UFM should be up and running in HA configuration.

© Copyright 2023, NVIDIA. Last updated on Sep 5, 2023.