summaryrefslogtreecommitdiffstats
path: root/docs/gettingstarted/users
diff options
context:
space:
mode:
authorJohn DeNisco <jdenisco@cisco.com>2018-08-17 14:25:15 -0400
committerDamjan Marion <dmarion@me.com>2018-08-17 19:40:10 +0000
commita5db42f366798034e464442c92a90529fc947f08 (patch)
treeae96e6b332a7f5585a94a4ae069511f9fe07add9 /docs/gettingstarted/users
parentbf21dc85053931bc597e0fab1112061aa60e986b (diff)
docs: Moved installing up a level, removed guides.
Change-Id: Ie4b2939b693698585f1f2d12391a0009e80bac0b Signed-off-by: John DeNisco <jdenisco@cisco.com>
Diffstat (limited to 'docs/gettingstarted/users')
-rw-r--r--docs/gettingstarted/users/index.rst1
-rw-r--r--docs/gettingstarted/users/installing/centos.rst247
-rw-r--r--docs/gettingstarted/users/installing/index.rst51
-rw-r--r--docs/gettingstarted/users/installing/opensuse.rst57
-rw-r--r--docs/gettingstarted/users/installing/packages.rst85
-rw-r--r--docs/gettingstarted/users/installing/ubuntu.rst87
6 files changed, 0 insertions, 528 deletions
diff --git a/docs/gettingstarted/users/index.rst b/docs/gettingstarted/users/index.rst
index 4ec261a9937..7fdb2829eb8 100644
--- a/docs/gettingstarted/users/index.rst
+++ b/docs/gettingstarted/users/index.rst
@@ -22,6 +22,5 @@ section covers the following areas:
:maxdepth: 2
configutil/index.rst
- installing/index.rst
configuring/index.rst
running/index.rst
diff --git a/docs/gettingstarted/users/installing/centos.rst b/docs/gettingstarted/users/installing/centos.rst
deleted file mode 100644
index dae24f6b4c8..00000000000
--- a/docs/gettingstarted/users/installing/centos.rst
+++ /dev/null
@@ -1,247 +0,0 @@
-.. _centos:
-
-.. toctree::
-
-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; run the following command to update the OS:
-
-.. code-block:: console
-
- $ sudo yum update
-
-
-Point to the Repository
------------------------
-
-For CentOS based systems, there are two respositories to pull VPP binaries from:
-
-* CentOS NFV SIG Repository
-* Nexus Repository
-
-
-CentOS NFV SIG Repository
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-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
-
-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 by running the
-following command:
-
-.. code-block:: console
-
- $ sudo yum install centos-release-fdio
-
-then **'Install VPP RPMs'**, as described below.
-
-This will install the latest VPP version from the repository. To install an
-older version, once the CentOS NFV SIG FDIO repo file has been installed, list
-the stored versions:
-
-.. code-block:: console
-
- $ sudo yum --showduplicates list vpp* | expand
- Loaded plugins: fastestmirror
- Loading mirror speeds from cached hostfile
- * base: repos-va.psychz.net
- * epel: download-ib01.fedoraproject.org
- * extras: mirror.siena.edu
- * updates: repo1.ash.innoscale.net
- Available Packages
- vpp.x86_64 17.10-1 centos-fdio
- vpp.x86_64 18.01.1-1 centos-fdio
- vpp.x86_64 18.01.2-1 centos-fdio
- vpp.x86_64 18.04-1 centos-fdio
- vpp-api-java.x86_64 17.10-1 centos-fdio
- vpp-api-java.x86_64 18.01.1-1 centos-fdio
- vpp-api-java.x86_64 18.01.2-1 centos-fdio
- vpp-api-java.x86_64 18.04-1 centos-fdio
- vpp-api-lua.x86_64 17.10-1 centos-fdio
- vpp-api-lua.x86_64 18.01.1-1 centos-fdio
- vpp-api-lua.x86_64 18.01.2-1 centos-fdio
- vpp-api-lua.x86_64 18.04-1 centos-fdio
- vpp-api-python.x86_64 17.10-1 centos-fdio
- vpp-api-python.x86_64 18.01.1-1 centos-fdio
- vpp-api-python.x86_64 18.01.2-1 centos-fdio
- vpp-api-python.x86_64 18.04-1 centos-fdio
- vpp-devel.x86_64 17.10-1 centos-fdio
- vpp-devel.x86_64 18.01.1-1 centos-fdio
- vpp-devel.x86_64 18.01.2-1 centos-fdio
- vpp-devel.x86_64 18.04-1 centos-fdio
- vpp-lib.x86_64 17.10-1 centos-fdio
- vpp-lib.x86_64 18.01.1-1 centos-fdio
- vpp-lib.x86_64 18.01.2-1 centos-fdio
- vpp-lib.x86_64 18.04-1 centos-fdio
- vpp-plugins.x86_64 17.10-1 centos-fdio
- vpp-plugins.x86_64 18.01.1-1 centos-fdio
- vpp-plugins.x86_64 18.01.2-1 centos-fdio
- vpp-plugins.x86_64 18.04-1 centos-fdio
- vpp-selinux-policy.x86_64 18.04-1 centos-fdio
-
-Then install a particular version:
-
-.. code-block:: console
-
- $ sudo yum install vpp-17.10-1.x86_64
-
-
-Nexus Repository
-^^^^^^^^^^^^^^^^
-
-Build artifacts are also posted to a FD.io Nexus Repository. This includes
-official point releases, as well as nightly builds. To use any of these build
-artifacts, create a file *'/etc/yum.repos.d/fdio-release.repo'* with the
-content that points to the version needed. Below are some common examples of
-the content needed:
-
-
-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.
-
-.. code-block:: console
-
- $ cat /etc/yum.repos.d/fdio-release.repo
- [fdio-release]
- name=fd.io release branch latest merge
- baseurl=https://nexus.fd.io/content/repositories/fd.io.centos7/
- enabled=1
- gpgcheck=0
-
-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.
-
-.. code-block:: console
-
- $ sudo yum --showduplicates list vpp* | expand
-
-Then choose the release to install. See **'CentOS NFV SIG Repository'** for
-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.
-
-.. code-block:: console
-
- $ cat /etc/yum.repos.d/fdio-release.repo
- [fdio-stable-1804]
- name=fd.io stable/1804 branch latest merge
- baseurl=https://nexus.fd.io/content/repositories/fd.io.stable.1804.centos7/
- enabled=1
- gpgcheck=0
-
-For other stable branches, replace the *'1804'* from the above content with the
-desired release. Examples: 1606, 1609, 1701, 1704, 1707, 1710, 1804, 1807
-
-The *'yum install vpp'* command will install the most recent build on the
-branch, not the latest offical release. Run the following command to get the
-list of images produce by the branch:
-
-.. code-block:: console
-
- $ sudo yum --showduplicates list vpp* | expand
-
-Then choose the image to install. See **'CentOS NFV SIG Repository'** for
-sample *'yum --showduplicates list'* output and an example of installing a
-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.
-
-.. code-block:: console
-
- $ cat /etc/yum.repos.d/fdio-release.repo
- [fdio-master]
- name=fd.io master branch latest merge
- baseurl=https://nexus.fd.io/content/repositories/fd.io.master.centos7/
- enabled=1
- gpgcheck=0
-
-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.
-
-.. code-block:: console
-
- $ sudo yum --showduplicates list vpp* | expand
-
-Then choose the image to install. See **'CentOS NFV SIG Repository'** for
-sample *'yum --showduplicates list'* output and an example of installing a
-particular version of the RPMs.
-
-
-Install VPP RPMs
-================
-
-To install the VPP packet engine, run the following command:
-
-.. code-block:: console
-
- $ sudo yum install vpp
-
-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
- will install a Custom VPP SELinux policy that will be used if SELinux is
- enabled at any time.
-
-There are additional packages that are optional. These packages can be
-combined with the command above and installed all at once, or installed as
-needed:
-
-.. code-block:: console
-
- $ sudo yum install vpp-plugins vpp-devel vpp-api-python vpp-api-lua vpp-api-java
-
-Starting VPP
-============
-
-Once VPP is installed on the system, to run VPP as a systemd service on CentOS,
-run the following command:
-
-.. code-block:: console
-
- $ sudo systemctl start vpp
-
-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.
-
-
-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
deleted file mode 100644
index 12a5ab8e015..00000000000
--- a/docs/gettingstarted/users/installing/index.rst
+++ /dev/null
@@ -1,51 +0,0 @@
-.. _installing:
-
-.. toctree::
-
-.. _installingVPP:
-
-Installing VPP from Packages
-==============================
-
-If you want to use VPP it can be convenient to install the binaries from
-existing packages. This guide describes how to pull, install and run the VPP packages.
-
-.. toctree::
-
-Installing VPP
----------------
-
-This section provides directions on how to Install VPP binaries on Ubuntu, Centos,
-and openSUSE platforms.
-
-Installing on Ubuntu
-^^^^^^^^^^^^^^^^^^^^^
-The following are instructions on how to install VPP on Ubuntu.
-
-.. toctree::
-
- ubuntu
-
-Installing on Centos
-^^^^^^^^^^^^^^^^^^^^
-The following are instructions on how to install VPP on Centos.
-
-.. toctree::
-
- centos
-
-Installing on openSUSE
-^^^^^^^^^^^^^^^^^^^^^^
-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
deleted file mode 100644
index 6d7873820dc..00000000000
--- a/docs/gettingstarted/users/installing/opensuse.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-.. _opensuse:
-
-.. toctree::
-
-Installing
-==========
-
-To install VPP on openSUSE, first install the following release, and then execute
-the associated commands.
-
-openSUSE Tumbleweed (rolling release)
-------------------------------------------------------------
-
-.. code-block:: console
-
- sudo zypper install vpp vpp-plugins
-
-openSUSE Leap 42.3
---------------------------------
-
-.. code-block:: console
-
- sudo zypper addrepo --name network https://download.opensuse.org/repositories/network/openSUSE_Leap_42.3/network.repo
- sudo zypper install vpp vpp-plugins
-
-Uninstall
-=========
-
-To uninstall the vpp plugins, run the following command:
-
-.. code-block:: console
-
- sudo zypper remove -u vpp vpp-plugins
-
-openSUSE Tumbleweed (rolling release)
--------------------------------------
-
-To uninstall the openSUSE Tumbleweed, run the following command:
-
-.. code-block:: console
-
- sudo zypper remove -u vpp vpp-plugins
-
-openSUSE Leap 42.3
-------------------
-
-.. code-block:: console
-
- sudo zypper remove -u vpp vpp-plugins
- sudo zypper removerepo network
-
-For More Information
-====================
-For more information on VPP with openSUSE, please look at the following post.
-
-* https://www.suse.com/communities/blog/vector-packet-processing-vpp-opensuse/
-
diff --git a/docs/gettingstarted/users/installing/packages.rst b/docs/gettingstarted/users/installing/packages.rst
deleted file mode 100644
index 55ddf05fdad..00000000000
--- a/docs/gettingstarted/users/installing/packages.rst
+++ /dev/null
@@ -1,85 +0,0 @@
-.. _packages:
-
-Packages
-==========
-
-This section identifies the different VPP packages and describes their contents.
-
-.. toctree::
-
-vpp
----
-
-Vector Packet Processing executables. This is the primary package that must be
-installed to use VPP. This package contains:
-
-* vpp - the vector packet engine
-* vpp_api_test - vector packet engine API test tool
-* vpp_json_test - vector packet engine JSON test tool
-
-vpp-lib
--------
-
-Vector Packet Processing runtime libraries. The *'vpp'* package depends on this
-package, so it will always be installed. This package contains the VPP shared
-libraries, including:
-
-* vppinfra - Foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
-* svm - vm library
-* vlib - vector processing library
-* vlib-api - binary API library
-* vnet - network stack library
-
-vpp-plugins
------------
-
-Vector Packet Processing plugin modules.
-
-* acl
-* dpdk
-* flowprobe
-* gtpu
-* ixge
-* kubeproxy
-* l2e
-* lb
-* memif
-* nat
-* pppoe
-* sixrd
-* stn
-
-vpp-dbg
--------
-
-Vector Packet Processing debug symbols.
-
-vpp-dev
--------
-
-Vector Packet Processing development support. This package contains
-development support files for the VPP libraries.
-
-vpp-api-java
-------------
-
-JAVA binding for the VPP Binary API.
-
-vpp-api-python
---------------
-
-Python binding for the VPP Binary API.
-
-vpp-api-lua
------------
-
-Lua binding for the VPP Binary API.
-
-vpp-selinux-policy
-------------------
-
-This package contains the VPP Custom SELinux Policy. It is only generated for
-Fedora and CentOS distros. For those distros, the *'vpp'* package depends on
-this package, so it will always be installed. It 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.
diff --git a/docs/gettingstarted/users/installing/ubuntu.rst b/docs/gettingstarted/users/installing/ubuntu.rst
deleted file mode 100644
index d1daed14ddb..00000000000
--- a/docs/gettingstarted/users/installing/ubuntu.rst
+++ /dev/null
@@ -1,87 +0,0 @@
-.. _ubuntu:
-
-.. toctree::
-
-Ubuntu 16.04 - Setup the fd.io Repository
-==========================================
-
-Choose one of the following releases to install.
-
-
-Update the OS
------------------------
-
-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
-
- apt-get update
-
-
-Point to the Repository
------------------------------------
-
-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:
-
-VPP latest Release
-^^^^^^^^^^^^^^^^^^^
-
-Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
-
-.. code-block:: console
-
- deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./
-
-
-VPP stable/1804 Branch
-^^^^^^^^^^^^^^^^^^^^^^^
-
-Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
-
-.. code-block:: console
-
- deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.stable.1804.ubuntu.xenial.main/ ./
-
-
-VPP master Branch
-^^^^^^^^^^^^^^^^^^^^
-
-Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
-
-.. code-block:: console
-
- deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.master.ubuntu.xenial.main/ ./
-
-
-Install the Mandatory Packages
-===============================
-
-Install the mandatory packages by running the following commands:
-
-.. code-block:: console
-
- sudo apt-get update
- sudo apt-get install vpp-lib vpp vpp-plugins
-
-
-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
-
-
-Uninstall the Packages
-======================
-
-Uninstall the packages by running the following command:
-
-.. code-block:: console
-
- sudo apt-get remove --purge vpp*