summaryrefslogtreecommitdiffstats
path: root/docs/release/release-notes/release-notes.rst
blob: 05d0e8d3d79693f4e39bb5e163224a4ec5c8b96c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0


This document provides the release notes for Hunter of Doctor.

Important notes
===============

In Hunter release, Doctor has been working with fault management alarming
enhancement and maintenance use case to upstream.

OpenStack Fenix (unofficial project) has been futher worked to implement the
infrastructure rolling maintenance in interaction with VNFM. Doctor CI testing
also supports maintenance testing with Fenix latest master version.

MCP and Apex installers are currently supported. In MCP we test fault management
without the enhanced alarm. In Apex we test fault management with alarm
enhancement with sample implementation. Apex is also used for maintenance use
case testing. Congress inspector support is not working.

In this release, Doctor has not yet been working to look outside OpenStack.
We might need to get back to this later to better meet the tough industry
requirements as well as requirements from edge, containers and 5G.

Summary
=======

Hunter Doctor framework uses OpenStack Rocky integrated into its test cases.
For testing, we use Doctor CI on OPNFV installers.

Release Data
============

Doctor changes

+------------------------------------------+----------------------------------------------------------+
| **commit-ID**                            | **Subject**                                              |
+------------------------------------------+----------------------------------------------------------+
| e6c857ba931a03fb7bfb49746cc4a7eb5b6ce6e1 | Hunter release documentation                             |
+------------------------------------------+----------------------------------------------------------+
| 73605c5c34b97ab56306bfa9af0f5888f3c7e46d | Support Fenix as admin tool                              |
+------------------------------------------+----------------------------------------------------------+
| 33293e9c23a21ad3228f46d2063f18c915eb2b79 | Wrong yamllint disable command                           |
+------------------------------------------+----------------------------------------------------------+
| d82ab34f15a9b67185c85c6afc5562bc8b72cb8b | Add local.conf.sample for devstack deployment of Doctor  |
+------------------------------------------+----------------------------------------------------------+
| 7ecc40b445b2aa42f0680c96dc672accf4e40ba0 | Hi, the automation job failed.                           |
+------------------------------------------+----------------------------------------------------------+
| 2cd1ca4463121e2354fd920af2b26c65848fb9e2 | Remove Ryota from committers                             |
+------------------------------------------+----------------------------------------------------------+
| f31ab961c594595772b0c3d4bd40a0d9491fc6cb | Removing committers                                      |
+------------------------------------------+----------------------------------------------------------+
| c653d95c67436698296e238396bf5d8370e3169a | Update to INFO file                                      |
+------------------------------------------+----------------------------------------------------------+
| e6708c869855ab69f9b53959befd82bb2f32f9ad | Bug - Testing in Apex with OpenStack master fails        |
+------------------------------------------+----------------------------------------------------------+
| e1c5dd0158d5168738fcc9918d24c04ca724b056 | remove to set ceilometer config in MCP                   |
+------------------------------------------+----------------------------------------------------------+
| d673e9218a53e047edc5ff6cd047ac6db5112651 | Support Fenix and sample implementation accordingly      |
+------------------------------------------+----------------------------------------------------------+
| 916e4931a56c1a5d41d46148609bf348d4326d37 | fix the configparser for  Python 2 and 3 Compatibility   |
+------------------------------------------+----------------------------------------------------------+
| 4075b417e973adb257ae39ff5c25aa182a2af3ea | index.rst was blank                                      |
+------------------------------------------+----------------------------------------------------------+
| dafdfcfad6866d7c413d4b8d5a9d25f3ab1f76dc | Minor docs updates                                       |
+------------------------------------------+----------------------------------------------------------+

Releng changes

+------------------------------------------+----------------------------------------------------------+
| **commit-ID**                            | **Subject**                                              |
+------------------------------------------+----------------------------------------------------------+
| cc290b2f937a2edbd60a5d2d1e20f333dfc7eb88 | Doctor to run Fenix as admin tool                        |
+------------------------------------------+----------------------------------------------------------+
| 488c558492201aacd359305a7afa3d5640a90b0e | Add parameter of `DEPLOY_SCENARIO` for doctor            |
+------------------------------------------+----------------------------------------------------------+
| 30478e1e193485cce93164e9877002b811acf950 | remove `SSH_KEY` parameter from `doctor-slave-parameter` |
+------------------------------------------+----------------------------------------------------------+
| 513b05275cbac2ff98950bb0a384a275dd8884f5 | Parpare ssh_key for MCP in doctor                        |
+------------------------------------------+----------------------------------------------------------+

