NVIDIA UFM Enterprise Appliance Software User Manual v1.10.1

Appendix - Migrating UFM-SDN Appliance Data to UFM Enterprise Appliance

This procedure is based on the UFM data backup/restore mechanism and will be performed via CLI commands.

Please refer for the command syntax.

  • Minimum UFM Enterprise Appliance version: 1.9.0

  • Minimum UFM tools plugin version: 1.0.0-6

Follow the instructions to backup UFM data on UFM-SDN Appliance:

  1. [On Master] Backup the UFM data to a ZIP file. Run:

    Copy
    Copied!
                

    ufm data backup ufm2-backup-<site name>.zip

  2. [On Master] Upload the UFM Data (ZIP file) to a remote server

    Copy
    Copied!
                

    ufm data upload ufm2-backup-<site name>.zip scp://username:password@hostname/path

The following actions need to be performed prior to UFM data restoration,

  1. Connect the appliances to the fabric and set initial network configuration (e.g., IP addresses, default gateway, hostname, DNS, NTP, etc…) via a serial console or a remote console.

  2. Configure the appliances to run in HA (High-Availability) mode.

  3. Load any UFM plugin Docker image that was deployed on the UFM-SDN Appliance cluster. The UFM plugins’ configuration will be restored as part of the UFM data restore.

    1. [On Master and Standby] Fetch the image from a remote server

      Copy
      Copied!
                  

      image fetch scp://username:password@hostname/path/to/image 

    1. [On Master and Standby] Load the Docker image

      Copy
      Copied!
                  

      docker load <ufm plugin image>

  1. [On Master] Fetch the UFM Data backup (ZIP file) from the remote server:

    Copy
    Copied!
                

    ufm data fetch scp://username:password@hostname/path/to/ufm2-backup-<site name>.zip 

  2. [On Mater] Restore the UFM Data from the ZIP file:

    Copy
    Copied!
                

    ufm data restore ufm2-backup-<site name>.zip [with-upgrade] 

    Note

    Note: The command argument “with-upgrade” is needed if the UFM version on UFM Enterprise Appliance is newer than the one on UFM-SDN Appliance. As a result, the UFM data is upgraded.

Once UFM data migration is completed successfully, some settings need to be modified via the NVP tool, to align with the UFM Enterprise Appliance. Then, stop the UFM-SDN Appliance cluster and start the UFM Enterprise Appliance cluster.

  1. [On UFM Enterprise Appliance Master] Modify UFM settings to fit the UFM3 cluster:

    Copy
    Copied!
                

    ufm migrate-ufm2-to-ufm3 

    For more information, refer to ufm migrate-ufm2-to-ufm3

  2. [On UFM Enterprise Appliance Master] Set the UFM3 HA nodes :

    Copy
    Copied!
                

    ufm ha-nodes <master hostname> <standby hostname> 

  3. [On UFM-SDN Appliance Master] Stop UFM:

    Copy
    Copied!
                

    no ufm start 

  4. [On UFM Enterprise Appliance Master] Start UFM:

    Copy
    Copied!
                

    ufm start 

  5. [On UFM Enterprise Appliance Master] Verify that UFM is up and running:

    Copy
    Copied!
                

    show ufm status 

  6. [On UFM Enterprise Appliance Master and Standby] collect a system dump and upload it to a remote server:

    Copy
    Copied!
                

    debug generate dump  file debug-dump upload latest scp://username:password@hostname/path 

© Copyright 2025, NVIDIA. Last updated on Mar 3, 2025.