diff options
Diffstat (limited to 'docs/testing/user/instructionsperinstaller')
| -rw-r--r-- | docs/testing/user/instructionsperinstaller/index.rst | 14 | ||||
| -rw-r--r-- | docs/testing/user/instructionsperinstaller/testing_instructions_apex.rst | 158 |
2 files changed, 172 insertions, 0 deletions
diff --git a/docs/testing/user/instructionsperinstaller/index.rst b/docs/testing/user/instructionsperinstaller/index.rst new file mode 100644 index 00000000..adc20f71 --- /dev/null +++ b/docs/testing/user/instructionsperinstaller/index.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV + +.. _dovetail-testing_user_guide_per_installer: + +====================================== +OVP Testing User Guide per Installer +====================================== + +.. toctree:: + :maxdepth: 2 + + testing_instructions_apex.rst diff --git a/docs/testing/user/instructionsperinstaller/testing_instructions_apex.rst b/docs/testing/user/instructionsperinstaller/testing_instructions_apex.rst new file mode 100644 index 00000000..fb2e2bdd --- /dev/null +++ b/docs/testing/user/instructionsperinstaller/testing_instructions_apex.rst @@ -0,0 +1,158 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Huawei Technologies Co.,Ltd and others. + +=========================================================== +Conducting OVP Testing with Dovetail using APEX installer +=========================================================== + +Overview +------------------------------ +The purpose of this document is to give tips for the dovetail deployment +on APEX installer. +The general structure of the document is remaining according to the user guide +document and the APEX related tips will be added under of the respective +chapter's name. + + +Installing Dovetail +-------------------- + + +Checking the Test Host Readiness +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Installing Prerequisite Packages on the Test Host +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Configuring the Test Host Environment +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In order to run the test scenarios properly and having access to all OS components +that each scenario needs, the undercloud credentials should be used and copied in the +docker container along with ssh key. + +The environment preparation should be applied on the Test Host environment. +Therefore, the containers which are going to be used as part of this configuration, +fetch the information, the files and the rest input from Test Host environment directly +as part of the Docker command. + +Setting up Primary Configuration File +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Two new environment variables could be introduced in the ``env_config.sh`` file. + + +.. code-block:: bash + + # Set the name of the installer type as environment variable (e.g. apex, fuel, etc) + # Optional parameter + export INSTALLER_TYPE=xxxx + + # Set the deployed scenario name (e.g. os-sdn-nofeature-noha) + # Optional parameter + export DEPLOY_SCENARIO=xxxx + +For the OS_PASSWORD, OpenStack password from undercloud environment should be used. + + +Configuration for Running Tempest Test Cases (Mandatory) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Configuration for Running HA Test Cases (Mandatory) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Below is a sample of ``${DOVETAIL_HOME}/pre_config/pod.yaml`` file with +the required syntax when key_filename is used instead of password is employed +by the controller. +Moreover, the 'heat-admin' should be used as user. + +.. code-block:: bash + + nodes: + - + # This can not be changed and must be node0. + name: node0 + + # This must be Jumpserver. + role: Jumpserver + + # This is the instance IP of a node which has ipmitool installed. + ip: xx.xx.xx.xx + + # User name of the user of this node. This user **must** have sudo privileges. + user: heat-admin + + # Password of the user. + #password: root + key_filename: /root/.ssh/id_rsa + + - + # This can not be changed and must be node1. + name: node1 + + # This must be controller. + role: Controller + + # This is the instance IP of a controller node, which is the haproxy primary node + ip: xx.xx.xx.xx + + # User name of the user of this node. This user **must** have sudo privileges. + user: heat-admin + + # Password of the user. + #password: root + key_filename: /root/.ssh/id_rsa + + process_info: + - + # The default attack process of yardstick.ha.rabbitmq is 'rabbitmq-server'. + # Here can be reset to 'rabbitmq'. + testcase_name: yardstick.ha.rabbitmq + attack_process: rabbitmq + + - + # The default attack host for all HA test cases is 'node1'. + # Here can be reset to any other node given in the section 'nodes'. + testcase_name: yardstick.ha.glance_api + attack_host: node2 + + + +Configuration of Hosts File (Optional) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Installing Dovetail on the Test Host +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Online Test Host +"""""""""""""""" + + +Offline Test Host +""""""""""""""""" + + +Starting Dovetail Docker +------------------------ + + +Running the OVP Test Suite +---------------------------- + + +Making Sense of OVP Test Results +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +OVP Portal Web Interface +------------------------ + + +Updating Dovetail or a Test Suite +--------------------------------- |