Merge "[VOL-3961] Software update documentation"
diff --git a/index.rst b/index.rst
index 9656fd0..eba22b8 100644
--- a/index.rst
+++ b/index.rst
@@ -59,6 +59,7 @@
Deploy VOLTHA <voltha-helm-charts/README.md>
overview/workflows.rst
overview/operate.rst
+ overview/lab_setup.rst
overview/troubleshooting.rst
.. toctree::
diff --git a/overview/lab_setup.rst b/overview/lab_setup.rst
index 8c11c70..3f2ea22 100644
--- a/overview/lab_setup.rst
+++ b/overview/lab_setup.rst
@@ -87,15 +87,32 @@
# activate the interface
ip link set eth1 up
- # install the wpasupplicant tool
+ # install the required tools for testing
apt update
- apt install wpasupplicant
+ apt install -y wpasupplicant jq netsniff-ng build-essential tcpdump
..
- NOTE: ``wpasupplicant`` is a Linux tool to perform 802.1X authentication.
- `wpasupplicant documentation can be found here
- <https://help.ubuntu.com/community/WifiDocs/WPAHowTo>`_.
+In the lxc container you also need to install iperf3. Iperf3 needs to be installed from source to have some
+options used in VOLTHA tests.
+
+.. code:: bash
+
+ git clone https://github.com/esnet/iperf.git -b 3.9
+ cd iperf
+ ./configure && make && sudo make install
+ ldconfig
+
+..
+
+ NOTE:
+
+ - ``wpasupplicant`` is a Linux tool to perform 802.1X authentication. `wpasupplicant documentation can be found here <https://help.ubuntu.com/community/WifiDocs/WPAHowTo>`_.
+ - ``jq`` is a linux tool to perform json parsing. `More information on jq <https://stedolan.github.io/jq/>`_
+ - ``netsniff-ng`` installs maushezan, a linux tool to perform traffic generations. `More informations on mz <https://man7.org/linux/man-pages/man8/mausezahn.8.html>`_
+ - ``iperf3`` is a linux tool to perform speed tests. `More information on iperf3 <https://iperf.fr/>`_
+
+
Create a configuration file for ``wpasupplicant`` in
``/etc/wpa_supplicant/wpa_supplicant.conf`` with the content:
@@ -199,6 +216,73 @@
option domain-name-servers 8.8.8.8;
}
+Other BNG required tools
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some tools are required to perform data plane tests present in voltha-system-tests.
+The following commands install them:
+
+.. code:: bash
+
+ sudo apt update
+ sudo apt-get install -y jq netsniff-ng build-essential tcpdump
+
+..
+
+In the BNG you also need to install ``iperf3``. ``Iperf3`` needs to be installed from source to have some
+options used in the tests.
+
+.. code:: bash
+
+ #remove existing installation if any
+ sudo service iperf3 stop
+ sudo apt-get remove --purge iperf3
+ #Clone and install from source
+ git clone https://github.com/esnet/iperf.git -b 3.9
+ cd iperf
+ ./configure && make && sudo make install
+ sudo ldconfig
+
+..
+
+After installing ``iperf3`` on the BNG node it needs to be configured.
+Create the ``iperf3.service`` file:
+
+.. code:: bash
+
+ sudo vi /etc/systemd/system/iperf3.service
+
+..
+
+Include this content in the newly created file:
+
+.. code:: text
+
+ [Unit]
+ Description=iperf3
+ [Service]
+ ExecStart=/usr/local/bin/iperf3 --server
+ [Install]
+ WantedBy=multi-user.target
+
+..
+
+Start the ``iperf3`` service
+
+.. code:: bash
+
+ sudo service iperf3 start
+
+..
+
+Finally, check the ``iperf3`` service
+
+.. code:: bash
+
+ sudo service iperf3 status
+
+..
+
Configuration for in-band OLT control
-------------------------------------
diff --git a/release_notes/voltha_2.7.rst b/release_notes/voltha_2.7.rst
index 3df4159..6d338a7 100644
--- a/release_notes/voltha_2.7.rst
+++ b/release_notes/voltha_2.7.rst
@@ -164,7 +164,7 @@
- `ofagent-go <https://gerrit.opencord.org/gitweb?p=ofagent-go.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``1.5.2`` with chart ``2.8.3``
- `voltctl <https://gerrit.opencord.org/gitweb?p=voltctl.git;a=tree>`_ - ``1.4.4``
- `voltha-openolt-adapter <https://gerrit.opencord.org/gitweb?p=voltha-openolt-adapter.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``3.1.8`` with chart ``2.8.8``
-- `voltha-openonu-adapter-go <https://gerrit.opencord.org/gitweb?p=voltha-openonu-adapter-go.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``1.2.11`` with chart ``2.7.16``
+- `voltha-openonu-adapter-go <https://gerrit.opencord.org/gitweb?p=voltha-openonu-adapter-go.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``1.2.14`` with chart ``2.7.17``
- `voltha-onos <https://gerrit.opencord.org/gitweb?p=voltha-onos.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``4.3.1`` with chart ``0.1.13``
- `openolt agent <https://gerrit.opencord.org/gitweb?p=openolt.git;a=tree;h=refs/heads/voltha-2.7>`_ - ``3.3.3``
- `voltha-protos <https://github.com/opencord/voltha-protos/releases/tag/v4.0.5>`_ - ``4.0.16``
@@ -176,7 +176,7 @@
++++++++++++++++++++
This section refers to the macro charts to deploy the required infrastructure and a (or many) VOLTHA stacks:
- Voltha-infra: ``0.1.13``
-- Voltha-stack: ``0.1.18``
+- Voltha-stack: ``0.1.19``
**Available from EdgeCore site**
diff --git a/requirements.txt b/requirements.txt
index 3a3044c..2053e92 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,6 +2,7 @@
actdiag~=2.0.0
blockdiag~=1.5.4
doc8~=0.8.0
+docutils==0.16
nwdiag~=2.0.0
recommonmark~=0.6.0
seqdiag~=2.0.0