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

Create vManage VM Instance on KVM

To run the vManage NMS, you must create a virtual machine (VM) instance for it on a server that is running hypervisor software. This article describes the process for creating a VM on a server running VMware Kernel-based Virtual Machine (KVM) Hypervisor. You can also create the VM on a server running VMware vSphere ESXi Hypervisor.

For server requirements, see Server Hardware Requirements.

Create vManage VM Instance on the KVM Hypervisor

To create a vManage VM instance on the KVM hypervisor:

  1. Launch the Virtual Machine Manager (virt-manager) client application. The system displays the Virtual Machine Manager screen.

  1. Click New to deploy the virtual machine. The Create a new virtual machine screen opens.

  1. Enter the name of the virtual machine. The figure below specifies a name for the vManage instance.
    1. Select Import existing disk image.
    2. Click Forward.
      The virtual disk is imported and associated to the VM instance you are creating.

  1. In Provide the existing storage path box, click Browse to find the vManage software image.
    1. In the OS Type field, select Linux.
    2. In the Version field, select the Linux version you are running.
    3. Click Forward.

  1. Specify Memory and CPU based on your network topology and number of sites, and click Forward.

  1. Select Customize configuration before install, and click Finish.

  1. Select Disk 1 in the left navigation bar. 
    1. Click Advanced Options.
    2. In the Disk Bus field, select IDE.
    3. In the Storage Format field, select qcow2.
    4. Click Apply to create the VM instance with the parameters you just defined. By default, this includes one vNIC. This vNIC is used for the tunnel interface.

Note that the Viptela software supports only E1000 vNICs.

  1. In the vManage Virtual Machine window, click Add Hardware to add a new virtual disk for the vManage database.

  1. In the Add New Virtual Hardware screen, specify the following for the new virtual disk:
    1. In Create a disk image on the computer's hard drive, specify the disk capacity for the vManage database to be 100 GB.
    2. In the Device Type field, specify IDE disk for the virtual storage device.
    3. In the Storage Format field, specify qcow2.
    4. Click Finish to complete the creation of a new virtual disk with a capacity of 100 GB.​

  1. In the vManage Virtual Machine screen, cick Add Hardware to add a second vNIC for the management interface.
  2. In the Add New Virtual Hardware screen, click Network.
    1. In the Host Device field, select an appropriate host device.
    2. Click Finish.

The newly created vNIC is listed in the left pane. This vNIC is used for the management interface.

  1. If the vManage NMS will be part of a cluster, repeat Steps 10 and 11 to create a third vNIC. This vNIC is used for the message bus.
  2. In the vManage Virtual Machine screen click Begin Installation in the top upper-left corner of the screen. 
  3. The system creates the virtual machine instance and displays the vManage console.

  1. At the login prompt, log in with the default username, which is admin, and the default password, which is admin. The system prompts you to select the storage device to use.

  1. Select hdc, which is the new partition you added for the vManage database.
  2. Confirm that you want to format the new partition, hdc. The system reboots and displays the vManage NMS instance.
  3. To create a cluster of vManage NMSs, repeat Steps 1 through 17 to create a VM for each vManage instance. 

Connect To a vManage Instance

To connect to a vManage instance using a web browser, configure an IP address on the vManage instance:

  1. Log in with the default username and password:
    Login: admin
    password: admin
  2. In the management VPN, VPN 512, configure an IP address on interface eth0. Specify an IP address that is reachable on your network. If necessary, add a default route:
    # config
    (config)# vpn 512
    (config)# ip route prefix/length next-hop-ip-address
    (config-vpn-512)# interface eth0
    (config-interface-eth0)# ip address ip-address
    (config-interface-eth0)# no shutdown
    (config-interface-eth0)# command and-quit
  1. To connect to the vManage instance, type the following string in the URL:


  1. Log in with the username admin and the password admin.

Additional Information

Bringup Sequence of Events

  • Was this article helpful?