diff options
Diffstat (limited to 'docs/gettingstarted/users/installing')
| -rw-r--r-- | docs/gettingstarted/users/installing/centos.rst | 40 | ||||
| -rw-r--r-- | docs/gettingstarted/users/installing/index.rst | 20 | ||||
| -rw-r--r-- | docs/gettingstarted/users/installing/opensuse.rst | 9 | ||||
| -rw-r--r-- | docs/gettingstarted/users/installing/ubuntu.rst | 18 |
4 files changed, 49 insertions, 38 deletions
diff --git a/docs/gettingstarted/users/installing/centos.rst b/docs/gettingstarted/users/installing/centos.rst index 470ca87be1f..dae24f6b4c8 100644 --- a/docs/gettingstarted/users/installing/centos.rst +++ b/docs/gettingstarted/users/installing/centos.rst @@ -8,7 +8,8 @@ Setup the fd.io Repository - Centos 7 Update the OS ------------- -Before starting the repository setup, it is a good idea to first update and upgrade the OS. +Before starting the repository setup, it is a good idea to first update and upgrade +the OS; run the following command to update the OS: .. code-block:: console @@ -18,8 +19,7 @@ Before starting the repository setup, it is a good idea to first update and upgr Point to the Repository ----------------------- -For CentOS based systems, there are two respositories to pull VPP binaries -from. +For CentOS based systems, there are two respositories to pull VPP binaries from: * CentOS NFV SIG Repository * Nexus Repository @@ -28,15 +28,14 @@ from. CentOS NFV SIG Repository ^^^^^^^^^^^^^^^^^^^^^^^^^ -VPP is not in the official CentOS 7 distro. However, CentOS has Special +VPP is not in the official CentOS 7 distro; however, CentOS has Special Interest Groups (SIG), which are smaller groups within the CentOS community that focus on a small set of issues. The CentOS NFV (Network Function Virtualization) SIG was created to provide a CentOS-based stack that will serve as a platform -for the deployment and testing of virtual network functions (VNFs). VPP has been -included in this SIG. To install released packages from the CentOS NFV SIG Repository on an updated -Centos 7 system, first, install the CentOS NFV SIG FIDO repo file: +Centos 7 system, first, install the CentOS NFV SIG FIDO repo file by running the +following command: .. code-block:: console @@ -109,7 +108,7 @@ VPP Latest Release """""""""""""""""" To allow *'yum'* access to the official VPP releases, create the file -*'/etc/yum.repos.d/fdio-release.repo'* with the following content: +*'/etc/yum.repos.d/fdio-release.repo'* with the following content. .. code-block:: console @@ -122,7 +121,7 @@ To allow *'yum'* access to the official VPP releases, create the file The *'yum install vpp'* command will install the most recent release. To install older releases, run the following command to get the list of releases -provided: +provided. .. code-block:: console @@ -133,10 +132,10 @@ sample *'yum --showduplicates list'* output and an example of installing a particular version of the RPMs. VPP Stable Branch -""""""""""""""""" +""""""""""""""""""" To allow *yum* access to the build artifacts for a VPP stable branch, create -the file *'/etc/yum.repos.d/fdio-release.repo'* with the following content: +the file *'/etc/yum.repos.d/fdio-release.repo'* with the following content. .. code-block:: console @@ -164,10 +163,10 @@ particular version of the RPMs. VPP Master Branch -""""""""""""""""" +""""""""""""""""""" To allow *yum* access to the nightly builds from the VPP master branch, create -the file *'/etc/yum.repos.d/fdio-release.repo'* with the following content: +the file *'/etc/yum.repos.d/fdio-release.repo'* with the following content. .. code-block:: console @@ -180,7 +179,7 @@ the file *'/etc/yum.repos.d/fdio-release.repo'* with the following content: The *'yum install vpp'* command will install the most recent build on the branch. Run the following command to get the list of images produce by the -branch: +branch. .. code-block:: console @@ -194,18 +193,18 @@ particular version of the RPMs. Install VPP RPMs ================ -To install the VPP packet engine, run the following: +To install the VPP packet engine, run the following command: .. code-block:: console $ sudo yum install vpp -The **'vpp'** RPM depend on the **'vpp-lib'** and **'vpp-selinux-policy'** +The *vpp* RPM depends on the *vpp-lib* and *vpp-selinux-policy* RPMs, so they will be installed as well. .. note:: - The **'vpp-selinux-policy'** will not enable SELinux on the system. It + The *vpp-selinux-policy* will not enable SELinux on the system. It will install a Custom VPP SELinux policy that will be used if SELinux is enabled at any time. @@ -221,19 +220,18 @@ Starting VPP ============ Once VPP is installed on the system, to run VPP as a systemd service on CentOS, -run: +run the following command: .. code-block:: console $ sudo systemctl start vpp -Then to enable VPP to start on system reboot: +Then to enable VPP to start on system reboot, run the following command: .. code-block:: console $ sudo systemctl enable vpp - Outside of running VPP as a systemd service, VPP can be started manually or made to run within GDB for debugging. See :ref:`running` for more details and ways to tailor VPP to a specific system. @@ -242,6 +240,8 @@ ways to tailor VPP to a specific system. Uninstall the VPP RPMs ====================== +To uninstall a VPP RPM, run the following command: + .. code-block:: console $ sudo yum autoremove vpp* diff --git a/docs/gettingstarted/users/installing/index.rst b/docs/gettingstarted/users/installing/index.rst index 4a8ac7a6952..12a5ab8e015 100644 --- a/docs/gettingstarted/users/installing/index.rst +++ b/docs/gettingstarted/users/installing/index.rst @@ -12,16 +12,8 @@ existing packages. This guide describes how to pull, install and run the VPP pac .. toctree:: -Package Descriptions --------------------- -The following is a brief description of the packages to be installed with VPP. - -.. toctree:: - - packages - -Installing VPP Binaries ----------------------------------- +Installing VPP +--------------- This section provides directions on how to Install VPP binaries on Ubuntu, Centos, and openSUSE platforms. @@ -49,3 +41,11 @@ The following are instructions on how to install VPP on openSUSE. .. toctree:: opensuse + +Package Descriptions +-------------------- +The following is a brief description of the packages to be installed with VPP. + +.. toctree:: + + packages diff --git a/docs/gettingstarted/users/installing/opensuse.rst b/docs/gettingstarted/users/installing/opensuse.rst index b5dcbc35820..6d7873820dc 100644 --- a/docs/gettingstarted/users/installing/opensuse.rst +++ b/docs/gettingstarted/users/installing/opensuse.rst @@ -4,8 +4,9 @@ Installing ========== -To install VPP on openSUSE, first install the following release and then execute -the appropriate commands. + +To install VPP on openSUSE, first install the following release, and then execute +the associated commands. openSUSE Tumbleweed (rolling release) ------------------------------------------------------------ @@ -25,6 +26,8 @@ openSUSE Leap 42.3 Uninstall ========= +To uninstall the vpp plugins, run the following command: + .. code-block:: console sudo zypper remove -u vpp vpp-plugins @@ -32,6 +35,8 @@ Uninstall openSUSE Tumbleweed (rolling release) ------------------------------------- +To uninstall the openSUSE Tumbleweed, run the following command: + .. code-block:: console sudo zypper remove -u vpp vpp-plugins diff --git a/docs/gettingstarted/users/installing/ubuntu.rst b/docs/gettingstarted/users/installing/ubuntu.rst index 5b4a1d86fee..cb7a1c6097d 100644 --- a/docs/gettingstarted/users/installing/ubuntu.rst +++ b/docs/gettingstarted/users/installing/ubuntu.rst @@ -5,13 +5,13 @@ Ubuntu 16.04 - Setup the fd.io Repository ========================================== -From the following, choose one of the releases to install. +Choose one of the following releases to install. Update the OS ----------------------- -It is probably a good idea to update and upgrade the OS before starting +It is a good idea to first update and upgrade the OS before starting; run the following command to update the OS: .. code-block:: console @@ -21,7 +21,7 @@ It is probably a good idea to update and upgrade the OS before starting Point to the Repository ----------------------------------- -Create a file **"/etc/apt/sources.list.d/99fd.io.list"** with the contents that point to +Create a file **/etc/apt/sources.list.d/99fd.io.list** with contents that point to the version needed. The contents needed are shown below. .. _install_vpp: @@ -29,7 +29,7 @@ the version needed. The contents needed are shown below. VPP latest Release ^^^^^^^^^^^^^^^^^^^ -Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: +Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents: .. code-block:: console @@ -39,7 +39,7 @@ Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: VPP stable/1804 Branch ^^^^^^^^^^^^^^^^^^^^^^^ -Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: +Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents: .. code-block:: console @@ -49,7 +49,7 @@ Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: VPP master Branch ^^^^^^^^^^^^^^^^^^^^ -Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: +Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents: .. code-block:: console @@ -59,6 +59,8 @@ Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents: Install the Mandatory Packages =============================== +Install the mandatory packages by running the following commands: + .. code-block:: console sudo apt-get update @@ -68,6 +70,8 @@ Install the Mandatory Packages Install the Optional Packages ============================== +Install the optional packages by running the following command: + .. code-block:: console sudo apt-get install vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua @@ -76,6 +80,8 @@ Install the Optional Packages Uninstall the Packages ====================== +Uninstall the packages by running the following command: + .. code-block:: console sudo apt-get remove --purge vpp* |