Topology

Selecting Dashboards → Topology displays important information about the Fabric devices and/or individual devices within the Fabric within a topology map or multiple topology maps depending on the number and fabrics and the connectivity between fabrics.



Note: Selecting Dashboards → Topology displays information about a Fabric assuming a fabric was created and added. For more information about creating and adding a Fabric please refer to the ZTP - Zero Touch Provisioning section in this manual.




UNUM Global Dashboard

UNUM provides access to specific feature help documentation via the Help Button  icon.


Depending on the configuration state of your UNUM instance the Overview may display an actual topology if a Fabric and Seed Switch have previously been configured.

In that case UNUM may display a topology as shown in the following example.



UNUM Topology Map Example

If the Global Fabric navigation bar does not contain any Fabrics proceed to UNUM Global Add to set up your Fabric.


UNUM Notification Bell


The UNUM notification bell  displayed on the top navigation bar provides visual feedback and alerts.


If an alarm condition exists, a visual notification provides you will the number of Unread Notifications.



UNUM Platform Configuration Notification Bell Unread Notifications



After reviewing the alarm notification click the X to close the pop-up window.


Alert or Alarm conditions are indicated with the  icon.


UNUM Platform Configuration Notification Bell License

UNUM Platform Configuration Notification Bell Fabric Change


Click on the bell icon to obtain the following information:


  • License Status - selected via the License tab.
  • Fabric Changes - selected via the Fabric tab.


You use Click to rediscover to clear the alert in the event of Fabric notification changes and to update the Topology map.


Alternatively, you click the Mark As Read link to indicate the alarm condition is noted. The alarm bell toggles to indicate the alarm is cleared.


Click Mark As Unread to undo the notation. The alarm bell toggles to indicate an alarm condition exists.



UNUM Platform Configuration Notification Alarm Mark as Unread


In the event of a License alert and to remove the visual alarm condition activate a license.


The following is an example of a Network Change pop-up message.



UNUM Dashboard Alarm Notification Message Example


Show


Selecting the Show Up or Down arrow icons displays a list of display options for the Topology map.



UNUM Dashboard Show Menu


Device names are toggled by checking Labels. When Labels is deselected, device names are suppressed from the topology display.

Link Highlight, PN Switches Only and Display Multi-fabric are useful functions for displaying complex topology maps and are mutually exclusive in the Dashboard.


Topology Map Search

A Search feature allows you to quickly locate nodes by Name, IP, Trunk or VLAN.

Enter the desired search text in the search field. The results field updates automatically when a search criteria match is found. Scroll through the list to view additional data.

Topology Map Search Results


Select the desired search result.

The search results are highlighted by a dashed green circle. Multiple criteria matches result in multiple dashed green circles.

To clear the search field, click the icon.

UNUM Platform Global - Topology Map Labels

Link Highlight

To view connection links between a specific device and other nodes select the desired device from the left side navigation bar and check Link Highlight. The display will update showing only those connections going to and from the selected device to the other nodes.

 

UNUM Platform Global - Topology Map Link Highlight Feature

PN Switches Only

To view only Pluribus Networks switches select the desired device from the left side navigation bar and check PN Switches Only. The display will update showing only Pluribus Network switches.


UNUM Platform Global - Topology Map PN Switches Feature

Toggling Legend in the dashboard displays a detailed list of icons and their meanings.

UNUM Platform Global - Topology Map Labels and Legend

Connections between devices are represented in the topology map as solid and dashed lines, thickness denoting bandwidth. The thicker the line, the higher the bandwidth.

When multiple connections exist the number of connections, e.g. (2) the designator  is displayed on the line as shown in the example.

The signifies the switch/router contains vPorts.



UNUM Platform Global - Topology Map Device Connections Example


You click on the number to display details of the connection type along with Port Number and bi-directional traffic being passed over the connection between the two devices in terms of percentage.

UNUM Platform Global - Topology Map Connection Details

Additional parameters include visual indicators providing critical information about switch load, interface traffic and interface errors in Red, Yellow or Green.


Indicator





Green

=

0%

<

70%

Yellow

>=

70%

<

90%

Red

>=

90%

<=

100%



A Search feature allows you to quickly locate traffic connections by Port Number or Speed.

Enter the desired search text in the search field. The results field updates automatically when a search criteria match is found.

Select the desired search result.

The search results are displayed.

To clear the search field, click the icon.

In the event multiple connections exist between two devices where one of the devices is not a Fabric node and you double click on the icon to obtain more detailed information about the device you will see the following message.

