From 137ca3bf6f6da44aebcaabfae4d017c28c37fb41 Mon Sep 17 00:00:00 2001 From: Morgan Richomme Date: Fri, 11 Dec 2015 15:06:07 +0100 Subject: First upload of Functest Doc for Brahmaputra Installation and user Guide JIRA: FUNCTEST-112, FUNCTEST-113 Change-Id: I8c0210684187be3102e7b4ad82f59082faeca470 Signed-off-by: Morgan Richomme --- docs/configguide/index.rst | 128 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 docs/configguide/index.rst (limited to 'docs/configguide') diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst new file mode 100644 index 000000000..47e430d21 --- /dev/null +++ b/docs/configguide/index.rst @@ -0,0 +1,128 @@ +=============================================== +OPNFV FUNCTEST configuration/installation guide +=============================================== + +.. contents:: + +------------ +Introduction +------------ + +** DOCUMENT IS IN PROGRESS FOR BRAHMAPUTRA ** + +.. _prereqs: + +------------- +Prerequisites +------------- + +The installation of the OPNFV solution is out of scope of this document but can be found XXX. +In the rest of the document the OPNFV solution would be considered as the System Under Test (SUT). + +The installation and configuration of the tools needed to perform the tests will be described in the following sections. + +Since Arno SR1, the tools are automatically installed. Manual sourcing of OpenStack credentials is no more required if you are fully integrated in the continuous integration. +A script has been added to automatically retrieve the credentials. +However, if you still install manually functest, you will need to source the rc file on the machine you are running the tests. +More details will be provided in the configuration section. + +.. _pharos: https://wiki.opnfv.org/pharos + +It is recommended to install the different tools on the jump host server as defined in the pharos_ project. + +For functest, the following libraries are needed. You can install them either with yum install or apt-get install, depending on your operating system: + * python-pip + * python-dev + * libffi-dev + * libxml2-dev + * libxslt1-dev + +You will also need some Python modules: + * sudo pip install GitPython + * sudo pip install python-novaclient + * sudo pip install python-neutronclient + * sudo pip install python-glanceclient + * sudo pip install python-keystoneclient + + +The high level architecture can be described as follow:: + + CIMC/Lights+out management Admin Private Public Storage + PXE + + + + + IP_PRIV/24 | | + | | + + | + | | | IP_PUB/24 | + | +-----------------+ | | + | + | | | | | | | + +-----+ Jumpserver | | | | | + | | +---------------------+ | | | + | | | | | | | + | | +----------+ | | | | | + | | | Rally | +---- --------------------------+ | | + | | | | | | | | | + | | | Robot | | | | | | + | | | | | | | | | + | | | vPing | | | | | | + | | | | | | | | | + | | | Tempest | | | | | | + | | +----------+ | | | | | + | | FuncTest +-----------------------------------------+ | + | | | | | | | + | | +--------------------------------------------------+ + | | | | | | | + | +-----------------+ | | | | + | | | | | + | +----------------+ | | | | + | | 1 | | | | | + +----+ +--------------+-+ | | | | + | | | 2 | | | | | + | | | +--------------+-+ | | | | + | | | | 3 | | | | | + | | | | +--------------+-+ | | | | + | | | | | 4 | | | | | + | +-+ | | +--------------+-+ | | | | + | | | | | 5 +---------------+ | | | + | +-+ | | nodes for | | | | | + | | | | deploying +-------------------------+ | | + | +-+ | opnfv | | | | | + | | | SUT +-----------------------------------+ | + | +-+ | | | | | + | | +--------------------------------------------+ + | +----------------+ | | | | + | | | | | + | + + + + + + +.. _tooling_installation: + +------------ +Installation +------------ + +------------- +Configuration +------------- + +----------------- +Integration in CI +----------------- + + + +---------- +References +---------- + +OPNFV main site: opnfvmain_. + +OPNFV functional test page: opnfvfunctest_. + +IRC support chan: #opnfv-testperf + +.. _opnfvmain: http://www.opnfv.org +.. _opnfvfunctest: https://wiki.opnfv.org/opnfv_functional_testing +.. _`OpenRC`: http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html +.. _`Rally installation procedure`: https://rally.readthedocs.org/en/latest/tutorial/step_0_installation.html +.. _`config_test.py` : https://git.opnfv.org/cgit/functest/tree/testcases/config_functest.py +.. _`config_functest.yaml` : https://git.opnfv.org/cgit/functest/tree/testcases/config_functest.yaml -- cgit 1.2.3-korg