Update K8s test case results in doc
[functest.git] / docs / testing / user / configguide / configguide.rst
index 06d8318..a6cc7b4 100644 (file)
@@ -13,12 +13,11 @@ Functest Dockers for OpenStack deployment
 -----------------------------------------
 Docker images are available on the dockerhub:
 
-  * opnfv/functest-core
   * opnfv/functest-healthcheck
   * opnfv/functest-smoke
+  * opnfv/functest-smoke-cntt
   * opnfv/functest-benchmarking
-  * opnfv/functest-features
-  * opnfv/functest-components
+  * opnfv/functest-benchmarking-cntt
   * opnfv/functest-vnf
 
 
@@ -27,9 +26,14 @@ 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
+  DASHBOARD_URL=XXX  # else tempest_horizon will be skipped
+  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 +46,23 @@ 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-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/cirros-0.5.1-aarch64-disk.img
+  images/cirros-0.5.1-x86_64-disk.img
+  images/cloudify-docker-manager-community-19.01.24.tar
+  images/Fedora-Cloud-Base-30-1.2.x86_64.qcow2
+  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 +76,23 @@ 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:03       |      PASS      |
+  |      tenantnetwork1      |     functest     |     healthcheck     |      00:05       |      PASS      |
+  |      tenantnetwork2      |     functest     |     healthcheck     |      00:06       |      PASS      |
+  |         vmready1         |     functest     |     healthcheck     |      00:06       |      PASS      |
+  |         vmready2         |     functest     |     healthcheck     |      00:08       |      PASS      |
+  |        singlevm1         |     functest     |     healthcheck     |      00:32       |      PASS      |
+  |        singlevm2         |     functest     |     healthcheck     |      00:37       |      PASS      |
+  |        vping_ssh         |     functest     |     healthcheck     |      00:46       |      PASS      |
+  |      vping_userdata      |     functest     |     healthcheck     |      00:39       |      PASS      |
+  |       cinder_test        |     functest     |     healthcheck     |      01:05       |      PASS      |
+  |      tempest_smoke       |     functest     |     healthcheck     |      05:39       |      PASS      |
+  |     tempest_horizon      |     functest     |     healthcheck     |      01:05       |      PASS      |
+  |           odl            |     functest     |     healthcheck     |      00:00       |      SKIP      |
+  +--------------------------+------------------+---------------------+------------------+----------------+
 
 NOTE: the duration is a reference and it might vary depending on your SUT.
 
@@ -106,93 +108,98 @@ Run smoke suite::
 
 Results shall be displayed as follows::
 
-  +------------------------------------+------------------+---------------+------------------+----------------+
-  |             TEST CASE              |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
-  +------------------------------------+------------------+---------------+------------------+----------------+
-  |           tempest_smoke            |     functest     |     smoke     |      06:13       |      PASS      |
-  |     neutron-tempest-plugin-api     |     functest     |     smoke     |      09:32       |      PASS      |
-  |            rally_sanity            |     functest     |     smoke     |      29:34       |      PASS      |
-  |             rally_jobs             |     functest     |     smoke     |      24:02       |      PASS      |
-  |          refstack_defcore          |     functest     |     smoke     |      13:07       |      PASS      |
-  |              patrole               |     functest     |     smoke     |      05:17       |      PASS      |
-  |            snaps_smoke             |     functest     |     smoke     |      90: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     |      05:01       |      PASS      |
-  +------------------------------------+------------------+---------------+------------------+----------------+
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |         TEST CASE         |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |      tempest_neutron      |     functest     |     smoke     |      15:30       |      PASS      |
+  |       tempest_cinder      |     functest     |     smoke     |      02:01       |      PASS      |
+  |      tempest_keystone     |     functest     |     smoke     |      01:17       |      PASS      |
+  |        tempest_heat       |     functest     |     smoke     |      22:14       |      PASS      |
+  |     tempest_telemetry     |     functest     |     smoke     |      00:00       |      SKIP      |
+  |        rally_sanity       |     functest     |     smoke     |      17:24       |      PASS      |
+  |      refstack_compute     |     functest     |     smoke     |      07:03       |      PASS      |
+  |      refstack_object      |     functest     |     smoke     |      02:09       |      PASS      |
+  |     refstack_platform     |     functest     |     smoke     |      07:31       |      PASS      |
+  |        tempest_full       |     functest     |     smoke     |      41:52       |      PASS      |
+  |      tempest_scenario     |     functest     |     smoke     |      08:42       |      PASS      |
+  |        tempest_slow       |     functest     |     smoke     |      43:42       |      PASS      |
+  |          patrole          |     functest     |     smoke     |      02:42       |      PASS      |
+  |      tempest_barbican     |     functest     |     smoke     |      02:30       |      PASS      |
+  |      tempest_octavia      |     functest     |     smoke     |      00:00       |      SKIP      |
+  +---------------------------+------------------+---------------+------------------+----------------+
 
 Note: if the scenario does not support some tests, they are indicated as SKIP.
 See User guide for details.
 
