UFM-SDN Appliance Common Use Cases

NVIDIA UFM-SDN Appliance User Manual v4.9.0

Box configuration (e.g. interfaces' IP addresses, users, AAA, etc…) should be backed up and restored separately via CLI. For further information, please refer to the UFM®-SDN Command Reference Guide, section System Management.

The following are different UFM data restoration scenarios:

Software Version

Backed Up Data Version

Action Required

1.6

1.6

Restore the backed up data

1.5

1.6

  1. Upgrade the software

  2. Restore the backed up data

1.6

1.5

Contact NVIDIA Mellanox Support

Restoring Data on Standalone Configuration

  1. Stop the UFM server.

    Copy
    Copied!
                

    ufm-appliance > enable ufm-appliance # configure terminal ufm-appliance [ mgmt-sa ] (config) # no ufm start

  2. Restore the backed up UFM data.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ufm configuration import <zip-file> ufm-appliance [ mgmt-sa ] (config) # ufm database import <zip-file>

  3. Start the UFM server.

Restoring Data on High Availability Configuration

To restore the data on the High Availability configuration when only the Standby machine has been replaced:

  1. Stop the UFM server.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-ha-active ] > enable ufm-appliance [ mgmt-ha-active ] # configure terminal ufm-appliance [ mgmt-ha-active ] (config) # no ufm start

  2. Re-configure both Appliances to run in HA configuration. This command is performed on the Active machine.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-ha-active ] (config) # ufm ha configure <peer-IP> <virtual-IP> [interface]

    As a result, the UFM data is synchronized by the DRBD.

  3. Start the UFM server.

To restore the data on the High Availability configuration when both the Standby and the Active machine have been replaced:

  1. Restore the backed up UFM data on one of the machines.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ufm configuration import <zip-file> ufm-appliance [ mgmt-sa ] (config) # ufm database import <zip-file>

  2. Re-configure both Appliances to run in HA configuration. This command is performed on the Active machine.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ufm ha configure <peer-IP> <virtual-IP> [interface]

    As a result, the UFM data is synchronized on the Standby machine by the DRBD.

  3. Start the UFM server.

Warning

The following process backs up the UFM database, and not the Monitoring History database.

To back up the UFM database:

  1. Export the database to a "zip" file.

    Copy
    Copied!
                

    ufm-appliance > enable ufm-appliance # configure terminal ufm-appliance [ mgmt-sa ] (config) # ufm database export

  2. Upload the file to either a USB storage device or an ftp/scp server.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ufm database upload ufm-database-180857.zip scp://mlnx:123456@172.30.3.201/tmp

  1. Export the configuration to a "zip" file.

    Copy
    Copied!
                

    ufm-appliance > enable ufm-appliance # configure terminal ufm-appliance [ mgmt-sa ] (config) # ufm configuration export

  2. Upload the file to either a USB storage device or an ftp/scp server.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ufm configuration upload ufm-config-20121128-180857.zip scp://mlnx:123456@172.30.3.201/tmp

  1. Generate a debug dump file.

    Copy
    Copied!
                

    ufm-appliance > enable ufm-appliance # configure terminal ufm-appliance [ mgmt-sa ] (config) # debug generate dump

  2. Upload the file to either a USB storage device or an ftp/scp server.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # file debug-dump upload sysdump-ufm-appliance-8990b8-20120710-102624.tgz ftp://admin@172.30.3.36/home/admin

UFM®-SDN Appliance supports local and centrally managed users (Using LDAP, RADIUS, TACACS).

UFM®-SDN Appliance has predefined users. For the complete list of users and their roles, please refer to the UFM®-SDN Command Reference Guide, section User Roles (Capabilities).

Creating Local User

  1. Log into the CLI as admin and use the selected password.

  2. Create the users with a specific capability (role).

    Copy
    Copied!
                

    ufm-appliance > enable ufm-appliance # configure terminal ufm-appliance [ mgmt-sa ] (config) # username <username> capability <capability>

  3. Set the user’s password.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # username <username> password <password>

Linking Users to LDAP Server

  1. Create a group for UFM®-SDN Appliance users on the ActiveDirectory server.

  2. Assign users to the group.

  3. [Optional] Add the attribute "localUserName" to the user schema for correlating it to a local username on the UFM®-SDN Appliance (If this attribute is not added, all users will be correlated with the default user – "admin").

  4. Add LDAP as the authentication method.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # aaa authentication login default local ldap

  5. Configure the LDAP server.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # ldap base-dn <string> ufm-appliance [ mgmt-sa ] (config) # ldap bind-dn <string> ufm-appliance [ mgmt-sa ] (config) # ldap bind-password <string> ufm-appliance [ mgmt-sa ] (config) # ldap host <IP Address>

For further information please refer to section "User Management and AAA" of the UFM®-SDN Command Reference Guide.

When logging into the CLI, and a similar upgrade notification as the below is displayed, you need to update your firmware version.

Copy
Copied!
            

$ ssh admin@172.30.30.17 Password: Last login: Sun Feb 24 17:27:59 2013 from 172.30.3.201 Mellanox UFM Appliance UFM is configured as standalone. UFM mode: Management. HCA Firmware: 2.10.600 (Requires update)

To update the HCA firmware version:

  1. Install the updated HCA firmware supplied in the software image.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # firmware install

  2. Reboot the system.

  3. Verify the firmware was updated correctly.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # show firmware Installed firmware version: 2.11.500 Running firmware version: 2.11.500 Image available for installation: 2.11.500

  1. Generate debug dump from both UFM Appliances.

    Copy
    Copied!
                

    ufm-appliance [ mgmt-sa ] (config) # debug generate dump ufm-appliance [ mgmt-sa ] (config) # file debug-dump upload sysdump-ufm-appliance-8990b8-20120710-102624.tgz ftp://admin@172.30.3.36/home/admin

  2. Investigate the root cause of the issue.
    If the root cause related to the UFM License of UFM Configuration you need to perform the following steps:

    1. Look into the debug dump file to recognize the initial primary server (ufm-sysdump-<datetime>.tar.gz ./ufm_sys_conf/haresources).

      Copy
      Copied!
                  

      ufm-appliance-8a447a hb_track_start check_sm 172.30.46.100/16/eth0/172.30.255.255 drbddisk::ufmdb Filesystem::/dev/drbd0::/opt/ufm/files::ext3 ufmd::hamode fix_arp hb_track_end

    2. Disable the UFM High Availability configuration on both appliances.

      Copy
      Copied!
                  

      ufm-appliance [ mgmt-sa ] (config) # no ufm ha

    3. Update the UFM configuration or install the UFM License on the Primary Appliance.

    4. Configure HA on the Primary Appliance.

      Copy
      Copied!
                  

      ufm-appliance [ mgmt-sa ] (config) # ufm ha configure <peer IP> <virtual IP> [interface]

    5. Wait until the mode is changed to "active" on the Primary Appliance and "standby" on the Secondary Appliance.

    6. Verify the DRBD synchronization is completed.

      Copy
      Copied!
                  

      ufm-appliance [ mgmt-sa ] (config) # show ufm status

    7. Start UFM on the Primary Appliance.

      Copy
      Copied!
                  

      ufm-appliance [ mgmt-sa ] (config) # ufm start

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