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

Create vContainer VM Instance on KVM

To create a vContainer host, you must create a virtual machine (VM) for it on a server that is running hypervisor software. This article describes how to create a VM on a server running the Kernel-based Virtual Machine (KVM) Hypervisor software. You can also create the VM on a server running the VMware vSphere ESXi Hypervisor software or on Amazon AWS.

To create a vContainer VM on the KVM hypervisor:

  1. Download the vContainer host .qcow2 file from the Software Center release folder in the Viptela support portal at Copy it to the KVM server.
  2. Launch the Virtual Machine Manager (virt-manager) client application.

  1. Click the Create a new virtual machine icon located in the upper left of the screen.

  1. In the Create a new virtual machine screen, enter the name of the vContainer host.
    1. Select Import existing disk image.
    2. Click Forward.

  1. Click Browse to locate the vContainer host software image you downloaded in Step 1.
    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 the number of sites. Then click Forward.

  1. Select Customize configuration before install. Then click Finish.

  1. In the vContainer Virtual Machine screen, click Add Hardware to add a second disk.

  1. In the Add New Virtual Hardware screen, select Storage in the left pane.
    1. In Create a disk image on the computer's hard drive, specify the size of the disk in gigabytes. This is a partition of the vContainer host used to store vSmart controller images. The minimum size of this partition is 10 GB.
    2. In Device type, select IDE disk.
    3. In Storage format, select raw.
    4. Click Finish. 
  2. Add a minimum of two network interface to the existing configuration:
    1. In the Virtual Machine screen, click Add Hardware.
    2. Select Network.
    3. Select e1000 for device model. Note that the Viptela software supports only e1000 network interfaces.
    4. Click Finish.
    5. Repeat steps 10a to 10d for the second interface.

  1. Configure Disk 1 by selecting it in the left pane.
    1. Click Advanced Options.
    2. In the Disk Bus field, select IDE.
    3. In the Storage Format field, select qcow2.
    4. Click Apply.
  2. Configure the default NIC by selecting it in the left pane.
    1. Select e1000 for device model.
    2. Click Apply. The newly created disk and interfaces are listed in the left pane. The new disk will store the vSmart image. NIC1 is for the management of the vContainer host and must be part of the corresponding network. NIC2 must be part of the management network for the vSmart controllers. NIC3 must be the part of the transport network for the vSmart controllers to be configured in the vContainer host.

  1. In the vContainer Virtual Machine screen, click Begin Installation in the upper left corner of the screen. The system creates the virtual machine instance and displays the vContainer host console.

  1. At the login prompt, log in with the default username, which is admin, and the default password, which is admin.

Additional Information

Bringup Sequence of Event

  • Was this article helpful?