Gitiles
Code Review Sign In
gerrit.nordix.org / fdio / vpp / c1f5a4336036e3f2d1f6746f39ce610312254272 / . / docs / gettingstarted / installing / ubuntu.rst
blob: f887597f1bbaf003d6be4db38ccd6f7efb1e359e [file] [log] [blame]
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]1.. _ubuntu:
2
3.. toctree::
4
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]5Ubuntu 16.04 - Setup the FD.io Repository
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]6==========================================
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]7
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]8FD.io VPP is installed using Package Cloud. For a complete set of
9instructuctions on how to install VPP with package cloud please refer
10to `Package Cloud <https://packagecloud.io/fdio/release>`_
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]11
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]12Choose one of the following releases to install.
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]13
14Update the OS
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]15-----------------------
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]16
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]17It is a good idea to first update and upgrade the OS before starting; run the
18following command to update the OS:
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]19
20.. code-block:: console
21
22 apt-get update
23
24
25Point to the Repository
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]26-----------------------------------
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]27
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]28Create a file **/etc/apt/sources.list.d/99fd.io.list** with contents that point to
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]29the version needed. The contents needed are shown below.
30
31.. _install_vpp:
32
33VPP latest Release
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]34^^^^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]35
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]36Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]37
38.. code-block:: console
39
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]40 deb [trusted=yes] https://packagecloud.io/fdio/release/ubuntu xenial main ./
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]41
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]42Get the key:
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]43
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]44.. code-block:: console
45
46 curl -L https://packagecloud.io/fdio/release/gpgkey | sudo apt-key add -
47
48VPP 1810 Branch
49^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]50
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]51Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]52
53.. code-block:: console
54
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]55 deb [trusted=yes] https://packagecloud.io/fdio/1810/ubuntu xenial main ./
56
57Get the key:
58
59.. code-block:: console
60
61 curl -L https://packagecloud.io/fdio/1810/gpgkey | sudo apt-key add -
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]62
63
64VPP master Branch
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]65^^^^^^^^^^^^^^^^^^^^
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]66
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]67Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]68
69.. code-block:: console
70
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]71 deb [trusted=yes] https://packagecloud.io/fdio/master/ubuntu xenial main ./
72
73Get the key:
74
75.. code-block:: console
76
77 curl -L https://packagecloud.io/fdio/master/gpgkey | sudo apt-key add -
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]78
79
80Install the Mandatory Packages
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]81===============================
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]82
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]83Install the mandatory packages by running the following commands:
84
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]85.. code-block:: console
86
87 sudo apt-get update
John DeNiscoc4c72d22018-08-16 13:50:02 -0400[diff] [blame]88 sudo apt-get install vpp-lib vpp vpp-plugins
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]89
jdenisco569a2782018-11-09 15:20:26 -0500[diff] [blame]90
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]91Install the Optional Packages
John DeNiscoc64ba6d2018-08-02 15:03:15 -0400[diff] [blame]92==============================
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]93
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]94Install the optional packages by running the following command:
95
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]96.. code-block:: console
97
98 sudo apt-get install vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
99
100
101Uninstall the Packages
102======================
103
John DeNiscoce96dda2018-08-14 16:04:09 -0400[diff] [blame]104Uninstall the packages by running the following command:
105
John DeNisco06dcd452018-07-26 12:45:10 -0400[diff] [blame]106.. code-block:: console
107
108 sudo apt-get remove --purge vpp*