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