Updates all testcases and their results
[functest.git] / docs / testing / user / configguide / configguide.rst
index 07f0a16..25aa7cd 100644 (file)
@@ -17,8 +17,6 @@ Docker images are available on the dockerhub:
   * opnfv/functest-healthcheck
   * opnfv/functest-smoke
   * opnfv/functest-benchmarking
-  * opnfv/functest-features
-  * opnfv/functest-components
   * opnfv/functest-vnf
 
 
@@ -27,9 +25,13 @@ Preparing your environment
 
 cat env::
 
-  EXTERNAL_NETWORK=XXX
   DEPLOY_SCENARIO=XXX  # if not os-nosdn-nofeature-noha scenario
   NAMESERVER=XXX  # if not 8.8.8.8
+  EXTERNAL_NETWORK=XXX # if not first network with router:external=True
+  NEW_USER_ROLE=XXX # if not member
+  SDN_CONTROLLER_IP=XXX  # if odl scenario
+  VOLUME_DEVICE_NAME=XXX  # if not vdb
+  FLAVOR_EXTRA_SPECS=hw:mem_page_size:large    # if fdio scenarios
 
 See section on environment variables for details.
 
@@ -42,25 +44,22 @@ cat env_file::
   export OS_PROJECT_NAME=XXX
   export OS_PASSWORD=XXX
   export OS_IDENTITY_API_VERSION=3
+  export OS_REGION_NAME=XXX
 
 See section on OpenStack credentials for details.
 
 Create a directory for the different images (attached as a Docker volume)::
 
-  mkdir -p images && wget -q -O- https://git.opnfv.org/functest/plain/functest/ci/download_images.sh?h=stable/fraser | bash -s -- images && ls -1 images/*
+  mkdir -p images && wget -q -O- https://git.opnfv.org/functest/plain/functest/ci/download_images.sh | bash -s -- images && ls -1 images/*
 
-  images/CentOS-7-aarch64-GenericCloud.qcow2
-  images/CentOS-7-aarch64-GenericCloud.qcow2.xz
-  images/CentOS-7-x86_64-GenericCloud.qcow2
+  images/cirros-0.4.0-aarch64-disk.img
   images/cirros-0.4.0-x86_64-disk.img
-  images/cirros-0.4.0-x86_64-lxc.tar.gz
-  images/cloudify-manager-premium-4.0.1.qcow2
-  images/shaker-image-arm64.qcow2
-  images/shaker-image.qcow
+  images/cloudify-docker-manager-community-19.01.24.tar
+  images/shaker-image-1.3.0+stretch.qcow2
   images/ubuntu-14.04-server-cloudimg-amd64-disk1.img
   images/ubuntu-14.04-server-cloudimg-arm64-uefi1.img
   images/ubuntu-16.04-server-cloudimg-amd64-disk1.img
-  images/vyos-1.1.7.img
+  images/vyos-1.1.8-amd64.qcow2
 
 Testing healthcheck suite
 ^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -74,23 +73,22 @@ Run healthcheck suite::
 
 Results shall be displayed as follows::
 
