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

  • Top bar—On the left are the menu icon, for expanding and collapsing the vManage menu, and the vManage product name. On the right are a number of icons and the user profile drop-down.
  • Title bar—Includes the title of the screen, Geography.
    • No Geographic Coordinates—Located to the right of the title bar, it displays 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 includes the following elements:
    • Search box—Includes the Search Options drop-down, for a Contains or Match string. 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 ► System feature template.

If the Viptela device is not attached to a configuration template, you can 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. Determine whether the device is attached to a configuration template:
    Viptela# show system status
    Check the values in the vManaged and Configuration template output fields. For example:
    ...
    Personality:            vedge
    Model name:             vedge-cloud
    Services:               None
    vManaged:               false
    Commit pending:         false
    Configuration template: None

    If the vManaged field is false, the device is not attached to a configuration template, and the Configuration template field says None. For such a device, you can configure the GPS coordinates directly from the CLI.
    If the vManaged field is true, the device's configuration has been downloaded by the vManage server, and the Configuration template field shows the name of the configuration template. For such a device, you cannot configure the GPS coordinates directly from the CLI. If you attempt to do so, the validate or commit command fails, with the following message:
    Aborted: 'system is-vmanaged': This device is being managed by the vManage. Configuration through the CLI is not allowed.
  5. Enter configuration mode:
    Viptela# config
    ​Viptela(config)#
  6. 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
  7. Save the configuration:
    Viptela(config-system)# commit
    Viptela(config-system)#
  • Was this article helpful?