Skip to main content
Viptela is now part of Cisco.
Support
Product Documentation
Viptela Documentation

Configure the vContainer Host

Once you have created a vContainer virtual machine (VM) instance, you can 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 will see a prompt 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. This will reboot the vContainer host.

    Available storage devices:
    xvdc    40GB
    1) xvdc
    Select storage device to use: 1
    Would you like to format xvdc? (y/n): y


    After the vContainer host reboots, log in as the user admin, using the default password admin.

  4. Copy the vSmart controller software images you want to use to the vContainer host:
    vContainer# request container image install image-name
  5. Enter configuration mode:
    vContainer# config
    vContainer(config)#

  6. You must configure interfaces before you configure the containers. Interface eth0 in VPN 512 is reserved for the management of the vContainer host. VPN 0 is used for configuring interfaces for the vSmart controllers configured as containers. VPN 0 requires at least two interfaces, one for management for the containers and one for transport for the containers.
    Configure an interface in VPN 0 for the vSmart controller's management network, then 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 address
vContainer(config-interface-eth0)# ip route 0.0.0.0/0 gateway-address

  1. Configure at least one interface for vSmart controller's WAN transport. For each 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.
    Note: make sure the gateway address is reachable before you configure it in the static route. Only reachable routes will be installed in the IP tables:

vContainer(config)# vpn 0 interface eth2
vContainer(config-interface-eth1)# ip address-list address
vContainer(config-interface-eth1)# ip static-route 0.0.0.0/0gateway-address

  1. Create the container for the vSmart controller instance:

    vContainer(config)# container

  2. Name the instance any string up to 32 characters long:

    vContainer(config-container)# instance vSmart-name

  3. Specify the image:

    vContainer(config-instance)# image filename

  4. By default, 512 MB of memory is allocated to the container. You can increase the size if the container is part of a large network. The memory range is 256 through 16384 MB.

    vContainer(config-instance)# memory megabytes

  5. Configure at least one interface using the addresses you configured for the vSmart controller. Use eth0 as the management interface and eth1 for transport. The address in the host-ip-address command 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

  6. Enable the instance:
    vContainer(config-instance)# no shutdown

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

  8. Verify that the configuration is correct and complete:
    vContainer# show running-config

Additional Information

Bringup Sequence of Events

  • Was this article helpful?