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

Configure the vContainer Host

Once you have created a vContainer virtual machine (VM) instance, you configure the vContainer host to hold vSmart controllers as containers:

  1. Open a CLI session to the vContainer host via SSH.
  2. Log in as the user admin, using the default password, admin. The CLI prompt is displayed.
  3. The first time you log in to the vContainer host, you are prompted to select the storage device. Enter the number of the device you want to use. Then type y and Enter to format the storage device. The vContainer host then reboots.
Available storage devices:
xvdc    40GB
1) xvdc
Select storage device to use: 1
Would you like to format xvdc? (y/n): y
  1. After the vContainer host reboots, log in as the user admin, using the default password admin.
  2. Copy the vSmart controller software images you want to use to the vContainer host:
vContainer# request container image install image-name
vContainer#
  1. Enter configuration mode:

vContainer# config
vContainer(config)#
  1. Configure the interfaces on the vContainer host. In VPN 0, configure a minimum of two interfaces:

    eth1—This is the management interface. The vContainer software maps this interface to the management interface in the vSmart controller's VPN 512.
    eth2—This is the transport interface. The vContainer software maps this interface to the eth1 interface in the vSmart controller's VPN 0, which is the WAN transport VPN.

    For the eth1 interface, configure a list of IP addresses in the same network, and configure a static route for that network. Use one ip address-list command for each address. For vContainer VMs in AWS, the address configured in ip address-list is the secondary IP address configured on the additional interfaces, eth1 and eth2. See Create vContainer VM Instance on AWS.

Note: Make sure the gateway address is reachable before you configure it in the static route. Only reachable routes are installed in the IP tables.

vContainer(config)# vpn 0 interface eth1
vContainer(config-interface-eth0)# ip address-list prefix/length
vContainer(config-interface-eth0)# ip route 0.0.0.0/0 gateway-address

For the eth2 interface, configure a list of IP addresses in the same network and configure a static route for that network. Configure one ip address-list command for each address. You can configure additional interfaces to use for the vSmart controller's WAN transport. For these interfaces, configure a list of IP addresses in the same network and configure a static route.

Note: Make sure the gateway address is reachable before you configure it in the static route. Only reachable routes are installed in the IP tables.

vContainer(config)# vpn 0 interface eth2
vContainer(config-interface-eth1)# ip address-list prefix/length
vContainer(config-interface-eth1)# ip static-route 0.0.0.0/0 gateway-address
  1. Create a container for the vSmart controller instance:

vContainer(config)# container
  1. Create an instance in the container. The instance name can be a string from 1 to 32 characters long.

vContainer(config-container)# instance instance-name
  1. Specify the software image to use on the vSmart controller:

vContainer(config-instance)# image filename
  1. By default, 512 MB of memory are allocated to the container. If the container is part of a large network, you might want to increase the size of the container. You can allocate from 256 through 16384 MB.

vContainer(config-instance)# memory megabytes
  1. Configure one or more interfaces with the address you configured for the vSmart controller. Use the eth0 interface for the management interface and the eth1 interface for transport. The address you specify is the vContainer host interface you are mapping to this vSmart controller instance. This address must be in the IP address list you configured on the vContainer host.

vContainer(config-instance)# interface eth0
vContainer(config-interface-eth0)# host-ip-address ip-address
vContainer(config-instance)# interface eth1
vContainer(config-interface-eth1)# host-ip-address ip-address
  1. Configure the IP addresses of devices that need to access the container instance. Typically, these devices are other controller devices, including vBond orchestrators, vSmart controllers, and vManage NMSs. Configure one allow-address command for each prefix.

vContainer(config-instance)# allow-address prefix/length 0 [port] protocol
  1. Enable the instance:

vContainer(config-instance)# no shutdown
  1. Commit the configuration. When you commit, all interfaces configured with no shutdown start their vSmart controllers.

vContainer(config)# commit and-quit
vContainer#
  1. Verify that the configuration is correct and complete:

vContainer# show running-config

Additional Information

Bringup Sequence of Events

  • Was this article helpful?