UNUM Platform Global - Topology Map Device not a Fabric Node

Further, if multiple connections exist between two devices where one of the devices is not a Fabric node and you click the connections number the details pane will display “No Information Available”.

UNUM Platform Global - Topology Map - No Information Available

Rolling over devices in the Topology Map reveals the device name as shown in the example below, while double clicking on a device in the Topology Map displays information about the selected device.

UNUM Platform Global - Topology Map - Device Rollover Pop-up

UNUM Platform Global - Topology Map Device Details & Link Details

Clicking on Device Details updates the display to provide extensive details about the specific device including: Hardware, Software, License, Transceivers and General information.


UNUM Platform Global - Topology Map Device Details

Additional details about the Fabric and the associated switch are displayed.

Visual Status Indicators

  • State - online/offline with green, red and alarm indicators.
  • CPU, stated in terms of percentage with green, yellow, red indicators.
  • Memory, stated in terms of percentage with green, yellow, red indicators.


CPU and Memory %  Color Code Logic :

If the percentage  is >=0  and < 70 the status condition is Green.

If the percentage  is >=70 and < 90 the status condition is Yellow.

If the percentage  is >=90 and <= 100 the status condition is Red.

If a Switch is offline the discovery status of a switch is shown as Offline and the dashboard displays a dashed line replacing the color and percentage indicators.

UNUM Topology Map Visual Indicators


A Discovery Detail visual indicator alerts you to a potential error condition. Click on the  icon to review the error condition.

UNUM Platform Global - Topology Map Additional Details - Discovery Details

Clicking on Link Details updates the display to display details of the connection type along with Port Number and bi-directional traffic being passed over the connection between the two devices in terms of percentage. Multiple entries are sorted using the Search feature to drilldown on Port Number, Speed, etc.

UNUM Platform Global - Topology Map Link Details

To configure Port Properties click on any of the ports listed in the dashboard.



UNUM Platform Global - Topology Map Link Port Properties

The Mac address of the port is displayed along with the current configuration settings.


Select the desired setting changes and enter a Description.


Click Save to continue or Cancel to return to the previous screen without applying any changes.


Trigger Device Discovery


To trigger a device discovery of an individual switch select the desired switch entry using the Cog  icon and click Trigger Device Discovery.


A confirmation message appears and the discovery process begins.



Topology Map Individual Switch Discovery Confirmation Message


Click on "discovering" in the dashboard entry to view the discovery panel.



Topology Map Individual Switch Discovery Mode


Topology Map Individual Switch Discovery Panel

SSH Console Feature

You access a switch via a SSH Console session for any switch entry by clicking SSH using the Cog  icon next to the switch to be accessed.


UNUM Platform Global - SSH


Enter the Username and Password for the switch and click Login to continue. Click Cancel to return to the previous screen.

A SSH Console CLI session is opened on the selected switch.

UNUM Platform Global - SSH Console Session


For example, entering a switch CLI command on a switch running vlans will return that information to the SSH console.


UNUM Platform Global - SSH Console Session Example

Use the TAB key to expand CLI commands.


vPorts


The  icon signifies the switch/router contains vPorts and clicking on the icon updates the dashboard with expanded details of the vPorts on the device.

The vPorts tab displays IP Address, MAC Address, Ports, VLAN, Host Name, Status, Entity, vSwitch, VS-Type, Port Group and Vnic-Type.

You sort the list of vPorts in the vPorts Management dashboard using the up / down  arrows above each of the columns to display the information in a convenient fashion.

UNUM Platform Global - Topology Map Device Details

vPorts Connection Ports Dashboard

When you click on any link within the vPorts Dashboard other than the IP Address you are re-directed to the Connections Ports dashboard containing analytic data based on the filter created by the specific link selected.

Note, in the following example the dashboard filter auto-populates with the srcSwitchPort OR dstSwitchPort number and the switchName when selecting Port from the vPorts dashboard.

General Features - vPorts Connection Ports Analytical Data Dashboard

A Search function provides a useful method of searching and refining list information. You begin by entering criteria in the Search box.


Filtering functions work in a similar manner as described under the Common Features - Search & Filtering section.

vPorts Flow Filter

UNUM Platform Global - Topology Map vPorts Flow Trace


Select Flow Filter to perform a trace of the packet flow using the Insight Analytics IP based Flow Filter.



Switch Analytics vPorts Flow Trace Flow Filter


