1 ==============================================
2 OPNFV Brahmaputra3.0 release note for Functest
3 ==============================================
8 This document describes the release note of Functest project.
13 OPNFV Colorado release note for Functest Docs
14 (c) by Morgan Richomme (Orange)
16 OPNFV Colorado release note for Functest Docs
17 are licensed under a Creative Commons Attribution 4.0 International License.
18 You should have received a copy of the license along with this.
19 If not, see <http://creativecommons.org/licenses/by/4.0/>.
24 +------------+----------+------------------+------------------------+
25 | **Date** | **Ver.** | **Author** | **Comment** |
27 +------------+----------+------------------+------------------------+
28 | 2016-08-17 | 1.0.0 | Morgan Richomme | Functest for C release |
30 +------------+----------+------------------+------------------------+
32 OPNFV Colorado Release
33 =========================
35 Functest deals with functional testing of the OPNFV solution.
36 It includes test cases developed within the project and test cases developed in
37 other OPNFV projects and other upstream communities.
39 The internal test cases are:
44 * Tempest Smoke Serial
47 * Tempest full parallel
51 The OPNFV projects integrated into Functest framework for automation are:
66 The validation of a scenario requires a subset of these tests depending
67 on the installer and the scenario.
69 The 3 last internal test cases (tempest full parallel, Rally full and
70 vIMS) are not considered for scenario validation.
75 +--------------------------------------+--------------------------------------+
76 | **Project** | functest |
78 +--------------------------------------+--------------------------------------+
79 | **Repo/tag** | colorado.1.0 |
81 +--------------------------------------+--------------------------------------+
82 | **Release designation** | Colorado base release |
84 +--------------------------------------+--------------------------------------+
85 | **Release date** | September 22 2016 |
87 +--------------------------------------+--------------------------------------+
88 | **Purpose of the delivery** | Colorado base release |
90 +--------------------------------------+--------------------------------------+
98 - The Functest Docker image: * TODO link *
100 - The testapi Docker image: * TODO link *
106 - Installation/configuration guide: * TODO link *
108 - User Guide: * TODO link *
110 - Developer Guide: * TODO link *
119 - refactoring of ODL functional tests (with upstream modifications)
121 - refactoring of testapi (update, swagger documentation, dockerization)
123 - jenkins logs improvement
125 - update integration of Doctor, Promise and SDNVPN projects
127 - split Tempest and rally into 2 different tests: smoke and full
129 - vIMS test suite integration
131 - adoption of Kibana for dashboarding
137 - Functest CLI to prepare and run the tests
139 - creation of the healthcheck test case
141 - support new scenarios (ocl, odl_l2-sfc, onos-sfc, lxd, moon, multisite)
143 - integration of new OPNFV feature projects (copper, domino, multisite,
144 moon, parser, onos-sfc, odl-sfc, security scan)
146 - introduction of test tiers in functest framework
148 - automatic reporting
150 - introduction of a jenkins summary table
152 - support of ARM architecture
158 For Colorado 1.0, Functest was tested on the following scenarios (if not
159 precised, the scenario is a na scenario):
161 +---------------------+---------+---------+---------+---------+
162 | Scenario | Apex | Compass | Fuel | Joid |
163 +=====================+=========+=========+=========+=========+
164 | nosdn | X | X | X | X |
165 +---------------------+---------+---------+---------+---------+
166 | odl_l2 | X | X | X | X |
167 +---------------------+---------+---------+---------+---------+
168 | odl_l3 | X | X | X | |
169 +---------------------+---------+---------+---------+---------+
170 | onos | X | X | X | X |
171 +---------------------+---------+---------+---------+---------+
173 +---------------------+---------+---------+---------+---------+
174 | ovs-noha (dpdk) | | | X | |
175 +---------------------+---------+---------+---------+---------+
176 | kvm-noha | | | X | |
177 +---------------------+---------+---------+---------+---------+
178 | odl_l2-bgpvpn | X | | X | |
179 +---------------------+---------+---------+---------+---------+
180 | odl_l2-sfc | | | X | |
181 +---------------------+---------+---------+---------+---------+
182 | onos-sfc | X | X | X | X |
183 +---------------------+---------+---------+---------+---------+
184 | odl_l2-moon | | X | | |
185 +---------------------+---------+---------+---------+---------+
186 | multisite | | | | |
187 +---------------------+---------+---------+---------+---------+
189 +---------------------+---------+---------+---------+---------+
191 Functest defines a scenario scoring based on the sum of the unitary test
193 The scoring method is described in https://wiki.opnfv.org/pages/viewpage.action?pageId=6828617
195 In Colorado, the functional tests have been sliced in different
198 +----------------+-----------------------------------------------+
199 | Category | Description |
200 +================+===============================================+
201 | healthcheck | Basic OpenStack commands |
202 +----------------+-----------------------------------------------+
203 | smoke | vPings, Tempest and rally smoke tests |
204 +----------------+-----------------------------------------------+
205 | sdn_suites | Specific SDN feature tests |
206 +----------------+-----------------------------------------------+
207 | features | OPNFV feature project functional test suites |
208 +----------------+-----------------------------------------------+
209 | openstack | Advanced, long duration OpenStack tests |
210 | | (Tempest and Rally full suite). Each test may |
211 | | last several hours |
212 +----------------+-----------------------------------------------+
213 | vnf | Complex scenarios dealing with orchestration, |
214 | | VNF deployment and tests (e.g. vIMS) |
215 +----------------+-----------------------------------------------+
217 For the scenario validation, we consider only the categories healthcheck,
218 smoke, sdn_suites and features. These tests are run systematically in
221 Success criteria have been defined for these test cases, they can be
222 PASS/FAIl or a success rate may be declared (100%, > 90%)
223 All the criteria, as well as the test dependencies are declared in the
224 ci/testcases.yaml file.
226 * TODO scoring table *
228 The reporting pages can be found at:
230 * apex: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-apex.html
231 * compass: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-compass.html
232 * fuel: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-fuel.html
233 * joid: http://testresults.opnfv.org/reporting/functest/release/colorado/index-status-joid.html
235 Colorado known restrictions/issues
236 ==================================
238 +-----------+-----------+----------------------------------------------+
239 | Installer | Scenario | Issue |
240 +===========+===========+==============================================+
241 | any | onos-* | vPing userdata and Tempest cases related to |
242 | | | metadata service excluded from onos scenarios|
243 | | | https://gerrit.opnfv.org/gerrit/#/c/18729/ |
244 +-----------+-----------+----------------------------------------------+
245 | apex/fuel | *-bgpvpn | vPing_ssh (floating ips not supported) and |
246 | | | vIMS excluded. Some Tempest cases related to |
247 | | | floating ips also excluded. |
248 +-----------+-----------+----------------------------------------------+
249 | compass | moon | First ODL test FAILS because ODL/Openstack |
250 | | | federation done in moon is partial. Only |
251 | | | MD-SAL is federated (not AD-SAL) |
252 +-----------+-----------+----------------------------------------------+
253 | fuel | any | TestServerBasicOps test case skipped |
254 | | | https://gerrit.opnfv.org/gerrit/#/c/19635/ |
255 +-----------+-----------+----------------------------------------------+
256 | fuel | kvm | vPing_ssh and vIMS excluded (metadata related|
258 +-----------+-----------+----------------------------------------------+
259 | fuel | multisite | random errors running multisite. A known bug |
260 | | | in keystone mitaka, due to which memcache |
261 | | | raises exception and keystone becomes |
263 | | | bugs.launchpad.net/keystone/+bug/1600394 |
264 | | | workaround consists in restarting memcache on|
266 +-----------+-----------+----------------------------------------------+
267 | joid | any | Tempest cases related to object storage |
269 | | | https://gerrit.opnfv.org/gerrit/#/c/17871/ |
270 +-----------+-----------+----------------------------------------------+
271 | joid | domino | Domino tests are skipped in CI. However the |
272 | | | test case can be run by manually setting |
273 | | | IS_IPandKEY_CONFIGURED=true after manually |
274 | | | setting properly the IP addresses of the 3 |
275 | | | Controller nodes in the configuration file |
276 | | | /repos/domino/tests/run_multinode.sh |
277 +-----------+-----------+----------------------------------------------+
280 Test and installer/scenario dependencies
281 ========================================
283 It is not always possible to run all the test cases on all the scenarios.
284 The following table details the dependencies of the test cases per
285 scenario. The scenario dependencies (installer or scenario) are detailed
286 in https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
291 Test results are available in:
293 - test results document: http://artifacts.opnfv.org/functest
295 - jenkins logs on CI: https://build.opnfv.org/ci/view/functest/
302 +------------------+-----------------------------------------------+
303 | JIRA | Description |
304 +==================+===============================================+
305 +------------------+-----------------------------------------------+
306 +------------------+-----------------------------------------------+
307 +------------------+-----------------------------------------------+
308 +------------------+-----------------------------------------------+
309 +------------------+-----------------------------------------------+
314 - wiki project page: https://wiki.opnfv.org/opnfv_functional_testing
316 - wiki Functest Colorado page: https://wiki.opnfv.org/display/functest/Functest+Colorado
318 - Functest repo: https://git.opnfv.org/cgit/functest
320 - Functest CI dashboard: https://build.opnfv.org/ci/view/functest/
322 - JIRA dashboard: https://jira.opnfv.org/secure/Dashboard.jspa?selectPageId=10611
324 - Functest IRC chan: #opnfv-functest
326 - Functest reporting: http://testresults.opnfv.org/reporting
328 - Functest test configuration: https://git.opnfv.org/cgit/functest/tree/ci/testcases.yaml
330 - Functest Colorado user guide: * TODO *
332 - Functest installation/configuration guide: * TODO *
334 - Functest developer guide: * TODO *