1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
8 You have two options to test Doctor functions with the script developed
11 You need to install OpenStack and other OPNFV components except Doctor Sample
12 Inspector, Sample Monitor and Sample Consumer, as these will be launched in
13 this script. You are encouraged to use OPNFV offcial installers, but you can
14 also deploy all components with other installers such as devstack or manual
15 operation. In those cases, the versions of all components shall be matched with
16 the versions of them in OPNFV specific release.
21 Doctor project has own testing script under `doctor/tests`_. This test script
22 can be used for functional testing agained an OPNFV deployment.
24 .. _doctor/tests: https://gerrit.opnfv.org/gerrit/gitweb?p=doctor.git;a=tree;f=tests;
26 Before running this script, make sure OpenStack env parameters are set properly
27 following `OpenStack CLI manual`_, so that Doctor Inspector can operate
30 .. _OpenStack CLI manual: https://docs.openstack.org/user-guide/common/cli-set-environment-variables-using-openstack-rc.html
32 Then, you can run the script as follows:
36 git clone https://gerrit.opnfv.org/gerrit/doctor
38 export INSTALLER_TYPE=local
39 export INSPECTOR_TYPE=sample
42 INSTALLER_TYPE can be 'apex', 'fuel', 'joid' and 'local'(default). If you are
43 not using OPNFV installers in this option, chose 'local'.
44 INSPECTOR_TYPE can be specified either 'sample'(default) or 'congress'.
46 For testing with stable version, checkout stable branch of doctor repo before
52 Functest supports Doctor testing by triggering the test script above in a
53 Functest container. You can run the Doctor test with the following steps:
58 docker pull opnfv/functest:${DOCKER_TAG}
59 docker run --privileged=true -id \
60 -e INSTALLER_TYPE=${INSTALLER_TYPE} \
61 -e INSTALLER_IP=${INSTALLER_IP} \
62 -e INSPECTOR_TYPE=sample \
63 opnfv/functest:${DOCKER_TAG} /bin/bash
64 docker exec <container_id> python /home/opnfv/repos/functest/functest/ci/prepare_env.py start
65 docker exec <container_id> functest testcase run doctor
67 See `Functest Userguide`_ for more information.
69 .. _Functest Userguide: http://artifacts.opnfv.org/functest/docs/userguide/index.html
71 For testing with stable version, change DOCKER_TAG to 'stable' or other release