docs: add contiv vpp
[vpp.git] / docs / usecases / contiv / VMWARE_FUSION_HOST.md
1 ### Preparing a VmWare Fusion Host
2 The *vmxnet3 driver* is required on a GigE Network Adapter used by VPP. On VmWare
3 Fusion, the default Network Adapter driver is an *Intel 82545EM (e1000)*, and there
4 is no GUI to change it to *vmxnet3*. The change must be done manually in the VM's
5 configuration file as follows:
6
7 - Bring up the VM library window: **Window -> Virtual Machine Library**
8 - Right click on the VM where you want to change the driver:
9   <*VM-Name*> **-> Show in Finder**. This pops up a new Finder window with a line
10   for each VM that Fusion knows about.
11 - Right click on the VM where you want to change the driver:
12   <*VM-Name*> **-> Show package contents**. This brings up a window with the 
13   contents of the package.
14 - Open the file <*VM-Name*> **.vmx** with your favorite text editor.
15 - For each Network Adapter that you want used by VPP, look for the 
16   Network Adapter's driver configuration. For example, for the VM's first
17   Network Adapter look for:
18   ```
19   ethernet0.virtualDev = "e1000"
20   ```
21   Replace `e1000` with `vmxnet3`:
22   ```
23   ethernet0.virtualDev = "vmxnet3"
24   ```
25 and restart the VM.
26
27 If you replaced the driver on your VM's primary Network Adapter, you will 
28 have to change the primary network interface configuration in Linux. 
29
30 First, get the new primary network interface name:
31 ```
32 sudo lshw -class network -businfo
33
34 Bus info          Device      Class          Description
35 ========================================================
36 pci@0000:03:00.0  ens160      network        VMXNET3 Ethernet Controller
37 ```
38 Replace the existing primary network interface name in `/etc/network/interfaces`
39 with the above device name (ens160):
40 ```
41 # This file describes the network interfaces available on your system,
42 # and how to activate them. For more information, see interfaces(5).
43
44 source /etc/network/interfaces.d/*
45
46 # The loopback network interface
47 auto lo
48 iface lo inet loopback
49
50 # The primary network interface
51 auto ens160
52 iface ens160 inet dhcp