To create a Flow Filter enter the required parameters which include:


  • Source IP  / Port – source IP address and source Port
  • Destination IP / Port – destination IP address and destination Port
  • Last "N" minutes – select the desired collection period in terms of last minutes


Click Flow Trace or Connections to continue or Cancel to return to the previous screen without applying any changes.


Selecting Connections takes you to the Insight Analytics Flow Connections dashboard.


Alternatively, clicking on any link in the dashboard other than the IP Address takes you to the Insight Analytics Flow Connections dashboard as well.


Selecting Flow Trace updates the Topology Map with an animated Flow Trace visual indicator showing the beginning and end points of packet flow and the hops between the devices.


An example of a flow trace is shown below.




Switch Analytics vPorts Flow Trace Flow Filter Results


If a flow path does not exist between the selected Source IP and the Destination IP the following message will be displayed:



Switch Analytics vPorts Flow Trace Flow- No Flow Exists


Topology Map Group Switches


You select multiple switches while holding your "Command" or "CTRL" key on your keyboard and create a "group" of switches and move them to a desired location within the dashboard.



The original topology map as displayed in the dashboard.

While holding your "Command" or "CTRL" key on your keyboard selected the desired switches for the group. A blue dotted circle appears indicating the switch is selected.

When all the desired switches are selected you release the "Command" or "CTRL" key. Move the "grouped" switches to the desired location within the dashboard.

Once the drag operation is complete, you click the "C" key to clear the selection.

Topology Dashboard Group Switches

Topology Search Feature

A Search function provides a useful method of searching the Fabric topology to locate specific switches and nodes. You begin by entering criteria in the Search box.



Topology Dashboard Search

Enter your search criteria for Name, IP Address, Trunk or Vlan and click the  icon.


The search results are displayed in the Topology map dashboard by switch and highlighted by a green dashed circle.



Topology Dashboard Search Results

 If there are multiple matches such as in the case of vLANs the display will show multiple switches highlighted by green dashed circles.



Topology Dashboard Search Results - Multiple Results


You enter additional search criteria and the topology map is updated accordingly in a cumulative mode.


The search results are displayed in the Topology map dashboard by switch and highlighted by green dashed circles.



Topology Dashboard Multiple Search Results


To delete the topology map dashboard search results, delete any search criteria in the Search box and click the  icon.


A vPorts Search function provides a useful method of searching and refining list information.

You begin by entering criteria displayed in any of the available columns and the dashboard updates automatically.


UNUM Platform Global - Topology Map vPorts Search Details


Switch Analytics Dashboard

You click on any Port, VLAN, other than an IP Address link in the display dashboard to access and obtain detailed information from the Switch Analytics dashboard as shown below.

When you select an IP Address link you are prompted to create an IP Based Flow Filter.


Topology vPorts IP Address Source / Destination


Selecting Connections takes you to the Insight Analytics Flow Connections dashboard.


Alternatively, clicking on any link in the dashboard other than the IP Address takes you to the Insight Analytics Flow Connections dashboard as well.


UNUM Platform Global - Topology Map Device Details Switch Analytics Details


Topology Map Multi-Fabric Support

To view multi-fabric topologies select Show → Display Multi-fabric and set the flag.

Multi-fabric - Display Multi-fabric Flag


For those Fabrics connected to other Fabrics the map will merge the Fabrics into a single display and show the inter-connected switches and routers on a merged map as illustrated below.

UNUM Platform Global - Multi-Fabric Merged Fabric Map



Connections between devices are represented in the topology map as solid and dashed lines, thickness denoting bandwidth. The thicker the line, the higher the bandwidth.

While holding your "Command" or "CTRL" key on your keyboard clicking on a Fabric topology within the Multi-Fabric dashboard will collapse the topology map.

Repeating the sequence will restore the topology map.

You select multiple switches while holding your "Command" or "CTRL" key on your keyboard and create a "group" of switches and move them to a desired location within the dashboard.

A blue dotted circle appears indicating the switch is selected.

Once all the desired switches are selected you release the "Command" or "CTRL" key.

UNUM Platform Global - Topology Map Multi-Fabric Select Switch Group Feature - Create Group



Now you move all the "grouped" switches to the desired location within the dashboard.

UNUM Platform Global - Topology Map Multi-Fabric Select Switch Group Feature - Move Group


Once the drag operation is complete, you click the "C" key to clear the selection.

UNUM Platform Global - Topology Map Multi-Fabric Select Switch Group Feature - Clear Group