-  +----------------------------+------------------+---------------------+------------------+----------------+
-  |         TEST CASE          |     PROJECT      |         TIER        |     DURATION     |     RESULT     |
-  +----------------------------+------------------+---------------------+------------------+----------------+
-  |      connection_check      |     functest     |     healthcheck     |      00:09       |      PASS      |
-  |       tenantnetwork1       |     functest     |     healthcheck     |      00:14       |      PASS      |
-  |       tenantnetwork2       |     functest     |     healthcheck     |      00:11       |      PASS      |
-  |          vmready1          |     functest     |     healthcheck     |      00:19       |      PASS      |
-  |          vmready2          |     functest     |     healthcheck     |      00:16       |      PASS      |
-  |         singlevm1          |     functest     |     healthcheck     |      00:41       |      PASS      |
-  |         singlevm2          |     functest     |     healthcheck     |      00:36       |      PASS      |
-  |         vping_ssh          |     functest     |     healthcheck     |      00:46       |      PASS      |
-  |       vping_userdata       |     functest     |     healthcheck     |      00:41       |      PASS      |
-  |        cinder_test         |     functest     |     healthcheck     |      01:18       |      PASS      |
-  |         api_check          |     functest     |     healthcheck     |      10:33       |      PASS      |
-  |     snaps_health_check     |     functest     |     healthcheck     |      00:44       |      PASS      |
-  |            odl             |     functest     |     healthcheck     |      00:00       |      SKIP      |
-  +----------------------------+------------------+---------------------+------------------+----------------+
+  +--------------------------+------------------+---------------------+------------------+----------------+
+  |        TEST CASE         |     PROJECT      |         TIER        |     DURATION     |     RESULT     |
+  +--------------------------+------------------+---------------------+------------------+----------------+
+  |     connection_check     |     functest     |     healthcheck     |      00:02       |      PASS      |
+  |      tenantnetwork1      |     functest     |     healthcheck     |      00:06       |      PASS      |
+  |      tenantnetwork2      |     functest     |     healthcheck     |      00:06       |      PASS      |
+  |         vmready1         |     functest     |     healthcheck     |      00:06       |      PASS      |
+  |         vmready2         |     functest     |     healthcheck     |      00:08       |      PASS      |
+  |        singlevm1         |     functest     |     healthcheck     |      00:28       |      PASS      |
+  |        singlevm2         |     functest     |     healthcheck     |      00:25       |      PASS      |
+  |        vping_ssh         |     functest     |     healthcheck     |      00:36       |      PASS      |
+  |      vping_userdata      |     functest     |     healthcheck     |      00:34       |      PASS      |
+  |       cinder_test        |     functest     |     healthcheck     |      01:03       |      PASS      |
+  |      tempest_smoke       |     functest     |     healthcheck     |      05:13       |      PASS      |
+  |           odl            |     functest     |     healthcheck     |      00:00       |      SKIP      |
+  +--------------------------+------------------+---------------------+------------------+----------------+
 
 NOTE: the duration is a reference and it might vary depending on your SUT.
 
@@ -109,16 +107,20 @@ Results shall be displayed as follows::
   +------------------------------------+------------------+---------------+------------------+----------------+
   |             TEST CASE              |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
   +------------------------------------+------------------+---------------+------------------+----------------+
-  |           tempest_smoke            |     functest     |     smoke     |      04:24       |      PASS      |
-  |     neutron-tempest-plugin-api     |     functest     |     smoke     |      10:43       |      PASS      |
-  |            rally_sanity            |     functest     |     smoke     |      23:16       |      PASS      |
-  |          refstack_defcore          |     functest     |     smoke     |      06:30       |      PASS      |
-  |              patrole               |     functest     |     smoke     |      02:08       |      PASS      |
-  |            snaps_smoke             |     functest     |     smoke     |      00:00       |      SKIP      |
-  |           neutron_trunk            |     functest     |     smoke     |      02:09       |      PASS      |
+  |     neutron-tempest-plugin-api     |     functest     |     smoke     |      09:12       |      PASS      |
+  |            rally_sanity            |     functest     |     smoke     |      16:29       |      PASS      |
+  |          refstack_compute          |     functest     |     smoke     |      06:25       |      PASS      |
+  |          refstack_object           |     functest     |     smoke     |      01:54       |      PASS      |
+  |         refstack_platform          |     functest     |     smoke     |      06:52       |      PASS      |
+  |            tempest_full            |     functest     |     smoke     |      30:26       |      PASS      |
+  |          tempest_scenario          |     functest     |     smoke     |      09:23       |      PASS      |
+  |            tempest_slow            |     functest     |     smoke     |      24:42       |      PASS      |
+  |              patrole               |     functest     |     smoke     |      02:36       |      PASS      |
+  |              barbican              |     functest     |     smoke     |      02:13       |      PASS      |
+  |           neutron_trunk            |     functest     |     smoke     |      00:00       |      SKIP      |
   |         networking-bgpvpn          |     functest     |     smoke     |      00:00       |      SKIP      |
   |           networking-sfc           |     functest     |     smoke     |      00:00       |      SKIP      |
-  |              barbican              |     functest     |     smoke     |      00:00       |      SKIP      |
+  |              octavia               |     functest     |     smoke     |      00:00       |      SKIP      |
   +------------------------------------+------------------+---------------+------------------+----------------+
 
 Note: if the scenario does not support some tests, they are indicated as SKIP.
@@ -136,63 +138,18 @@ Run benchmarking suite::
 
 Results shall be displayed as follows::
 
