NVIDIA UFM Enterprise User Manual v6.22.1

Upgrading UFM Podman Rootless Container

This section provides instructions on how to upgrade UFM Enterprise when running as an unprivileged user (rootless mode).

Note

Important Note:

  • Do not run any of the below commands from /root directory (user commands will fail based on permissions).

    Change directory into /tmp (e.g.) before starting this procedure.

  • Replace the image filename in step 3 with your specific UFM version

Stop the UFM service if it's currently running:

Copy
Copied!
            

systemctl is-active --quiet ufm-enterprise.service && systemctl stop ufm-enterprise.service

Remove existing system directory and recreate necessary directories:

Copy
Copied!
            

rm -rf /opt/ufm/systemd sudo -u ufmadm mkdir -p /opt/ufm/ufm_plugins_data sudo -u ufmadm mkdir -p /opt/ufm/systemd sudo -u ufmadm mkdir -p /opt/ufm/etc/apache2

Load the new UFM container image (replace with your specific image file):

Copy
Copied!
            

sudo -u ufmadm podman load -i <UFM docker img file>

Execute the UFM upgrade process with all necessary volume mounts:

Copy
Copied!
            

sudo -u ufmadm podman run -it --rm --name=ufm_installer \ -v /run/podman-ufm/podman-ufm.sock:/var/run/docker.sock \ -v /opt/ufm/files:/opt/ufm/shared_config_files \ -v /opt/ufm:/installation/ufm_files \ -v /opt/ufm/etc/apache2:/installation/etc/apache2 \ -v /opt/ufm/systemd:/etc/systemd_files/ \ mellanox/ufm-enterprise:latest \ --upgrade --rootless --ufm-user ufmadm --ufm-group ufmadm

Move the updated systemd service file to the system location and reload systemd:

Copy
Copied!
            

mv /opt/ufm/systemd/ufm-enterprise.service /etc/systemd/system/ufm-enterprise.service systemctl daemon-reload

Remove the temporary systemd directory:

Copy
Copied!
            

rm -rf /opt/ufm/systemd

© Copyright 2025, NVIDIA. Last updated on Aug 7, 2025.