NVIDIA UFM Enterprise User Manual v6.16.0
NVIDIA UFM Enterprise User Manual v6.16.0

Appendix - Switch Grouping

To facilitate the logical grouping of 1U switches into a "director-like switch" group, the UFM implements a special dedicated group of interconnected 1U switches based on a YAML configuration file. This group, which is of type "superswitch", only includes 1U switches connected to each other, with some functioning as lines and others as spines.

To access the configuration file for superswitches, users can define the path in the [SubnetManager] section of the gv.cfg file, using the variable name "super_switch_config_file_path". For instance, the path can be specified as follows: super_switch_config_file_path=/opt/ufm/files/conf/super_switches_configuration.cfg.

It is important to note that the file must be located in the /opt/ufm/files file tree, as it should be replicated between master and slave UFM servers in a high-availability configuration.

The structure of the superswitch definition should be as follows, based on the following example:

Copy
Copied!
            

superswitch: - name: "Marlin01" # Director switch name    description: "primary dc switch" # Free text with the customer facing description    location: "US, NC, DC01" # Director switch location (global location, includes all racks/switches)    racks: # Director switch Racks definitions      #Rack definition      - name: "rack A" # Director switch rack name        location:          dc-grid-row: "A" # formalized rack location in DC          dc-grid-column: "1" # formalized          comments: "left-most rack in the line" #Cutomer facing commnent on the rack        leafs: # List of Director switch leafs (for the rack specified)          - guid: "0x043f720300922a00" #required filed. Switch GUID.            location-u: 1 # required field. Device location in rack: "U#"            description: "MF0;gorilla-01:MQM9700/U1" # optional field.          - guid: "0x043f720300899cc0" #required filed. Switch GUID.            location-u: XX # required field. Device location in rack: "U#"            description: "MF0;gorilla-01:MQM9700/U2" # optional field.        spines: # List of Director switch spines (for the rack specified)          - guid: "0x043f720900922a00" #required filed. Switch GUID.            location-u: 10 # required field. Device location in rack: "U#"            description: "MF0;gorilla-02:MQM9700/U1" # optional field.          - guid: "0x043f720900899cc0" #required filed. Switch GUID.            location-u: XX # required field. Device location in rack: "U#"            description: "MF0;gorilla-02:MQM9700/U2" # optional field. - name: "Marlin02" # Director switch name    description: "primary dc switch" # Free text with the customer facing description    location: "US, NC, DC01" # Director switch location (global location, includes all racks/switches)    racks: # Director switch Racks definitions      #Rack definition      - name: "rack B" # Director switch rack name        location:          dc-grid-row: "B" # formalized rack location in DC          dc-grid-column: "1" # formalized          comments: "left-most rack in the line" #Cutomer facing commnent on the rack        leafs: # List of Director switch leafs (for the rack specified)          - guid: "0x093f720300922a00" #required filed. Switch GUID.            location-u: 1 # required field. Device location in rack: "U#"            description: "MF0;gorilla-03:MQM9700/U1" # optional field.          - guid: "0x093f720300899cc0" #required filed. Switch GUID.            location-u: XX # required field. Device location in rack: "U#"            description: "MF0;gorilla-03:MQM9700/U2" # optional field.        spines: # List of Director switch spines (for the rack specified)          - guid: "0x093f720900922a00" #required filed. Switch GUID.            location-u: 10 # required field. Device location in rack: "U#"            description: "MF0;gorilla-04:MQM9700/U1" # optional field.          - guid: "0x093f720900899cc0" #required filed. Switch GUID.            location-u: XX # required field. Device location in rack: "U#"            description: "MF0;gorilla-04:MQM9700/U2" # optional field

The logical grouping can be accessed under the "Groups" view, specifically listed as "SuperSwitch group" type.

image2023-1-26_12-59-43-version-1-modificationdate-1707037763137-api-v2.png

Upon selecting the group type SuperSwitch, additional columns containing information related to the SuperSwitch are added to the details view.

image2023-1-26_13-0-2-version-1-modificationdate-1707037762797-api-v2.png

An icon for the SuperSwitch group in its collapsed view exists on the network map.

image2023-1-26_13-0-21-version-1-modificationdate-1707037762457-api-v2.png

Upon selecting the SuperSwitch group, all of its properties can be viewed in the details view.

image2023-1-26_13-0-49-version-1-modificationdate-1707037762160-api-v2.png

Expanding the SuperSwitch group icon displays all the switches included in the group as separate 1U switches, along with their respective properties.

image2023-1-26_13-1-21-version-1-modificationdate-1707037761853-api-v2.png

image2023-1-26_13-1-39-version-1-modificationdate-1707037761617-api-v2.png

On the devices view, switches that are part of the SuperSwitch group are marked with an additional icon that indicates their role in the group. The "S" icon denotes spines, while the "L" icon denotes lines.

image2023-1-26_13-2-19-version-1-modificationdate-1707037761293-api-v2.png

Selecting a switch that belongs to the SuperSwitch group in the properties view allows you to view all the switch properties related to the SuperSwitch group.

image2023-1-26_13-2-39-version-1-modificationdate-1707037760870-api-v2.png

Warning

Each SuperSwitch definition can include one or more racks where each embedded rack can include multiple leafs and spines switches.

© Copyright 2023, NVIDIA. Last updated on Mar 12, 2024.