blob: cb7a1c6097d3fb2c3470a66238aa9b380f6120bd [file] [log] [blame]
John DeNisco06dcd452018-07-26 12:45:10 -04001.. _ubuntu:
2
3.. toctree::
4
5Ubuntu 16.04 - Setup the fd.io Repository
John DeNiscoc64ba6d2018-08-02 15:03:15 -04006==========================================
John DeNisco06dcd452018-07-26 12:45:10 -04007
John DeNiscoce96dda2018-08-14 16:04:09 -04008Choose one of the following releases to install.
John DeNisco06dcd452018-07-26 12:45:10 -04009
10
11Update the OS
John DeNiscoc64ba6d2018-08-02 15:03:15 -040012-----------------------
John DeNisco06dcd452018-07-26 12:45:10 -040013
John DeNiscoce96dda2018-08-14 16:04:09 -040014It is a good idea to first update and upgrade the OS before starting; run the following command to update the OS:
John DeNisco06dcd452018-07-26 12:45:10 -040015
16.. code-block:: console
17
18 apt-get update
19
20
21Point to the Repository
John DeNiscoc64ba6d2018-08-02 15:03:15 -040022-----------------------------------
John DeNisco06dcd452018-07-26 12:45:10 -040023
John DeNiscoce96dda2018-08-14 16:04:09 -040024Create a file **/etc/apt/sources.list.d/99fd.io.list** with contents that point to
John DeNisco06dcd452018-07-26 12:45:10 -040025the version needed. The contents needed are shown below.
26
27.. _install_vpp:
28
29VPP latest Release
John DeNiscoc64ba6d2018-08-02 15:03:15 -040030^^^^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -040031
John DeNiscoce96dda2018-08-14 16:04:09 -040032Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -040033
34.. code-block:: console
35
36 deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./
37
38
39VPP stable/1804 Branch
John DeNiscoc64ba6d2018-08-02 15:03:15 -040040^^^^^^^^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -040041
John DeNiscoce96dda2018-08-14 16:04:09 -040042Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -040043
44.. code-block:: console
45
46 deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.stable.1804.ubuntu.xenial.main/ ./
47
48
49VPP master Branch
John DeNiscoc64ba6d2018-08-02 15:03:15 -040050^^^^^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -040051
John DeNiscoce96dda2018-08-14 16:04:09 -040052Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -040053
54.. code-block:: console
55
56 deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.master.ubuntu.xenial.main/ ./
57
58
59Install the Mandatory Packages
John DeNiscoc64ba6d2018-08-02 15:03:15 -040060===============================
John DeNisco06dcd452018-07-26 12:45:10 -040061
John DeNiscoce96dda2018-08-14 16:04:09 -040062Install the mandatory packages by running the following commands:
63
John DeNisco06dcd452018-07-26 12:45:10 -040064.. code-block:: console
65
66 sudo apt-get update
67 sudo apt-get install vpp vpp-lib vpp-plugin
68
69
70Install the Optional Packages
John DeNiscoc64ba6d2018-08-02 15:03:15 -040071==============================
John DeNisco06dcd452018-07-26 12:45:10 -040072
John DeNiscoce96dda2018-08-14 16:04:09 -040073Install the optional packages by running the following command:
74
John DeNisco06dcd452018-07-26 12:45:10 -040075.. code-block:: console
76
77 sudo apt-get install vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
78
79
80Uninstall the Packages
81======================
82
John DeNiscoce96dda2018-08-14 16:04:09 -040083Uninstall the packages by running the following command:
84
John DeNisco06dcd452018-07-26 12:45:10 -040085.. code-block:: console
86
87 sudo apt-get remove --purge vpp*