What can I help you with?
NVIDIA UFM Cable Validation Tool v1.5.0

System Admin

This page is only supported for Admin users

The Summary Report View offers a comprehensive overview of the loaded topology, providing information about the state of devices and their associated agents.

image-2025-4-27_13-45-0-version-1-modificationdate-1746456460633-api-v2.png

The report includes the following details:

  1. Number of loaded Devices

  2. Number of installed Agents

  3. Number of reachable devices

  4. Number of unreachable devices

  5. Number of Devices with wrong agent version

  6. Number of Devices with no agents

  7. Number of no json api

  8. Number of no reports

  9. Number of late reports

  10. Number of stale reports

The Agent Status Report delivers detailed information about the agent installed on each node. The report will also include the node location (rack, unit), type, name and IP.

image-2025-4-27_13-50-0-version-1-modificationdate-1746456460367-api-v2.png

The Service View provides the ability to the user to Load Topology, Start Validation and Stop Bringup.

The Service View enables users to manage the topology by allowing them to load a topology and start/stop validation process.

Load Topology

Depending on the fabric type, the Load Topology feature allows users to upload and load a PTP, dot, or topology file. The process involves the following steps:

Accessing the Load Topology Wizard:

Click on the Load Topology button in the UI to open a wizard.

Wizard Steps

The wizard contains 3 steps

Step 1 - Load Topology

In this step, users can choose from three options to load the desired topology file:

  • P2P: This option uses the load_ptp command to load a P2P file.

    image-2025-4-27_14-9-20-version-1-modificationdate-1746456458737-api-v2.png

Users must provide the following inputs:

    • Format: PTP file format, which can be one of the following:

      • Unified: I t accepts various cluster types, including InfiniBand , Ethernet, and NVLink. For more information, please visit Unified Topology Format.

image-2025-4-27_15-9-17-version-1-modificationdate-1746456458387-api-v2.png

      • Legace ETH: It accepts only Ethernet fabric. For more information, please visit PTP ETH.

image-2025-4-27_15-11-7-version-1-modificationdate-1746456457990-api-v2.png

      • Legacy IB: It accepts only InfiniBand fabric. For more information, please visit PTP IB.

image-2025-4-27_15-12-11-version-1-modificationdate-1746456457717-api-v2.png

    • Topology File:

      • Allows users to select or upload a PTP file.

      • Files can be chosen from a dropdown menu listing all .xlsx files in the directory: /opt/bringup_data/data/uploads/topology/ptp/

      • This directory is a shared volume linked to:/cable_bringup_root/data/uploads/topology/ptp/

      • Users can also upload a file directly from their computer using the Upload button located next to the dropdown menu.

    • DC Layout File (Optional, Appears Only with Legacy formats):

      • Used for selecting or uploading a data center floor layout file.

      • Files can be chosen from a dropdown menu listing all .csv files in the directory: /opt/bringup_data/data/uploads/topology/dc_layout/

      • This directory is a shared volume linked to: /cable_bringup_root/data/uploads/topology/dc_layout/

      • Users can upload a file directly from their computer using the Upload button.

      • Users can enable the DC Layout field by selecting the HCA Mapping checkbox.

    • HCA Mapping (Optional, Appears Only with Legacy formats):

      • Allows users to select or upload an HCA mapping file.

      • Files can be chosen from a dropdown menu listing all .csv files in the directory:/opt/bringup_data/data/uploads/topology/hca_mapping/

      • This directory is a shared volume linked to:

        Copy
        Copied!
                    

        /cable_bringup_root/data/uploads/topology/hca_mapping/

      • Users can enable the HCA Mapping field by selecting the HCA Mapping checkbox.

    • Sheets (Optional, Appears Only with Legacy formats): The user can specify sheets to be included in the file by enabling the Sheets input field (via checkbox) and entering the sheet names as comma-separated values.

    • Manage Servers: If checked, it manages the servers in the topology file; otherwise, it only manages the switches and ignores the servers.

  • Topo: This option uses the load_topo command to load a topology file.

    image-2025-4-27_15-19-11-version-1-modificationdate-1746456457340-api-v2.png