-Testing benchmarking suite
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+Testing smoke CNTT suite
+^^^^^^^^^^^^^^^^^^^^^^^^
 
-Run benchmarking suite::
+Run smoke-cntt 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-benchmarking
+      opnfv/functest-smoke-cntt
 
 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     |
+  +-------------------------------+------------------+---------------+------------------+----------------+
+  |      tempest_neutron_cntt     |     functest     |     smoke     |      11:35       |      PASS      |
+  |      tempest_cinder_cntt      |     functest     |     smoke     |      01:58       |      PASS      |
+  |     tempest_keystone_cntt     |     functest     |     smoke     |      01:13       |      PASS      |
+  |       tempest_heat_cntt       |     functest     |     smoke     |      22:32       |      PASS      |
+  |       rally_sanity_cntt       |     functest     |     smoke     |      17:16       |      PASS      |
+  |       tempest_full_cntt       |     functest     |     smoke     |      41:13       |      PASS      |
+  |     tempest_scenario_cntt     |     functest     |     smoke     |      08:57       |      PASS      |
+  |       tempest_slow_cntt       |     functest     |     smoke     |      35:58       |      PASS      |
+  +-------------------------------+------------------+---------------+------------------+----------------+
 
-Note: if the scenario does not support some tests, they are indicated as SKIP.
-See User guide for details.
-
-Testing features suite
-^^^^^^^^^^^^^^^^^^^^^^
+Testing benchmarking suite
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Run features suite::
+Run benchmarking 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
+      opnfv/functest-benchmarking
 
 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      |
-  +-----------------------------+------------------------+------------------+------------------+----------------+
+  +--------------------+------------------+----------------------+------------------+----------------+
+  |     TEST CASE      |     PROJECT      |         TIER         |     DURATION     |     RESULT     |
+  +--------------------+------------------+----------------------+------------------+----------------+
+  |     rally_full     |     functest     |     benchmarking     |      93:03       |      PASS      |
+  |     rally_jobs     |     functest     |     benchmarking     |      27:05       |      PASS      |
+  |        vmtp        |     functest     |     benchmarking     |      17:56       |      PASS      |
+  |       shaker       |     functest     |     benchmarking     |      24:02       |      PASS      |
+  +--------------------+------------------+----------------------+------------------+----------------+
 
 Note: if the scenario does not support some tests, they are indicated as SKIP.
 See User guide for details.
 
-Testing components suite
-^^^^^^^^^^^^^^^^^^^^^^^^
+Testing benchmarking CNTT suite
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Run components suite::
+Run benchmarking-cntt 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
+      opnfv/functest-benchmarking-cntt
 
 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      |
-  +--------------------------+------------------+--------------------+------------------+----------------+
+  +-------------------------+------------------+----------------------+------------------+----------------+
+  |        TEST CASE        |     PROJECT      |         TIER         |     DURATION     |     RESULT     |
+  +-------------------------+------------------+----------------------+------------------+----------------+
+  |     rally_full_cntt     |     functest     |     benchmarking     |      89:52       |      PASS      |
+  |     rally_jobs_cntt     |     functest     |     benchmarking     |      19:39       |      PASS      |
+  |           vmtp          |     functest     |     benchmarking     |      16:59       |      PASS      |
+  |          shaker         |     functest     |     benchmarking     |      23:43       |      PASS      |
+  +-------------------------+------------------+----------------------+------------------+----------------+
 
 Testing vnf suite
 ^^^^^^^^^^^^^^^^^
@@ -209,21 +216,22 @@ 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      |      05:08       |      PASS      |
+  |     cloudify_ims     |     functest     |     vnf      |      24:46       |      PASS      |
+  |       heat_ims       |     functest     |     vnf      |      33:12       |      PASS      |
+  |     vyos_vrouter     |     functest     |     vnf      |      15:53       |      PASS      |
+  |       juju_epc       |     functest     |     vnf      |      27:52       |      PASS      |
   +----------------------+------------------+--------------+------------------+----------------+
 
 Functest Dockers for Kubernetes deployment
 ------------------------------------------
 Docker images are available on the dockerhub:
 
