Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Devices

Use the Devices screen to add or delete WAN Edge routers and controller devices from the overlay network. WAN Edge routers are vEdge and other WAN routers. Controller devices are the vManage NMS, the vSmart controller, and the vBond orchestrator.

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, Devices.
  • WAN Edge List tab—Upload the WAN Edge authorized serial number file to the vManage NMS. When you first open the Devices screen, the WAN Edge List tab is selected.
    • Change mode—Switch between vManage and CLI mode.
    • Upload WAN Edge List—Upload the WAN edge router authorized serial number file to the vManage NMS.
    • Export Bootstrap Configuration—Generate and download a bootstrap configuration for multiple vEdge Cloud routers.
    • Sync Smart Account—Download the updated device list to vManage NMS and send it to the vBond orchestrator.
    • Table of routers in the overlay network—To re-arrange the columns, drag the column title to the desired position.
  • Controllers tab—Add controllers to the overlay network.
    • Add Controller drop-down—Add controllers to the overlay network.
    • Change mode drop-down—Switch between vManage and CLI mode.
    • Table of controller devices in the overlay network—To re-arrange the columns, drag the column title to the desired position.
  • Search box—Includes the Search Options drop-down, for a Contains or Match string.
  • Refresh icon—Click to refresh data in the device table with the most current data.
  • Export icon—Click to download all data to a file, in CSV format.
  • Show Table Fields icon—Click to display or hide columns from the device table. By default, all columns are displayed.

G00544.png

Change Configuration Modes

To toggle a router from vManage mode to CLI mode:

  1. In WAN Edge List tab, select a device.
  2. Click the Change Mode drop-down and select CLI mode.

An SSH window opens. To log in to the device, enter a username and password. You can then issue CLI commands to configure or monitor the device.

To toggle a controller device from vManage mode to CLI mode:

  1. In the Controllers tab, select a device.
  2. Click the Change Mode drop-down.
  3. Select CLI mode and then select the device type. The Change Mode CLI window opens.
  4. From the vManage mode pane, select the device and click the right arrow to move the device to the CLI mode pane.
  5. Click Update to CLI Mode.

An SSH window opens. To log in to the device, enter a username and password. You can then issue CLI commands to configure or monitor the device.

Upload WAN Edge Router Authorized Serial Number File

The WAN Edge router authorized serial number file contains the chassis and serial numbers of all valid vEdge routers in the overlay network. You receive this file from Viptela. Then, from the vManage NMS, you send it to the controllers in the network. This file is required to allow the Viptela overlay network components to validate and authenticate each other and thus to allow the overlay network to become operational.

To upload the WAN edge router authorized serial number file to the vManage NMS and then download it to all the controllers in the overlay network:

  1. In the WAN Edge List tab, click Upload WAN Edge List.
  2. In the Upload WAN Edge List window:
    1. Click Choose File and select the WAN edge router authorized serial number file you received from Viptela.
    2. To automatically validate the routers and send their chassis and serial numbers to the controllers, ensure that the checkbox Validate the Uploaded WAN Edge List and Send to Controllers is selected. (It is selected by default.) If you do not select this option, you must individually validate each router in Configuration ► Certificates ► WAN Edge List.
    3. Click Upload.

A list of routers in the network is displayed in the router table, with details about each router.

Upload WAN Edge Router Serial Numbers from Cisco Smart Account

To upload the WAN edge router authorized serial numbers from a Cisco Smart account to the vManage NMS and then download it to all the controllers in the overlay network:

  1. In the WAN Edge List tab, click Sync Smart Account.
  2. In the Sync Smart Account window:
    1. Enter the username and password for your Smart account..
    2. To automatically validate the routers and send their chassis and serial numbers to the controllers, ensure that the checkbox Validate the Uploaded WAN Edge List and Send to Controllers is selected. (It is selected by default.) If you do not select this option, you must individually validate each router in Configuration ► Certificates ► WAN Edge List.
    3. Click Sync.

A list of routers in the network is displayed in the router table, with details about each router.

Generate Bootstrap Configuration for a vEdge Cloud Router

For vEdge Cloud routers, you need to generate a bootstrap configuration file that you use when you create vEdge cloud VM instances.

To generate and download a bootstrap configuration for one or more vEdge Cloud routers:

  1. In the WAN Edge List tab, click the Export Bootstrap Configuration button.
  2. In the Export Bootstrap Configuration window, in the Bootstrap Configuration field, click Cloud-Init or Encoded String, depending the Hypervisor you are using to bring up the vEdge Cloud router.
  3. Select the devices to configure from the Available Devices pane, or click Select All to select all devices.
  4. Click the right arrow to move the devices to the Selected Devices pane.
  5. Click Generate Configuration. The configurations are downloaded to the vManage NMS.
  6. Provision the vEdge Cloud router instance in AWS, KVM, or ESXi with the boostrap configuration.
    By default, ge0/0 is the device's tunnel interface and is a DHCP client. To use an interface other than ge0/0 as the tunnel interface or to use a static IP as the IP address, reconfigure the device through the CLI. For more information about configuring interfaces, see Configure Network Interfaces.

After you provision the vEdge Cloud router instance, vManage NMS installs a certificate on the device and the device's token changes to a serial number. After the device's control connections to vManage NMS come up, any templates attached to the device are automatically pushed to the device.

Export Device Data in CSV Format