User must provide the following input:

    • Topology File:

      • Allows users to select or upload a .topo file.

      • Files can be chosen from a dropdown menu listing all .topo files in the directory:/opt/bringup_data/data/uploads/topology/topo/

      • This directory is a shared volume linked to:/cable_bringup_root/data/uploads/topology/topo/

      • Users can upload a file directly from their computer using the Upload button.

  • Dot: This option uses the load_topocommand to load a DOT file.

    image-2025-4-27_15-21-56-version-1-modificationdate-1746456457010-api-v2.png

    This option uses the load_topocommand to load a DOT file. User must provide the following input

    • Topology File:

      • Allows users to select or upload a .dot file.

      • Files can be chosen from a dropdown menu listing all .topo files in the directory: /opt/bringup_data/data/uploads/topology/dot/

      • This directory is a shared volume linked to :/cable_bringup_root/data/uploads/topology/dot/

      • Users can upload a file directly from their computer using the Upload button.

    • Manage Servers: If checked, it manages the servers in the topology file; otherwise, it only manages the switches and ignores the servers.

Step 2 - Topology Summary:

After loading the file, this step provides a summary of the loaded topology. Users can review the details to confirm that the correct file and settings have been applied.

image-2025-4-27_15-26-50-version-1-modificationdate-1746456456690-api-v2.png

Step 3 - Device Access Credentials:

image-2025-4-27_15-28-48-version-1-modificationdate-1746456456403-api-v2.png

For more information, please visit Device Access Credentials

Proceeding After 'Device Access Credentials':

  • To continue with validation, users can click the Start Validation button.

image-2025-4-27_15-30-28-version-1-modificationdate-1746456456050-api-v2.png

  • Note: If users only want to upload the topology file without starting validation, they can close the wizard by clicking the X button at the top.

Start Validation

The Start Validation button is used to initiate the validation of the currently loaded topology.

If no topology has been loaded, the Start Validation button will be disabled. Hovering over the button will display a message explaining the requirement to load a topology first.

image-2025-4-27_15-33-3-version-1-modificationdate-1746456455760-api-v2.png

After loading a topology (as described in the Load Topology section), click the Start Validation if it was not started yet to begin the validation process.

image-2025-4-27_15-34-25-version-1-modificationdate-1746456455383-api-v2.png

Users can also stop the validation at any time by clicking the Stop Validation button.

While the validation process is running, the Load Topology button is disabled. This restriction ensures that users cannot load a new topology during an ongoing validation process.

image-2025-4-27_16-5-33-version-1-modificationdate-1746456454773-api-v2.png

Resource utilization is used to track CVT system health and understand how it impacts resource consumption. It will be analyzed across three key areas: storage, memory, and CPU usage.

This analysis will help monitor system performance, optimize resource allocation, and ensure efficient operation.

CPU utilization is calculated over a 3-second interval, meaning it will take 3 seconds for the CPU utilization data to be available.

image-2025-4-6_19-16-38-version-1-modificationdate-1746456462347-api-v2.png

The tab will present resource data in two formats:

  1. Tachometer Chart: A visual gauge that displays the usage percentage for each resource.

image-2025-4-6_19-18-17-version-1-modificationdate-1746456461977-api-v2.png

  1. Table: A structured table displaying resource information in detail

image-2025-4-6_19-18-29-version-1-modificationdate-1746456461653-api-v2.png

To get the latest data, the user can refresh the view manually by clicking the refresh button or enable automatic refresh.

Tachometer Chart Color Thresholds

The color of the tachometer chart will be determined based on the percentage value of each resource, following these predefined thresholds:

CPU Usage Thresholds

0 - 50%

Normal

