######################
The Getting Started Guide is comprised of several different sections; a User section
-that describes a basic installation and configuration of VPP (either manually or using
-a config utility), another install for Developers, which contains additional code that
-provides tools that are used in a development environment.
+that describes a basic installation and configuration of VPP (either manually or
+using a config utility), another install for Developers, which contains additional
+code that provides tools that are used in a development environment.
-The Users section covers basic VPP installation and configuration operations; this
-section covers the following areas:
+This section covers the following:
-* Describes the different types of VPP packages, which are used in both basic and developer installs.
* Describes how to manually install VPP Binaries on different OS platforms (Ubuntu, Centos, openSUSE) and then how to configure and use VPP.
-* Explains how to use the Configuration Utility to install, and then configure VPP.
+* Describes the different types of VPP packages, which are used in both basic and developer installs.
+* A VPP tutorial which is a great way to learn VPP basics.
+
+The Users section covers configuration operations; this
+
+* How to configure and Run VPP manually.
+* How to use the Configuration Utility to install, and then configure VPP.
The Developers section covers the following areas:
.. toctree::
:maxdepth: 2
+ installing/index.rst
progressivevpp/index.rst
users/index.rst
developers/index.rst
.. _installingVPP:
-Installing VPP from Packages
+Downloading and Installing VPP
==============================
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::
:maxdepth: 2
configutil/index.rst
- installing/index.rst
configuring/index.rst
running/index.rst
+++ /dev/null
-.. _api:
-
-.. toctree::
-
-
-API User Guides
-===============
-
-This chapter describes how to use the C, Python and java APIs.
-
-.. _jvppjar:
-
-Downloading the jvpp jar
-------------------------
-The following are instructions on how to download the jvpp jar
-
-.. toctree::
-
- jvpp
+++ /dev/null
-.. _guides:
-
-=========================================
-User Guides
-=========================================
-
-.. toctree::
- :maxdepth: 2
-
- api/index.rst
links/index
usecases/index
troubleshooting/index
- guides/index
events/index
reference/index
:maxdepth: 2
vppvagrant/index.rst
+ jvpp.rst
readthedocs/index.rst
github/index.rst
cmdreference/index.rst
.. toctree::
Getting jvpp jar
--------------------
+================
+
VPP provides java bindings which can be downloaded at:
* https://nexus.fd.io/content/repositories/fd.io.release/io/fd/vpp/jvpp-core/18.01/jvpp-core-18.01.jar
Getting jvpp via maven
--------------------------
+------------------------------------
**1. Add the following to the repositories section in your ~/.m2/settings.xml to pick up the fd.io maven repo:**
containers
vhost/index.rst
homegateway
- uc_vSwitchvRouter
+++ /dev/null
-.. _vswitch:
-
-.. toctree::
-
-.. _vswitchrtr:
-
-vSwitch/vRouter
-===============
-
-
-FD.io VPP as a vSwitch/vRouter
-------------------------------
-
-.. note::
-
- We need to provide commands and and show how to use VPP as a vSwitch/vRouter
-
-One of the use cases for the FD.io VPP platform is to implement it as a
-virtual switch or router. The following section describes examples of
-possible implementations that can be created with the FD.io VPP platform. For
-more in depth descriptions about other possible use cases, see the list
-of
-
-.. figure:: /_images/VPP_App_as_a_vSwitch_x201.jpg
- :alt: Figure: Linux host as a vSwitch
- :align: right
-
- Figure: Linux host as a vSwitch
-
-You can use the FD.io VPP platform to create out-of-the-box virtual switches
-(vSwitch) and virtual routers (vRouter). The FD.io VPP platform allows you to
-manage certain functions and configurations of these application through
-a command-line interface (CLI).
-
-Some of the functionality that a switching application can create
-includes:
-
-* Bridge Domains
-* Ports (including tunnel ports)
-* Connect ports to bridge domains
-* Program ARP termination
-
-Some of the functionality that a routing application can create
-includes:
-
-* Virtual Routing and Forwarding (VRF) tables (in the thousands)
-* Routes (in the millions)