diff options
Diffstat (limited to 'docs')
| -rwxr-xr-x | docs/all/index.rst | 34 | ||||
| -rwxr-xr-x | docs/release/NEWS.rst | 4 | ||||
| -rw-r--r-- | docs/release/index.rst | 9 | ||||
| -rw-r--r-- | docs/userguides/index.rst | 10 | ||||
| -rwxr-xr-x | docs/userguides/installation.rst | 21 | ||||
| -rwxr-xr-x | docs/userguides/quickstart.rst | 44 |
6 files changed, 122 insertions, 0 deletions
diff --git a/docs/all/index.rst b/docs/all/index.rst new file mode 100755 index 0000000..7917dbc --- /dev/null +++ b/docs/all/index.rst @@ -0,0 +1,34 @@ +.. Open vSwitch for NFV Documentation master file. + +==================== +Open vSwitch for NFV +==================== +Welcome to OVSNFV's documentation ! + +.. _OVSNFV: https://wiki.opnfv.org/open_vswitch_for_nfv +.. _REPO: https://opnfv.org/gerrit/ovsnfv + +OVSNFV_ is an OPNFV collaborative development project. + +The OVSNFV project proposes: + +* To modify the OPNFV build to include a deployment option for the + software-accelerated userspace Open vSwitch build. This change will + significantly improve the performance of the NFVI for network I/O. +* Future work to encompass collaborative development within the Open + vSwitch project to improve the performance of the software-accelerated + userspace Open vSwitch and increasing its suitability for Telco NFV + deployments. + +.. toctree:: + :maxdepth: 3 + :numbered: 5 + + http://artifacts.opnfv.org/ovsnfv/docs/userguides/index.html + http://artifacts.opnfv.org/ovsnfv/docs/release/index.html + + +Indices +======= +* :ref:`search` + diff --git a/docs/release/NEWS.rst b/docs/release/NEWS.rst new file mode 100755 index 0000000..ce0e550 --- /dev/null +++ b/docs/release/NEWS.rst @@ -0,0 +1,4 @@ +January 2016 +============ + +- Initial Release of OVSNFV Fuel Plugin. diff --git a/docs/release/index.rst b/docs/release/index.rst new file mode 100644 index 0000000..68faf3e --- /dev/null +++ b/docs/release/index.rst @@ -0,0 +1,9 @@ +*********** +OVSNFV News +*********** + +.. toctree:: + :numbered: + :maxdepth: 3 + + NEWS.rst diff --git a/docs/userguides/index.rst b/docs/userguides/index.rst new file mode 100644 index 0000000..a03372f --- /dev/null +++ b/docs/userguides/index.rst @@ -0,0 +1,10 @@ +****************************** +OVSNFV Guides and Installation +****************************** + +.. toctree:: + :numbered: + :maxdepth: 3 + + quickstart.rst + installation.rst diff --git a/docs/userguides/installation.rst b/docs/userguides/installation.rst new file mode 100755 index 0000000..c2a0cd2 --- /dev/null +++ b/docs/userguides/installation.rst @@ -0,0 +1,21 @@ +============================= +Installing OVSNFV Fuel Plugin +============================= + +* On the Fuel UI, create a new environment. +* In Settings > Userspace OVS support, check "Userspace OVS support". +* Continue with environment configuration and deployment as normal. + +Upgrading the plugin +-------------------- + +From time to time new versions of the plugin may become available. + +The plugin cannot be upgraded if an active environment is using the plugin. + +In order to upgrade the plugin: + +* Copy the updated plugin file to the fuel-master. +* On the Fuel UI, reset the environment. +* On the Fuel CLI "fuel plugins --update <fuel-plugin-file>" +* On the Fuel UI, re-deploy the environment. diff --git a/docs/userguides/quickstart.rst b/docs/userguides/quickstart.rst new file mode 100755 index 0000000..d23085c --- /dev/null +++ b/docs/userguides/quickstart.rst @@ -0,0 +1,44 @@ +============ +Open vSwitch +============ + +Open vSwtich (OVS) is a software switch commonly used in OpenStack deployments +to replace Linux bridges as it offers advantages in terms of mobility, hardware +integration and use by network controllers. + +================ +OPNFV Installers +================ + +Currently not all installers are supported. + +Fuel Installer +-------------- + +OVSNFV project supplies a Fuel Plugin to upgrades Open vSwitch on an OPNFV +installation to use user-space datapath. + +As part of the upgrade the following changes are also made: + +* change libvirt on compute node to 1.2.12 +* change qemu on compute node to 2.2.1 +* installs DPDK 2.0.0 +* installs OVS 2.1 (specifically git tag 1e77bbe) +* removes existing OVS neutron plugin +* installs new OVS plugin as part of networking_ovs_dpdk OpenStack plugin + version stable/kilo +* work around _set_device_mtu issue + +Limitations +~~~~~~~~~~~ + +This release should be considered experimental. In particular: + +* performance will be addressed specifically in subsequent releases. +* OVS and other components are updated only on compute nodes. + +Bugs +~~~~ + +* There may be issues assigning floating and public ip address to VMs. + |