image-2025-4-6_19-26-2-version-1-modificationdate-1746456461313-api-v2.png

Blue

51 - 75%

Warning

🟠 Orange

76 - 100%

Critical

🔴 Red

Storage Usage Thresholds

0 - 70%

Normal

image-2025-4-6_19-26-2-version-1-modificationdate-1746456461313-api-v2.png

Blue

71 - 90%

Warning

🟠 Orange

91 - 100%

Critical

🔴 Red

Memory Usage Thresholds

0 - 60%

Normal

image-2025-4-6_19-26-2-version-1-modificationdate-1746456461313-api-v2.png

Blue

61 - 80%

Warning

🟠 Orange

81 - 100%

Critical

🔴 Red


The User Management view allows admin users to manage user accounts within the application. admin can create, update, or delete user accounts as needed.

The tab displays all users in a table, with a special icon indicating the currently logged-in user.

worddav0fbb0564c36c315a23b9413ace472f43-version-1-modificationdate-1746456464307-api-v2.png

Create Users

Admin can create new user accounts by following these steps:

  1. Accessing the Create User Modal:

    • Click the Create User button to open a modal for adding a new user.

worddavee51e4776f1d01b242fdf21304b18bf7-version-1-modificationdate-1746456463930-api-v2.png

  1. Supported Account Types:

    • The tool supports the following four account types:

      • admin: Full access to all features and settings.

      • nvidia: can access circuits view, rack view and reports only.

      • cabler: can access circuits view, rack view and reports only.

      • developer: can access circuits view, rack view and reports only.

  2. Adding User Details:

    • Fill in the required fields in the modal to create the user account.

  3. Completing the Process:

    • Click Create to add the new user to the system.

worddav7fef803d64315778ee2954d3e1593afc-version-1-modificationdate-1746456463660-api-v2.png

Update user

Admin user can also update the account type or the password or both for any user he wants

That can be done by right click then click on Update User.

worddav1d972fe2aa05aeb5cc69d8b89f46b09e-version-1-modificationdate-1746456463337-api-v2.png

worddav8021365e09163b2a40c32d8a9ab233ba-version-1-modificationdate-1746456463040-api-v2.png

To change the password user, need to check change password checkbox then fill the passwords input.

Delete Use

Admin user can also delete the user by right click then click on Remove User.

worddav645118235b8d8630e6afdd349938cceb-version-1-modificationdate-1746456462667-api-v2.png

The Device Access Credentials Management component allows you to securely manage credentials (username, password, etc.) for devices in your system.

You can add, view, update, and remove device access credentials through a table and modal interface.

Add Credentials

Admin can add new Credentials by following these steps:

  1. Accessing the Credentials Modal:

    • Click the 'Add Credentials' button to open a modal for adding a new credential.

image-2025-4-27_16-54-12-version-1-modificationdate-1746456453983-api-v2.png

2. Fill in the required fields:

    • Default: Toggle if these are default credentials (applied to all devices without credentials).

    • Node IP: Enter the device IP (only if not default).

    • Username: Enter the username for device access.

    • Password: Enter the password.

    • Type: Select the device type (only if default).

    • Save: Check if you want to save these credentials.

image-2025-4-27_16-58-50-version-1-modificationdate-1746456453570-api-v2.png

image-2025-4-27_16-59-12-version-1-modificationdate-1746456453227-api-v2.png

Update Existing Credentials

Admin user can also update the existing credentials by right click then clicking on Update Node.

image-2025-4-27_17-5-10-version-1-modificationdate-1746456452590-api-v2.png

The user can update the username, password, and save status. Updating the password is mandatory when updating the credentials.

Remove Credentials

Admin user can also remove the credentials by right click then click on Remove. only non-default credentials can be removed

image-2025-4-27_17-5-10-version-1-modificationdate-1746456452590-api-v2.png

© Copyright 2025, NVIDIA. Last updated on May 5, 2025.