From 25c4d396eae99e23c4ebe7155fde7700dd1130b9 Mon Sep 17 00:00:00 2001 From: Scott Keeler Date: Mon, 1 Oct 2018 14:50:57 -0400 Subject: docs: add contiv vpp Change-Id: I92227fc4968fc6a478beb7f38707b91e9f0635ec Signed-off-by: Scott Keeler --- docs/usecases/contiv/VMWARE_FUSION_HOST.md | 52 ++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/usecases/contiv/VMWARE_FUSION_HOST.md (limited to 'docs/usecases/contiv/VMWARE_FUSION_HOST.md') diff --git a/docs/usecases/contiv/VMWARE_FUSION_HOST.md b/docs/usecases/contiv/VMWARE_FUSION_HOST.md new file mode 100644 index 00000000000..d4e251c0fcd --- /dev/null +++ b/docs/usecases/contiv/VMWARE_FUSION_HOST.md @@ -0,0 +1,52 @@ +### Preparing a VmWare Fusion Host +The *vmxnet3 driver* is required on a GigE Network Adapter used by VPP. On VmWare +Fusion, the default Network Adapter driver is an *Intel 82545EM (e1000)*, and there +is no GUI to change it to *vmxnet3*. The change must be done manually in the VM's +configuration file as follows: + +- Bring up the VM library window: **Window -> Virtual Machine Library** +- Right click on the VM where you want to change the driver: + <*VM-Name*> **-> Show in Finder**. This pops up a new Finder window with a line + for each VM that Fusion knows about. +- Right click on the VM where you want to change the driver: + <*VM-Name*> **-> Show package contents**. This brings up a window with the + contents of the package. +- Open the file <*VM-Name*> **.vmx** with your favorite text editor. +- For each Network Adapter that you want used by VPP, look for the + Network Adapter's driver configuration. For example, for the VM's first + Network Adapter look for: + ``` + ethernet0.virtualDev = "e1000" + ``` + Replace `e1000` with `vmxnet3`: + ``` + ethernet0.virtualDev = "vmxnet3" + ``` +and restart the VM. + +If you replaced the driver on your VM's primary Network Adapter, you will +have to change the primary network interface configuration in Linux. + +First, get the new primary network interface name: +``` +sudo lshw -class network -businfo + +Bus info Device Class Description +======================================================== +pci@0000:03:00.0 ens160 network VMXNET3 Ethernet Controller +``` +Replace the existing primary network interface name in `/etc/network/interfaces` +with the above device name (ens160): +``` +# This file describes the network interfaces available on your system, +# and how to activate them. For more information, see interfaces(5). + +source /etc/network/interfaces.d/* + +# The loopback network interface +auto lo +iface lo inet loopback + +# The primary network interface +auto ens160 +iface ens160 inet dhcp \ No newline at end of file -- cgit 1.2.3-korg