-  +-------------------+------------------+----------------------+------------------+----------------+
-  |     TEST CASE     |     PROJECT      |         TIER         |     DURATION     |     RESULT     |
-  +-------------------+------------------+----------------------+------------------+----------------+
-  |        vmtp       |     functest     |     benchmarking     |      18:43       |      PASS      |
-  |       shaker      |     functest     |     benchmarking     |      29:45       |      PASS      |
-  +-------------------+------------------+----------------------+------------------+----------------+
+  +--------------------+------------------+----------------------+------------------+----------------+
+  |     TEST CASE      |     PROJECT      |         TIER         |     DURATION     |     RESULT     |
+  +--------------------+------------------+----------------------+------------------+----------------+
+  |     rally_full     |     functest     |     benchmarking     |      92:16       |      PASS      |
+  |     rally_jobs     |     functest     |     benchmarking     |      18:49       |      PASS      |
+  |        vmtp        |     functest     |     benchmarking     |      15:28       |      PASS      |
+  |       shaker       |     functest     |     benchmarking     |      24:04       |      PASS      |
+  +--------------------+------------------+----------------------+------------------+----------------+
 
 Note: if the scenario does not support some tests, they are indicated as SKIP.
 See User guide for details.
 
-Testing features suite
-^^^^^^^^^^^^^^^^^^^^^^
-
-Run features suite::
-
-  sudo docker run --env-file env \
-      -v $(pwd)/openstack.creds:/home/opnfv/functest/conf/env_file \
-      -v $(pwd)/images:/home/opnfv/functest/images \
-      opnfv/functest-features
-
-Results shall be displayed as follows::
-
-  +-----------------------------+------------------------+------------------+------------------+----------------+
-  |          TEST CASE          |        PROJECT         |       TIER       |     DURATION     |     RESULT     |
-  +-----------------------------+------------------------+------------------+------------------+----------------+
-  |     doctor-notification     |         doctor         |     features     |      00:00       |      SKIP      |
-  |            bgpvpn           |         sdnvpn         |     features     |      00:00       |      SKIP      |
-  |       functest-odl-sfc      |          sfc           |     features     |      00:00       |      SKIP      |
-  |      barometercollectd      |       barometer        |     features     |      00:00       |      SKIP      |
-  |             fds             |     fastdatastacks     |     features     |      00:00       |      SKIP      |
-  |             vgpu            |        functest        |     features     |      00:00       |      SKIP      |
-  |         stor4nfv_os         |        stor4nfv        |     features     |      00:00       |      SKIP      |
-  +-----------------------------+------------------------+------------------+------------------+----------------+
-
-Note: if the scenario does not support some tests, they are indicated as SKIP.
-See User guide for details.
-
-Testing components suite
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-Run components suite::
-
-  sudo docker run --env-file env \
-      -v $(pwd)/openstack.creds:/home/opnfv/functest/conf/env_file \
-      -v $(pwd)/images:/home/opnfv/functest/images \
-      opnfv/functest-components
-
-Results shall be displayed as follows::
-
-  +--------------------------+------------------+--------------------+------------------+----------------+
-  |        TEST CASE         |     PROJECT      |        TIER        |     DURATION     |     RESULT     |
-  +--------------------------+------------------+--------------------+------------------+----------------+
-  |       tempest_full       |     functest     |     components     |      53:40       |      FAIL      |
-  |     tempest_scenario     |     functest     |     components     |      18:50       |      PASS      |
-  |        rally_full        |     functest     |     components     |      167:13      |      PASS      |
-  +--------------------------+------------------+--------------------+------------------+----------------+
-
 Testing vnf suite
 ^^^^^^^^^^^^^^^^^
 
@@ -208,11 +165,11 @@ Results shall be displayed as follows::
   +----------------------+------------------+--------------+------------------+----------------+
   |      TEST CASE       |     PROJECT      |     TIER     |     DURATION     |     RESULT     |
   +----------------------+------------------+--------------+------------------+----------------+
-  |       cloudify       |     functest     |     vnf      |      04:05       |      PASS      |
-  |     cloudify_ims     |     functest     |     vnf      |      24:07       |      PASS      |
-  |       heat_ims       |     functest     |     vnf      |      18:15       |      PASS      |
-  |     vyos_vrouter     |     functest     |     vnf      |      15:48       |      PASS      |
-  |       juju_epc       |     functest     |     vnf      |      29:38       |      PASS      |
+  |       cloudify       |     functest     |     vnf      |      03:49       |      PASS      |
+  |     cloudify_ims     |     functest     |     vnf      |      24:20       |      PASS      |
+  |       heat_ims       |     functest     |     vnf      |      32:13       |      PASS      |
+  |     vyos_vrouter     |     functest     |     vnf      |      14:55       |      PASS      |
+  |       juju_epc       |     functest     |     vnf      |      41:24       |      PASS      |
   +----------------------+------------------+--------------+------------------+----------------+
 
 Functest Dockers for Kubernetes deployment