Version change
^^^^^^^^^^^^^^

Module version changes
~~~~~~~~~~~~~~~~~~~~~~

- OpenStack has changed from Queens-1 to Rocky-1 since previous Gambia release.

Document version changes
~~~~~~~~~~~~~~~~~~~~~~~~

These documents have been updated in Hunter release

- Testing document
  docs/development/overview/testing.rst
- Doctor scenario in functest:
  docs/development/overview/functest_scenario/doctor-scenario-in-functest.rst

Reason for version
^^^^^^^^^^^^^^^^^^

Documentation is updated due to maintenance use case testing using Fenix.

Feature additions
~~~~~~~~~~~~~~~~~

+--------------------+----------------------------------------------------------+
| **JIRA REFERENCE** | **SLOGAN**                                               |
+--------------------+----------------------------------------------------------+
| DOCTOR-129         | Maintenance use case implementation in OpenStack Fenix   |
+--------------------+----------------------------------------------------------+
| DOCTOR-131         | Support Fenix and sample implementation accordingly      |
+--------------------+----------------------------------------------------------+
| DOCTOR-132         | Integrate with MCP                                       |
+--------------------+----------------------------------------------------------+
| DOCTOR-133         | Doctor fault management with notification from Inspector |
+--------------------+----------------------------------------------------------+

Deliverables
------------

Software deliverables
=====================

None

Documentation deliverables
==========================

https://git.opnfv.org/doctor/tree/docs

Known Limitations, Issues and Workarounds
=========================================

System Limitations
^^^^^^^^^^^^^^^^^^

Maintenance test case requirements:

- Minimum number of nodes:   1 Controller, 3 Computes
- Min number of VCPUs:       2 VCPUs for each compute

Known issues
^^^^^^^^^^^^

None

Workarounds
^^^^^^^^^^^

None

Test Result
===========

Doctor CI results with TEST_CASE='fault_management' and INSPECTOR_TYPE=sample
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+--------------------------------------+--------------+
| **TEST-SUITE**                       | **Results:** |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Apex' 1)             | SUCCESS      |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Fuel' 2)             | SUCCESS      |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Local'               | N/A          |
+--------------------------------------+--------------+
1) Uses enhanced alarming worked in DOCTOR-133
2) Uses alarm from Nova reset server state API generated notification. API call
   can take a lot of time and alarm might take over a second. This also happens
   with different installer and for more Telco grade performance we need the
   enhanced alarming.

Doctor CI results with TEST_CASE='fault_management' and INSPECTOR_TYPE=congress
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+--------------------------------------+--------------+
| **TEST-SUITE**                       | **Results:** |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Apex' 1)             | FAILED       |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Fuel'                | N/A          |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Local'               | N/A          |
+--------------------------------------+--------------+
1) This needs to be worked to get fixed later


Doctor Functest results with TEST_CASE='fault_management'
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+--------------------------------------+--------------+
| **TEST-SUITE**                       | **Results:** |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Apex'                | skipped      |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Fuel'                | skipped      |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Local'               | N/A          |
+--------------------------------------+--------------+

Note: Installer Functest does not currently test features or skips running the
project test cases

Doctor CI results with TEST_CASE='maintenance'
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+--------------------------------------+--------------+
| **TEST-SUITE**                       | **Results:** |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Apex'                | SUCCESS      |
| ADMIN_TOOL_TYPE='sample'             |              |
+--------------------------------------+--------------+
| INSTALLER_TYPE='Apex'                | SUCCESS      |
| ADMIN_TOOL_TYPE='fenix'              |              |
+--------------------------------------+--------------+

Doctor Functest results with TEST_CASE='maintenance'
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

N/A - Needs special target environment with at least 3 compute nodes

References
==========

For more information about the OPNFV Doctor latest work, please see:

https://wiki.opnfv.org/display/doctor/Doctor+Home