contiv-init

Documentation

Overview

Contiv-init is the init process of the contiv vswitch POD. It starts VPP and contiv-agent processes in the correct order (using the supervisor xmlrpc API), and does the STN (Steal the NIC) pre-configuration on VPP and in the host stack.

In STN case, the order of contiv-init operation is:

• read contiv YAML config,
• determine interface to be stolen from the config,
• request stealing the NIC from the STN Daemon,
• start VPP,
• pre-configure the stolen interface on VPP,
• configure VPP-host connectivity,
• connect to ETCD,
• persist the VPP and host config in ETCD,
• start the contiv-agent.

In non-STN case, contiv init operates as follows:

• read contiv YAML config,
• start VPP,
• start contiv-agent.

In order to request STN of an interface, specify requested Linux interface name in StealInterface in the NodeConfig part of the contiv-vpp deployment yaml, e.g.:

     NodeConfig:
		- NodeName: "ubuntu-1"
		  StealInterface: "enp0s8"

Also, do not forget to put proper PCI address into the VPP startup config file, e.g. in /etc/vpp/contiv-vswitch.conf

...
dpdk {
  dev 0000:00:08.0
}
...