@@ -222,7 +179,6 @@ Docker images are available on the dockerhub:
   * opnfv/functest-kubernetes-core
   * opnfv/functest-kubernetest-healthcheck
   * opnfv/functest-kubernetest-smoke
-  * opnfv/functest-kubernetest-features
 
 Preparing your environment
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -248,7 +204,7 @@ Results shall be displayed as follows::
   +-------------------+------------------+---------------------+------------------+----------------+
   |     TEST CASE     |     PROJECT      |         TIER        |     DURATION     |     RESULT     |
   +-------------------+------------------+---------------------+------------------+----------------+
-  |     k8s_smoke     |     functest     |     healthcheck     |      02:27       |      PASS      |
+  |     k8s_smoke     |     functest     |     healthcheck     |      01:09       |      PASS      |
   +-------------------+------------------+---------------------+------------------+----------------+
 
 Testing smoke suite
@@ -262,29 +218,12 @@ Run smoke suite::
 
 Results shall be displayed as follows::
 
-  +-------------------------+------------------+---------------+------------------+----------------+
-  |        TEST CASE        |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
-  +-------------------------+------------------+---------------+------------------+----------------+
-  |     k8s_conformance     |     functest     |     smoke     |      57:14       |      PASS      |
-  +-------------------------+------------------+---------------+------------------+----------------+
-
-Testing features suite
-^^^^^^^^^^^^^^^^^^^^^^
-
-Run features suite::
-
-  sudo docker run -it --env-file env \
-      -v $(pwd)/config:/root/.kube/config \
-      opnfv/functest-kubernetes-features
-
-Results shall be displayed as follows::
-
-  +----------------------+------------------+------------------+------------------+----------------+
-  |      TEST CASE       |     PROJECT      |       TIER       |     DURATION     |     RESULT     |
-  +----------------------+------------------+------------------+------------------+----------------+
-  |     stor4nfv_k8s     |     stor4nfv     |     stor4nfv     |      00:00       |      SKIP      |
-  |      clover_k8s      |      clover      |      clover      |      00:00       |      SKIP      |
-  +----------------------+------------------+------------------+------------------+----------------+
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |         TEST CASE         |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |     xrally_kubernetes     |     functest     |     smoke     |      22:04       |      PASS      |
+  |      k8s_conformance      |     functest     |     smoke     |      173:48      |      PASS      |
+  +---------------------------+------------------+---------------+------------------+----------------+
 
 Environment variables
 =====================
@@ -414,7 +353,7 @@ By default all the logs are put un /home/opnfv/functest/results/functest.log.
 If you want to have more logs in console, you may edit the logging.ini file
 manually.
 Connect on the docker then edit the file located in
-/usr/lib/python2.7/site-packages/xtesting/ci/logging.ini
+/usr/lib/python3.6/site-packages/xtesting/ci/logging.ini
 
 Change wconsole to console in the desired module to get more traces.
 
@@ -424,8 +363,8 @@ Configuration
 
 You may also directly modify the python code or the configuration file (e.g.
 testcases.yaml used to declare test constraints) under
-/usr/lib/python2.7/site-packages/xtesting and
-/usr/lib/python2.7/site-packages/functest
+/usr/lib/python3.6/site-packages/xtesting and
+/usr/lib/python3.6/site-packages/functest
 
 
 Tips
@@ -574,7 +513,7 @@ docker container::
 Note: In a Jumphost node based on the CentOS family OS, the **nc**
 commands might not work. You can use the **curl** command instead.
 
-  curl http://www.opnfv.org:80
+  curl https://www.opnfv.org/
 
   <HTML><HEAD><meta http-equiv="content-type"
   .
@@ -632,7 +571,6 @@ and install the **docker-engine**. The instructions conclude with a
 work with the above pre-requisite actions.
 
 
-.. _`[4]`: http://docs.opnfv.org/en/latest/submodules/functest/docs/testing/user/configguide/index.html
 .. _`dockerdocs`: https://docs.docker.com/
 .. _`Proxy`: https://docs.docker.com/engine/admin/systemd/#http-proxy
 .. _`Install Docker on CentOS`: https://docs.docker.com/engine/installation/linux/centos/