-  * opnfv/functest-kubernetes-core
-  * opnfv/functest-kubernetest-healthcheck
-  * opnfv/functest-kubernetest-smoke
-  * opnfv/functest-kubernetest-features
+  * opnfv/functest-kubernetes-healthcheck
+  * opnfv/functest-kubernetes-smoke
+  * opnfv/functest-kubernetes-security
+  * opnfv/functest-kubernetes-benchmarking
+  * opnfv/functest-kubernetes-cnf
 
 Preparing your environment
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -249,7 +257,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
@@ -263,34 +271,69 @@ Run smoke suite::
 
 Results shall be displayed as follows::
 
-  +-------------------------+------------------+---------------+------------------+----------------+
-  |        TEST CASE        |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
-  +-------------------------+------------------+---------------+------------------+----------------+
-  |     k8s_conformance     |     functest     |     smoke     |      57:14       |      PASS      |
-  +-------------------------+------------------+---------------+------------------+----------------+
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |         TEST CASE         |     PROJECT      |      TIER     |     DURATION     |     RESULT     |
+  +---------------------------+------------------+---------------+------------------+----------------+
+  |      k8s_conformance      |     functest     |     smoke     |      94:26       |      PASS      |
+  |     xrally_kubernetes     |     functest     |     smoke     |      13:05       |      PASS      |
+  +---------------------------+------------------+---------------+------------------+----------------+
 
-Testing features suite
+Testing security suite
 ^^^^^^^^^^^^^^^^^^^^^^
 
-Run features suite::
+Run smoke suite::
+
+  sudo docker run -it --env-file env \
+      -v $(pwd)/config:/root/.kube/config \
+      opnfv/functest-kubernetes-security
+
+Results shall be displayed as follows::
+
+  +---------------------+------------------+------------------+------------------+----------------+
+  |      TEST CASE      |     PROJECT      |       TIER       |     DURATION     |     RESULT     |
+  +---------------------+------------------+------------------+------------------+----------------+
+  |     kube_hunter     |     functest     |     security     |      00:24       |      PASS      |
+  |      kube_bench     |     functest     |     security     |      00:18       |      PASS      |
+  +---------------------+------------------+------------------+------------------+----------------+
+
+Testing benchmarking suite
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Run benchmarking suite::
+
+  sudo docker run -it --env-file env \
+      -v $(pwd)/config:/root/.kube/config \
+      opnfv/functest-kubernetes-benchmarking
+
+Results shall be displayed as follows::
+
+  +--------------------------------+------------------+----------------------+------------------+----------------+
+  |           TEST CASE            |     PROJECT      |         TIER         |     DURATION     |     RESULT     |
+  +--------------------------------+------------------+----------------------+------------------+----------------+
+  |     xrally_kubernetes_full     |     functest     |     benchmarking     |      34:16       |      PASS      |
+  +--------------------------------+------------------+----------------------+------------------+----------------+
+
+Testing cnf suite
+^^^^^^^^^^^^^^^^^
+
+Run cnf suite::
 
   sudo docker run -it --env-file env \
       -v $(pwd)/config:/root/.kube/config \
-      opnfv/functest-kubernetes-features
+      opnfv/functest-kubernetes-cnf
 
 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     |
+  +-------------------+------------------+--------------+------------------+----------------+
+  |      k8s_vims     |     functest     |     cnf      |      19:12       |      PASS      |
+  +-------------------+------------------+--------------+------------------+----------------+
 
 Environment variables
 =====================
 
-Several environement variables may be specified:
+Several environment variables may be specified:
 
   * INSTALLER_IP=<Specific IP Address>
   * DEPLOY_SCENARIO=<vim>-<controller>-<nfv_feature>-<ha_mode>
@@ -415,7 +458,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.8/site-packages/xtesting/ci/logging.ini
 
 Change wconsole to console in the desired module to get more traces.
 
@@ -425,8 +468,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.8/site-packages/xtesting and
+/usr/lib/python3.8/site-packages/functest
 
 
 Tips
@@ -575,7 +618,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"
   .
@@ -633,11 +676,10 @@ 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/
 .. _`Functest User Guide`: http://docs.opnfv.org/en/stable-danube/submodules/functest/docs/testing/user/userguide/index.html
 .. _`images/CentOS-7-x86_64-GenericCloud.qcow2`: https://cloud.centos.org/centos/7/images/CentOS-7-x86_64-GenericCloud.qcow2
-.. _`images/cirros-0.4.0-x86_64-disk.img`: http://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img
+.. _`images/cirros-0.5.1-x86_64-disk.img`: http://download.cirros-cloud.net/0.5.1/cirros-0.5.1-x86_64-disk.img
 .. _`images/ubuntu-14.04-server-cloudimg-amd64-disk1.img`: https://cloud-images.ubuntu.com/releases/14.04/release/ubuntu-14.04-server-cloudimg-amd64-disk1.img