NVIDIA UFM-SDN Appliance User Manual v4.14.0
v4.14.0

Topology Compare Tab

The Topology Compare tab allows two methods of topology comparison:

  • Periodic Comparison

  • Custom Comparison

Periodic Comparison

Periodic comparison allows users to compare the current fabric topology with a preset master topology. The master topology may be set either by selecting the current topology or uploading a predefined custom topology.

image2022-4-28_22-46-9.png

When a report is selected from the "Topology Compare Reports" table, its result are displayed on the right side under "Topology Compare Report Details".

  • To update the master topology with the latest (current) topology or a custom topology saved in external file, click the "Updated Master Topology" dropdown button.

    update-master-topology.png

  • To download the current topology as a .topo file, click the "Download Topology" button.

  • The Settings button navigates to the Topology Compare tab of the Settings view which allows users to configure periodic comparison settings.

Custom Comparison

Custom comparison compares user-defined topology with the current fabric topology. UFM compares the current fabric topology to a topology snapshot (of the same setup) and reports any differences between them.

To be able to use the UFM topology comparison mechanism, first you need to create a TOPO file that defines the current topology of the fabric.

Note

Ideally, the topology snapshot (.topo file) should be taken after the setup bring-up phase has been completed so that no more topology changes are expected to take place.

Once the TOPO file is created, you can use the topology comparison mechanism to compare the current fabric topology to the one in the TOPO file and view their differences (if found).

image2022-4-28_22-46-53.png

To compare the current topology with the master topology or a custom topology (external file), make a selection from the "Compare Latest Topology" dropdown button and upload the .topo file to compare against.

To create the topology file for later comparison with the current topology, do the following:

Procedure_Heading_Icon.PNG

  1. Run the following CLI command on UFM Appliance server machine:

    Copy
    Copied!
                

    ufmapl [ mgmt-ha-active ] (config) # ib topo-file generate

    Once command execution is completed, the new topology file will be created. Several .ibnl files that were (optionally) created will also be available in the defined output directory. These .ibnl files will be used when comparing any topology file to the current fabric topology.

  2. Run the following CLI command in order to upload the created topology file (fabric.topo) for later comparison with the current fabric topology:

    Copy
    Copied!
                

    ufmapl [ mgmt-ha-active ] (config) # ib topo-file upload scp://root@192.168.1.200/tmp Password (if required): ******

At any time during your UFM session, you can view the last generated report through the UFM Web UI or in HTML format in a browser window. To perform topology comparison, do the following:

Procedure_Heading_Icon.PNG

  1. Click Run Now Report under System Health à Topology Compare.

    image2019-6-16_14-42-23.png

  2. Browse for the required topology setup file in the Load Topology File dialog box.

    image2019-6-16_14-42-33.png

  3. Click Load.
    UFM will compare topologies and display the results.

    topology-compare-report-view.PNG

© Copyright 2023, NVIDIA. Last updated on Nov 7, 2023.