8 Warning: before starting this guide you should have a minimum knowledge on how `AWS works <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html>`_!
10 First of all, you should log into your Virtual Machine inside AWS (we suggest to create an instance with Ubuntu 16.04 on a m5 type) and download some useful packages to make VPP installation as smooth as possible:
12 .. code-block:: console
15 $ sudo apt-get upgrade
16 $ sudo apt-get install build-essential
17 $ sudo apt-get install python-pip
18 $ sudo apt-get install libnuma-dev
19 $ sudo apt-get install make
20 $ sudo apt install libelf-dev
24 Afterwards, types the following commands to install VPP:
26 .. code-block:: console
28 $ curl -s https://packagecloud.io/install/repositories/fdio/1807/script.deb.sh | sudo bash
33 In this case we downloaded VPP version 18.07 but actually you can use any VPP version available. Then, you can install VPP with all of its plugins:
36 .. code-block:: console
39 $ sudo apt-get install vpp
40 $ sudo apt-get install vpp-plugins vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
44 Now, you need to bind the NICs (Network Card Interface) to VPP. Firstly you have the retrieve the PCI addresses of the NICs you want to bind:
46 .. code-block:: console
48 $ sudo lshw -class network -businfo
53 The PCI addresses have a format similar to this: 0000:00:0X.0. Once you retrieve them, you should copy them inside the startup file of VPP:
55 .. code-block:: console
57 $ sudo nano /etc/vpp/startup.conf
61 Here, inside the dpdk block, copy the PCI addresses of the NIC you want to bind to VPP.
64 .. code-block:: console
71 Now you should install DPDK package. This will allow to bind the NICs to VPP through a script available inside the DPDK package:
73 .. code-block:: console
75 $ wget https://fast.dpdk.org/rel/dpdk-18.08.tar.xz
76 $ tar -xvf dpdk-18.08.tar.xz
77 $ cd ~/dpdk-18.08/usertools/
83 .. code-block:: console
89 When the script is running, you should be able to execute several options. For the moment, just install T=x86_64-native-linuxapp-gcc and then close the script. Now go inside:
91 .. code-block:: console
93 $ cd ~/dpdk-18.08/x86_64-native-linuxapp-gcc/
99 .. code-block:: console
102 $ sudo insmod kmod/igb_uio.ko
105 In this way, the PCIs addresses should appear inside the setup file of DPDK and therefore you can bind them:
107 .. code-block:: console
113 Inside the script, bind the NICs using the option 24.
115 Finally restart VPP and the NICs should appear inside VPP CLI:
117 .. code-block:: console
119 $ sudo service vpp stop
120 $ sudo service vpp start
121 $ sudo vppctl show int
126 Notice that if you stop the VM, you need to bind again the NICs.