To export data for all devices to a file in CSV format, click the Export icon. This icon, which is a downward-pointing arrow, is located to the right of the filter criteria both in the WAN Edge List and in the Controllers tab.

vManage NMS downloads all data from the device table to an Excel file in CSV format. The file is downloaded to your brower's default download location and is named viptela_download.csv.

View a Device's Running Configuration

To view a device's running configuration:

  1. In the WAN Edge List or Controllers tab, select the device.
  2. Click the More Actions icon to the right of the row and click Running Configuration.

View a Device's Configuration

To view a device's configuration created using Configuration ► Templates:

  1. In the WAN Edge List or Controllers tab, select the device.
  2. Click the More Actions icon to the right of the row and click Local Configuration.

Delete a WAN Edge Router

Deleting a router removes its serial and chassis numbers from the WAN edge router serial number list and permanently removes the router's configuration from the vManage NMS.

  1. In the Configuration ► Certificates screen, mark the WAN Edge router as invalid.
  2. In the Configuration ► Devices screen, in the WAN Edge List tab, select the router.
  3. Click the More Actions icon to the right of the row and click Delete WAN Edge.
  4. Click OK to confirm deletion of the device.
  5. In the Configuration ► Certificates screen, click Send to Controller.

Copy Router Configuration

When you are replacing one router at a site with another router, you copy the old router's configuration to the new router. Then you remove the old router from the network and add the new one.

To copy the configuration from the old router to the new router:

  1. In the Configuration ► Certificates screen, mark the new vEdge router as invalid.
  2. In the Configuration ► Devices screen, in the WAN Edge List tab, select the old router.
  3. Click the More Actions icon to the right of the row and click Copy Configuration.
  4. In the Copy Configuration window, select the new router.
  5. Click Update to confirm the copy of the configuration.

After you have copied the configuration to the new router, you can add the new router to the network. First, delete the old router from the network, as described below. Then add the new router to the network:

  1. In the Configuration ► Certificates screen, mark the new router as valid.
  2. Click Send to Controller.

Decommission a vEdge Cloud Router

Decommissioning a vEdge Cloud router removes the device's serial number from vManage NMS and generates a new token for the device. To do so:

  1. In the WAN Edge List tab, select a vEdge Cloud router.
  2. Click the More Actions icon to the right of the row and click Decommission WAN Edge.
  3. Click OK to confirm the decommissioning of the router.

View Log of Template Activities

To view a log of activities related to creation of configuration templates and the status of attaching configuration templates to devices:

  1. In the WAN Edge List or Controllers tab, select the device.
  2. Click the More Actions icon to the right of the row and click Template Log.

View Status of Device Bringup

To view the status of the operations involved in bringing a router or controller up in the overlay network:

  1. In the WAN Edge List or Controllers tab, select the device.
  2. Click the More Actions icon to the right of the row and click Device Bring Up.

Add a vBond Orchestrator

  1. In the Controllers tab, click the Add Controller drop-down and select vBond.
  2. In the Add vBond window:
    1. Enter the management IP address of the vBond controller.
    2. Enter the username and password to access the vBond orchestrator.
    3. Select the Generate CSR checkbox to allow the certificate-generation process to occur automatically.
    4. Click Add.
  3. Repeat Steps 1 and 2 to add additional vBond orchestrators.

The new vBond orchestrator is added to the list of controllers in the Controllers screen.

Add a vSmart Controller

  1. In the Controllers tab, click the Add Controller drop-down and select vSmart.
  2. In the Add vSmart window:
    1. Enter the system IP address of the vSmart controller.
    2. Enter the username and password to access the vSmart controller.
    3. Select the protocol to use for control-plane connections. The default is DTLS.
    4. If you select TLS, enter the port number to use for TLS connections. The default is 23456.
    5. Select the Generate CSR checkbox to allow the certificate-generation process to occur automatically.
    6. Click Add.
  3. Repeat Steps 1 and 2 to add additional vSmart controllers. The vManage NMS can support up to 20 vSmart controllers in the network.

The new vSmart controller is added to the list of controllers in the Controllers screen.

Edit Controller Details

To edit the IP address and login credentials of a controller device:

  1. In the Controllers tab, select the controller.
  2. Click the More Actions icon to the right of the row and click Edit.
  3. In the Edit window, edit the IP address and the login credentials.
  4. Click Save.

Delete a Controller

  1. In the Controllers tab, select the controller.
  2. Click the More Actions icon to the right of the row and click Invalidate.
  3. Click OK to confirm the removal of the device and all its control connections.

Configure Reverse Proxy on Controllers

To configure reverse proxy on an individual vManage NMS and vSmart controller device:

  1. In the Controllers tab, select the device.
  2. Click the More Actions icon to the right of the row, and click Add Reverse Proxy. The Add Reverse Proxy popup is displayed.
  3. Click Add Reverse Proxy.
  4. Configure the private IP address and port number for the device. The private IP address is the IP address of the transport interface in VPN 0. The default port number is 12346. This is the port used to establish the connections that handle control and traffic in the overlay network.
  5. Configure the proxy IP address and port number for the device, to create the mapping between the private and public IP addresses and port numbers.
  6. If the vManage NMS or vSmart controller has multiple cores, repeat Steps 4 and 5 for each core.
  7. Click Add.

To enable reverse proxy in the overlay network, in vManage NMS select Administration ► Settings. Then click Edit to the right of the Reverse Proxy bar, click Enabled, and click Save.

  • Was this article helpful?