Skip to main content
Viptela is now part of Cisco.
Support
Product Documentation
Viptela Documentation

Geography

Use the Geography screen to view information about the Viptela devices and links in the overlay network. The Geography screen provides a map displaying the geographic location of the Viptela devices.

Screen Elements

  • Title bar—On the right is a status message, No Geographic Coordinates, followed by the number of devices for which geographic coordinates are not configured.
  • Filter bar—Includes the Filter button and the following tabs which reflect the default Filter selections:
    • All Groups for the device group.
    • vEdge, vEdge-vBond, vBond, vSmart, and vManage for the device types.
    • Control Up, Data Up, and Data Down for the link states.
  • Map—Displays the geographic location of Viptela devices based on the latitude and longitude configured on the devices. The map has the following elements:
    • Search box—The search applies to all devices, including those that have no geographic coordinates defined.
    • + (plus) and – (minus) zoom icons.
    • Map provider icon, to choose any open source map provider.
    • Device icons for the Viptela devices:

vManage_Map.png  vManage

vSmart_Map.png  vSmart

vEdge_Map.png  vEdge

vBond_Map.png  vBond 

  • Device clusters—A green circle with a number in the center indicates a cluster of devices located in an area. Click the cluster to display the individual device icons on the map.

Set Map Filters

To select the devices and links you want to display on the map:

  1. Click the Filter button to display a pull-down menu.
  2. Select the device group from the pull-down menu which includes all configured device groups. By default, the group "All" is selected and displays all Viptela devices in the overlay network. The group "No Groups" includes the devices that are not part of a device group. If all devices are in a group, the "No Groups" group is not displayed.
  3. Select the Viptela devices to display on the map. By default, the map displays all device types including vEdge, vEdge-vBond, vSmart, and vManage.
  4. Select the state of control and data links. By default, the map displays all control and data connections.
  5. Close the Filter box by moving the cursor outside the box.

The map is dynamically updated to reflect your selections. Also, as you make the device group, device type, and link selections, the tabs next to the Filter button are updated.

View Device Information

To display basic information for a device, hover over the device icon. A hover box displays the system IP, hostname, site ID, device type, and device status.

To display detailed information for a device, double-click the device icon to open the View More Details hover box. Click Device Dashboard, Device Details, SSH Terminal, or Links to get further details for the device.

View Link Information

By default, control and data connections are not displayed on the map. To see control and data connections for a device:

  1. Double-click the device icon to open a hover box with details about the device.
  2. Click Links.

Note the following:

  • An active control connection between two devices is displayed on the map as a thin blue line. Multiple active connections between devices are displayed by a bold blue line. A control connection that is down is displayed on the map as a dotted red line. Multiple control connections that are down are displayed by a bold dotted red line. If you hover over the line, a hover box tells you if the connection is up or down.
  • An active data connection between two devices is displayed on the map as a thin green line. Multiple active data connections are displayed by a bold green line. A data connection that is down is displayed on the map as a dotted red line. Multiple data connections that are down are displayed by a bold dotted red line. If you hover over the line, a hover box tells you if the connection is up or down.
  • An active consolidated control and data connection between two devices is displayed on the map as a thick grey line.

Configure Geographic Coordinates for a Device

To configure the geographic coordinates for a device, use the Configuration ► Templates screen, and specify the latitude and longitude in the configuration template you create.

To configure the latitude and longitude directly on the device:

  1. Select the Tools ► SSH Terminal screen.
  2. Select the device from the left pane. The SSH Terminal screen opens in the right pane.
  3. Enter the username and password to log in to the device.
  4. Enter configuration mode:
    Viptela# config
    ​Viptela(config)#
  5. Configure the latitude and longitude on the device:
    Viptela(config)# system gps-location latitude degrees.minutes.seconds
    Viptela(config-system)# gps-location longitude degrees.minutes.seconds
  6. Commit the configuration:
    Viptela(config-system)# commit
    Viptela(config-system)#
  • Was this article helpful?