Update the release notes to have the workaround for the dmaap events issue
[aai/aai-common.git] / docs / release-notes.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. Copyright 2017 AT&T Intellectual Property.  All rights reserved.
4 .. _release_notes:
5
6
7 AAI Release Notes
8 ==================
9
10 Abstract
11 ========
12
13 This document provides release notes for the Active and Available Inventory Project's Guilin Release
14
15 Release Data
16 ============
17 Version: 7.0.0
18 --------------
19
20 :Release Date: 2020-12-04 (TBD)
21
22 New Features
23 ------------
24
25 The R7 Guilin release of ONAP includes updates to both use cases and non-functional requirements. The AAI platform maturity rating graduated from Incubation to Mature in Guilin.  AAI is serving v21 as the latest version of the REST APIs, and has support for v19.
26
27 - Functional Updates
28     * Model updates as part of CCVPN Transport Slicing Feature
29     * Model updates as part of xNF Software Upgrade feature
30     * Model updates as part of Multi-tenancy
31     * Updates to SDC model parsing to support Bulk PM/PM Data Control Extension & E2E Network Slicing features
32     * Configurable ability to control concurrency locking
33     * Configurable ability to enforce ownership of owning entity on pnf crud interactions (Multi-tenancy poc)
34     * Enhancements to the model based on physical inventory
35     * Support for nested json formatted responses using the as-tree=true parameter for traversal mS calls
36 - Non-functional Updates
37     * Updated microservices to run as non-root
38     * Spring boot 2 upgrades to our microservices
39     * Enhanced logging
40     * Added limits to aai pods
41     * Update mS based on license scan findings
42 - Deprecation Notice
43     * ESR Server is retired
44     * ESR GUI is retired
45     * AAI Sparky UI is not supported in Guilin nor is its supporting mS data-router, search-data-service, or elastic. Targeted for retirement in Honolulu.
46
47 Known Limitations, Issues, and Workarounds
48 ==========================================
49
50 Known Issues
51 ------------
52
53 * `AAI-3219 <https://jira.onap.org/browse/AAI-3219>`_ - AAI-EVENT notifications failed to be published to DMaap
54
55 Workarounds
56 -----------
57
58 The following is our workaround (i.e., replacing HTTPS with HTTP):
59
60     .. code-block:: bash
61         /** Change each of these configmaps below**/
62         kubectl -n onap edit configmaps dev-aai-resources-configmap
63         kubectl -n onap edit configmaps dev-aai-traversal-configmap
64         kubectl -n onap edit configmaps dev-aai-graphadmin-configmap
65         kubectl -n onap edit configmaps dev-aai-data-router-dynamic
66         // The target attributes need to be changed are:
67         // change Dmaap port from 3905 => 3904
68         // change Dmaap protocol from https => http
69         /** Restart related pods **/
70         kubectl n onap delete pod {POD1} {POD2} {POD3} {POD4}
71         //where POD1-4 are pod names of dev-aai-resources, dev-aai-traversal, dev-aai-graphadmin, and dev-aai-data-router, respectively.
72
73 References
74 ==========
75
76 Quick links:
77
78 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
79 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
80
81 For more information on the ONAP Guilin release, please see:
82
83 #. `ONAP Home Page`_
84 #. `ONAP Documentation`_
85 #. `ONAP Release Downloads`_
86 #. `ONAP Wiki Page`_
87
88 .. _`ONAP Home Page`: https://www.onap.org
89 .. _`ONAP Wiki Page`: https://wiki.onap.org
90 .. _`ONAP Documentation`: https://docs.onap.org
91 .. _`ONAP Release Downloads`: https://git.onap.org
92
93 Version: 6.0.0
94 --------------
95
96 :Release Date: 2020-06-04
97
98 New Features
99 ------------
100
101 The R6 Frankfurt release of ONAP includes updates to both use cases and non-functional requirements.  AAI is serving v19 as the latest version of the REST APIs, and has support for v16 (Dublin and El Alto).
102
103 - Implemented new parent POM under org.onap.aai.aai-common.aai-parent for simplified management of 3rd party dependencies
104 - Upgrade to spring-boot 2 (partially complete)
105 - Model updates and edge rules changes in support of the following use cases:
106   * CCVPN for SOTN NNI
107   * 5G Network Slicing
108   * Multi-Domain Optical Network Services
109   * PNF enhancements
110 - Papyrus XMI UML files for run-time data model reverse engineering
111 - Integration with sonarcloud
112 - All containers run as non-root user
113
114 champ, spike, and gizmo are deprecated and removed from the helm chart.
115
116 Known Limitations, Issues, and Workarounds
117 ==========================================
118
119 Known Issues
120 ------------
121
122 * `AAI-2766 <https://jira.onap.org/browse/AAI-2766>`_ - AAI data-router cannot communicate with DMaaP message router service
123 * `AAI-2905 <https://jira.onap.org/browse/AAI-2905>`_ - AAI sparky cannot communicate with portal due to certificate issue, might be related to https://jira.onap.org/browse/PORTAL-875
124
125 The AAI sub-project External System Registry (ESR) is re-using elalto containers.  The integration team has helped ESR to meet security requirements for Frankfurt, and the AAI is grateful for the contribution.
126
127 Workarounds
128 -----------
129
130 Roles for sparky are loaded into AAF by default, so previous workaround is no longer required.  However, the pods cannot resolve portal.api.simpledemo.onap.org anymore, so it's necessary to add an entry to /etc/hosts in the sparky-be pod.  This will get around the "unknown host" issue, but then it's leads to AAI-2905, where AAI cannot get the roles from Portal due to the issue with the AAF auto-created certificate.
131
132 The community has been unable to make data-router communicate with DMaaP, we welcome contributors who can help resurrect this service, or it will be deprecated in Guilin.
133
134 References
135 ==========
136
137 Quick links:
138
139 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
140 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
141
142 For more information on the ONAP Frankfurt release, please see:
143
144 #. `ONAP Home Page`_
145 #. `ONAP Documentation`_
146 #. `ONAP Release Downloads`_
147 #. `ONAP Wiki Page`_
148
149 .. _`ONAP Home Page`: https://www.onap.org
150 .. _`ONAP Wiki Page`: https://wiki.onap.org
151 .. _`ONAP Documentation`: https://docs.onap.org
152 .. _`ONAP Release Downloads`: https://git.onap.org
153
154 Version: 5.0.2
155 --------------
156 :Release Date: 2019-10-03
157
158 **New Features**
159
160 The R5 El Alto release of ONAP is a maintenance release, focusing on
161 deployability, technical debt, and footprint opimization.
162
163 AAI focused on converting all of our microservices to Alpine, created
164 common images for users to select either Alpine or Ubuntu, and reduced
165 the number of microservices that is started by default for the
166 demo. We updated to newer versions of spring boot - we are in the
167 process of moving to spring-boot 2, but many of the microservices are
168 still running 1.5.21.  We updated to JanusGraph 0.2.3, which is a
169 seamless upgrade from 0.2.0 which was used in Dublin.
170
171 Users who would like to further reduce the AAI footprint can update the
172 aai/oom helm charts.
173
174 To re-enable the services that have been disabled by default, update
175 to "enabled: true" in aai/oom/values.yaml:
176
177  .. code-block:: bash
178
179     aai-champ:
180         enabled: true
181     aai-gizmo:
182         enabled: true
183     aai-spike:
184         enabled: true
185
186 To disable other components that are not critical to the Integration
187 use cases (vFw, vLB, vDNS, etc), add "enabled: false" in
188 aai/oom/values.yaml for each of the following services:
189
190  .. code-block:: bash
191
192     aai-data-router:
193         enabled: false
194     aai-search-data:
195         enabled: false
196     aai-elasticsearch:
197         enabled: false
198     aai-sparky-fe:
199         enabled: false
200
201 *Known Vulnerabilities in Used Modules*
202
203 AAI code has been formally scanned during build time using NexusIQ and
204 all Critical vulnerabilities have been addressed, items that remain
205 open have been assessed for risk and determined to be false
206 positive. The AAI open Critical security vulnerabilities and their
207 risk assessment have been documented as part of the linkTBD
208
209 **Known Issues**
210
211 The AAI UI is now integrated with Portal and AAF.  However, the AAF
212 default boostrap does not include a role that is necessary the demo
213 user to access the AAI UI.
214
215 Run the following as a workaround, adjust the URL and credentials
216 according to your environment. The user in CRED must be able to update
217 the org.onap.aai namespace.  The following example has been tested from
218 inside the AAI resources pod.
219
220  .. code-block:: bash
221
222     URL='https://aaf-service.onap:8100'
223     CRED='aai@aai.onap.org:demo123456!'
224
225     curl -v -k -u "$CRED" -H "Content-Type: application/RoleRequest+json" $URL/authz/role -d '{"name":"org.onap.aai.aaiui"}'
226
227     curl -v -k -u "$CRED" -H "Content-Type: application/UserRoleRequest+json" $URL/authz/userRole -d '{ "user":"demo@people.osaaf.org", "role":"org.onap.aai.aaiui" }'
228
229 Frankfurt will include the role and role assignment in the
230 default bootstrap data (being tracked under `AAI-2475 <https://jira.onap.org/browse/AAI-2475>`__)
231
232 - `AAI-2606 <https://jira.onap.org/browse/AAI-2606>`_ Schema-service entity description is not available
233
234 - `AAI-2457 <https://jira.onap.org/browse/AAI-2457>`_ Inconsistent error messages when getting AAI resources
235
236 - `AAI-2457 <https://jira.onap.org/browse/AAI-2457>`_ Inconsistent error messages when getting AAI resources
237
238 - `AAI-2092 <https://jira.onap.org/browse/AAI-2092>`_ aai-resources does excessive amounts of logging
239
240 - `AAI-2082 <https://jira.onap.org/browse/AAI-2082>`_ aai-resources gives incorrect output when aai-cassandra has shutdown with failure
241
242 Quick Links:
243
244 - `Active and Available Inventory project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
245 - `R5 Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
246 - `R5 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=64003431>`_
247
248
249 Version: 1.4.0
250 --------------
251
252 :Release Date: 2019-06-08
253
254 **New Features**
255
256 The R4 Dublin release of ONAP is a balanced release, focusing on
257 platform maturity and deployablity while also bringing in significant
258 new features and use cases . AAI continued to leverage oom and
259 kubernetes, and added new data types in support of multiple R4 use
260 cases.  AAI added a new schema service which moves AAI closer to being
261 more model-driven and flexible.
262
263 AAI is more model driven in Casablanca, which means it dynamically
264 operationalize new and updated models at run-time, with minimal
265 downtime and coding, so that the latest service and resource models
266 can be delivered quickly. To do this, AAI must update its internal
267 model, external API and behavior to respond to change to service and
268 resource models, including schema changes. The schema service provides
269 ONAP users the ability to quickly change the AAI data model without
270 re-building key microservices.
271
272 AAI delivered 55%+ test coverage on all Java-based repos.
273
274 See `AAI-1779 <https://jira.onap.org/browse/AAI-1779>`__ for details
275 on the schema updates in R4.
276
277 Some AAI services can be configured to leverage the ONAP Pluggable
278 Security Sidecar proof of concept (disabled by default, see the charts
279 under aai/oom for more details).
280
281 AAI now manages its own helm charts. See `aai/oom <https://gerrit.onap.org/r/admin/repos/aai/oom>`__
282
283 **Known Issues**
284
285 The AAI UI is now integrated with Portal and AAF.  However, the AAF
286 default boostrap does not include a role that is necessary the demo
287 user to access the AAI UI.
288
289 Run the following as a workaround, adjust the URL and credentials
290 according to your environment. The user in CRED must be able to update
291 the org.onap.aai namespace.  The following example has been tested from
292 inside the AAI resources pod.
293
294  .. code-block:: bash
295
296     URL='https://aaf-service.onap:8100'
297     CRED='aai@aai.onap.org:demo123456!'
298
299     curl -v -k -u "$CRED" -H "Content-Type: application/RoleRequest+json" $URL/authz/role -d '{"name":"org.onap.aai.aaiui"}'
300
301     curl -v -k -u "$CRED" -H "Content-Type: application/UserRoleRequest+json" $URL/authz/userRole -d '{ "user":"demo@people.osaaf.org", "role":"org.onap.aai.aaiui" }'
302
303 Future releases will include the role and role assignment in the
304 default bootstrap data (being tracked under `AAI-2475 <https://jira.onap.org/browse/AAI-2475>`__)
305
306
307 **Security Notes**
308
309 *Fixed Security Issues*
310
311 - `OJSI-114 <https://jira.onap.org/browse/OJSI-114>`_ In default deployment AAI (aai) exposes HTTP port 30232 outside of cluster.
312
313 *Known Security Issues*
314
315 *Known Vulnerabilities in Used Modules*
316
317 AAI code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The AAI open Critical security vulnerabilities and their risk assessment have been documented as part of the `R4 project wiki <https://wiki.onap.org/pages/viewpage.action?pageId=64003431>`_.
318
319 Quick Links:
320
321 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
322 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
323 - `R4 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=64003431>`_
324
325
326
327
328 Version: 1.3.2
329 --------------
330
331 :Release Date: 2019-03-31
332
333 **Updates**
334
335 AAI demo certificates were going to expire before Dublin release, so they've been refreshed to last until 2020.
336
337 - `AAI-2282 <https://jira.onap.org/browse/AAI-2282>`_ Update certifcate for Casablanca 3.0.2
338
339 Version: 1.3.1
340 --------------
341
342 :Release Date: 2019-01-31
343
344 **New Features**
345
346 The Casablanca Maintenance Release provides a number of security and
347 bug fixes. Highlights of the issues corrected in the Casablanca
348 Maintenance Release:
349
350 - `AAI-2047 <https://jira.onap.org/browse/AAI-2047>`_ Make success of createDbSchema job required to proceed in AAI startup
351
352 - `AAI-1923 <https://jira.onap.org/browse/AAI-1923>`_ Problem deleting due to EdgeRules in CCVPN usecase Casablanca
353
354 - `AAI-1776 <https://jira.onap.org/browse/AAI-1776>`_ Champ fails to start
355
356 - `AAI-1958 <https://jira.onap.org/browse/AAI-1958>`_ [graphadmin] createDbSchema.sh job loses detailed logfile
357
358 - `AAI-1973 <https://jira.onap.org/browse/AAI-1973>`_ Schema update wiki is out of data of Casablanca
359
360 - `AAI-2058 <https://jira.onap.org/browse/AAI-2058>`_ Upgrade to latest jetty-security
361
362 - `AAI-2076 <https://jira.onap.org/browse/AAI-2076>`_ A&AI healthcheck timeout
363
364 - `AAI-2079 <https://jira.onap.org/browse/AAI-2079>`_ aai-traversal and aai container failure to deploy issues in casablanca 3.0.0-ONAP
365
366 Dependencies were updated in multiple repos to patch security
367 vulnerabilities.
368
369 **Known Issues**
370
371 - `AAI-2090 <https://jira.onap.org/browse/AAI-2090>`_ aai-data-router pod enters CrashLoopBackOff state
372
373 This issue can still present itself if you use the OOM chart which
374 references version 1.3.2 (which is the version specified in the
375 casablanca branch of oom), data-router will not start.  The workaround
376 is to set 1.3.3 in the values.yaml file for data-router, or use the
377 docker-manifest to override.  File is oom/kubernetes/aai/charts/aai-data-router/values.yaml
378
379 Users should pay special attention to `AAI-2064
380 <https://jira.onap.org/browse/AAI-2064>`_ and should consult `this
381 page <https://www.rabbitmq.com/ssl.html>`_ for instructions on how to
382 properly secure it if they are concerned about the issue.
383
384 **Security Notes**
385
386 AAI code has been formally scanned during build time using NexusIQ and
387 all Critical vulnerabilities have been addressed, items that remain
388 open have been assessed for risk and determined to be false
389 positive. The AAI open Critical security vulnerabilities and their
390 risk assessment have been documented as part of the `R3 project wiki
391 <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_.
392
393 Quick Links:
394
395 - `AAI main project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
396 - `CMR Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
397
398
399 Version: 1.3.0
400 --------------
401
402 :Release Date: 2018-11-30
403
404 **New Features**
405
406 The R3 Casablanca release of ONAP again focuses on platform maturity
407 and deployablity. AAI continued to leverage oom and kubernetes, and
408 added new data types in support of multiple R3 use cases.  AAI added a
409 new schema ingest library which moves AAI closer to being more
410 model-driven and a new microservice called "graphadmin" which provides
411 graph maintenance and configuration facilities.
412
413 AAI is more model driven in Casablanca, which means it dynamically
414 operationalize new and updated models at run-time, with minimal
415 downtime and coding, so that the latest service and resource models
416 can be delivered quickly. To do this, AAI must update its internal
417 model, external API and behavior to respond to change to service and
418 resource models, including schema changes. There are changes required
419 to align on implementation across different ONAP components to provide
420 a more strategic model-driven A&AI implementation. For this release
421 decomposing AAI model/schema artifacts (OXM/XSD) into a more granular
422 approach better enables extensibility and support logical subdivision
423 of models.
424
425 AAI added support fo the Cross Domain and Carrier Layer VPN use case
426 by adding new object types, models, and edge rules.
427
428 AAI delivered 50%+ test coverage on all Java-based repos.
429
430 Added support Support for SR-IOV.
431
432 Authentication and Authorization is performed using AAF with the CADI
433 framework. We use basic authentication with RBAC (Role Based Access
434 Control) to secure the AAI REST APIs.
435
436 AAI added automation support for orchestrating SR-IOV Provider
437 Networks that are compatible with the Network Cloud 1.0 infrastructure
438 solution based on standard SR-IOV. Allow for standard SR-IOV Provider
439 Networks to be defined with a set of one or more VLAN associations.
440
441 AAI added suport to allow clients to specify the format on GET
442 operations in the resources micoservices to output like the custom
443 query API does.
444
445 Added support for VLAN tagging.
446
447 **Known Issues**
448
449 Please find at this link the list of issues that will be fixed in the `Casablanca Maintenance Release <https://jira.onap.org/issues/?jql=fixVersion%20%3D%20%22Casablanca%20Maintenance%20Release%22%20and%20type%20%3D%20Bug%20and%20project%20%3D%20%22Active%20and%20Available%20Inventory%22>`_
450
451 **Security Notes**
452
453 AAI code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The AAI open Critical security vulnerabilities and their risk assessment have been documented as part of the `R2 project wiki <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_.
454
455 Quick Links:
456
457 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
458 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
459 - `R3 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
460
461
462 Version: 1.2.0
463 --------------
464
465 :Release Date: 2018-06-07
466
467 **New Features**
468
469 The R2 Beijing release of ONAP focuses on platform maturity - to that
470 end, AAI has switched from Titan on hbase to JanusGraph on a
471 multi-replica cassandra deployment.  We have added several
472 microservices which will be fully operational in R3 Casablanca.
473 Another significant change in R2 is that we converted our
474 Microservices from ASJC 2 to Springboot 1.5.  AAI provides
475 configurations for orchestration via HEAT or via OOM / kubernetes for
476 scaling and resiliency.
477
478 AAI added champ, a graph abstraction microservice, and Gizmo, a new
479 way to perform CRUD operations on the graph in a more atomic way that
480 exposes more of the underlying graph infrastructure.  Babel is a new
481 microservice that does TOSCA model translation on behalf of model
482 loader.  Event client provides an abstraction for dmaap events.
483
484 ONAP AAI R2 includes the following components:
485
486 - AAI Data Management
487 - Resources (CRUD operations)
488 - Traversal (Advanced search operations)
489 - Data Router (Route/persist AAI event data for consumption by the UI)
490 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
491 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
492 - Babel (TOSCA translation for model-loader)
493 - Event-client (DMaaP abstraction
494 - Champ (Graph abstraction microservice)
495 - Applications
496 - Sparky (AAI User Interface)
497
498 Source code of AAI is released under the following repositories at https://gerrit.onap.org
499
500 - aai/aai-common
501 - aai/event-client
502 - aai/babel
503 - aai/champ
504 - aai/data-router
505 - aai/esr-gui
506 - aai/esr-server
507 - aai/gizmo
508 - aai/logging-service
509 - aai/model-loader
510 - aai/resources
511 - aai/rest-client
512 - aai/router-core
513 - aai/search-data-service
514 - aai/sparky-be
515 - aai/sparky-fe
516 - aai/test-config
517 - aai/traversal
518
519 **Epic**
520
521 - `AAI-16 <https://jira.onap.org/browse/AAI-16>`_ A&AI Platform Deployment
522
523 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
524
525 - `AAI-21 <https://jira.onap.org/browse/AAI-21>`_ Gizmo
526
527 - `AAI-24 <https://jira.onap.org/browse/AAI-24>`_ Move to Active Open Source Graph Database
528
529 - `AAI-38 <https://jira.onap.org/browse/AAI-38>`_ AAI Microservice to generate AAI model XML
530
531 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ This epic groups together the various requests for making AAI more configurable
532
533 - `AAI-466 <https://jira.onap.org/browse/AAI-466>`_ Beijing R2 AAI Schema Updates
534
535 - `AAI-680 <https://jira.onap.org/browse/AAI-680>`_ HPA Use Case Support in AAI
536
537 - `AAI-681 <https://jira.onap.org/browse/AAI-681>`_ Change Management Use Case Support in AAI
538
539 - `AAI-682 <https://jira.onap.org/browse/AAI-682>`_ Scale Out Use Case Support in AAI
540
541 - `AAI-769 <https://jira.onap.org/browse/AAI-769>`_ Required updates to the v13 REST API
542
543 **Bug Fixes**
544
545 - `AAI-129 <https://jira.onap.org/browse/AAI-129>`_ RestClientBuilder SSL protocol should be configurable
546
547 - `AAI-131 <https://jira.onap.org/browse/AAI-131>`_ Model-Loader service of A&AI has it's Log Provider Configuration File sealed inside the WAR
548
549 - `AAI-175 <https://jira.onap.org/browse/AAI-175>`_ aai core service of A&AI has it's Log Provider Configuration File configurable from startup.sh
550
551 - `AAI-295 <https://jira.onap.org/browse/AAI-295>`_ ChampDAO tests failing in gizmo
552
553 - `AAI-460 <https://jira.onap.org/browse/AAI-460>`_ vm1-aai-inst1 aai-resources fails to start
554
555 - `AAI-463 <https://jira.onap.org/browse/AAI-463>`_ Wrong Error message when we use PUT instead of POST to create the relationship
556
557 - `AAI-521 <https://jira.onap.org/browse/AAI-521>`_ A&AI resources container sporadically hangs on startup
558
559 - `AAI-523 <https://jira.onap.org/browse/AAI-523>`_ Sparky UI does not display RelationshipList nodes
560
561 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
562
563 - `AAI-559 <https://jira.onap.org/browse/AAI-559>`_ CSIT jobs should use a set of streams, not a list of branches
564
565 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
566
567 - `AAI-568 <https://jira.onap.org/browse/AAI-568>`_ aai/logging-api build fails on license.txt not found when run outside of aai/logging-service dir - for root CI builds
568
569 - `AAI-601 <https://jira.onap.org/browse/AAI-601>`_ AAI search-data-service build failing on 1.1 JAX-RS instead of required 2.0 library only on clean Ubuntu 16.04/JDK1.8.0_151
570
571 - `AAI-603 <https://jira.onap.org/browse/AAI-603>`_ Sonar only push to master
572
573 - `AAI-666 <https://jira.onap.org/browse/AAI-666>`_ aai/datarouter startup fails to find logback.xml
574
575 - `AAI-679 <https://jira.onap.org/browse/AAI-679>`_ A&AI UI failed to search service-instance based on service-instance-id
576
577 - `AAI-699 <https://jira.onap.org/browse/AAI-699>`_ SDC Tosca does not generate Groups from resource yaml
578
579 - `AAI-738 <https://jira.onap.org/browse/AAI-738>`_ When register service to MSB, esr-server still will register to MSB automaticly
580
581 - `AAI-788 <https://jira.onap.org/browse/AAI-788>`_ fix the cookie decryption algorithm
582
583 - `AAI-796 <https://jira.onap.org/browse/AAI-796>`_ AAI is logging %PARSER_ERROR instead of REMOTE_USER
584
585 - `AAI-833 <https://jira.onap.org/browse/AAI-833>`_ The url of query vim type from multiCloud is incorrect
586
587 - `AAI-838 <https://jira.onap.org/browse/AAI-838>`_ Add back the properties that got removed
588
589 - `AAI-874 <https://jira.onap.org/browse/AAI-874>`_ Fix the test-config traversal aaiconfig to use proper timeout keys
590
591 - `AAI-948 <https://jira.onap.org/browse/AAI-948>`_ aai-rest-client build fails with non-resolvable parent POM
592
593 - `AAI-961 <https://jira.onap.org/browse/AAI-961>`_ Fix aai-sparky-be-master-aai-docker-java-daily
594
595 - `AAI-985 <https://jira.onap.org/browse/AAI-985>`_ Sparky-be: Change dependency to make use of sparky-fe war file from Beijing version
596
597 - `AAI-987 <https://jira.onap.org/browse/AAI-987>`_ Update ML with the latest changes
598
599 - `AAI-993 <https://jira.onap.org/browse/AAI-993>`_ Champ docker image name incorrect
600
601 - `AAI-994 <https://jira.onap.org/browse/AAI-994>`_ Crud-service (Gizmo) docker tag version is incorrect
602
603 - `AAI-995 <https://jira.onap.org/browse/AAI-995>`_ Gizmo docker image name incorrect
604
605 - `AAI-996 <https://jira.onap.org/browse/AAI-996>`_ Change ML pom file to address build failure problems
606
607 - `AAI-1005 <https://jira.onap.org/browse/AAI-1005>`_ Fix docker-compose-db.yml in test-config
608
609 - `AAI-1006 <https://jira.onap.org/browse/AAI-1006>`_ Babel start script does not set all required properties
610
611 - `AAI-1007 <https://jira.onap.org/browse/AAI-1007>`_ Babel: java.lang.NoClassDefFoundError: com/att/aft/dme2/internal/gson/JsonSyntaxException
612
613 - `AAI-1016 <https://jira.onap.org/browse/AAI-1016>`_ Model-loader: properties files are incorrectly named and have errors
614
615 - `AAI-1017 <https://jira.onap.org/browse/AAI-1017>`_ Fix Champ build - incorrect definition of Java system path
616
617 - `AAI-1018 <https://jira.onap.org/browse/AAI-1018>`_ Model-loader: CONF_INVALID_MSG_BUS_ADDRESS
618
619 - `AAI-1019 <https://jira.onap.org/browse/AAI-1019>`_ aai-resources: does not require username/password after springboot upgrade
620
621 - `AAI-1020 <https://jira.onap.org/browse/AAI-1020>`_ aai-traversal: does not require username/password after springboot upgrade
622
623 - `AAI-1024 <https://jira.onap.org/browse/AAI-1024>`_ Test-config: model-loader MSG_BUS_ADDRESSES not set
624
625 - `AAI-1025 <https://jira.onap.org/browse/AAI-1025>`_ Test-config: traversal updateQueryData.sh fails to update models and queries
626
627 - `AAI-1026 <https://jira.onap.org/browse/AAI-1026>`_ test-config: model-loader is attempting 2-way TLS with AAI
628
629 - `AAI-1027 <https://jira.onap.org/browse/AAI-1027>`_ ModelLoader basic auth failure with aai-resources
630
631 - `AAI-1029 <https://jira.onap.org/browse/AAI-1029>`_ The DOC about ESR installation should be update
632
633 - `AAI-1034 <https://jira.onap.org/browse/AAI-1034>`_ [sparky-be] Portal API Proxy missing from Spring Boot Sparky
634
635 - `AAI-1035 <https://jira.onap.org/browse/AAI-1035>`_ Security: Springboot 1.5.10 has new nexusIQ critical exceptions
636
637 - `AAI-1038 <https://jira.onap.org/browse/AAI-1038>`_ Babel missing .gitreview file
638
639 - `AAI-1049 <https://jira.onap.org/browse/AAI-1049>`_ [Model Loader] - Remove dependency on PowerMockito
640
641 - `AAI-1051 <https://jira.onap.org/browse/AAI-1051>`_ API Spec is specifying v12 in v13 file
642
643 - `AAI-1052 <https://jira.onap.org/browse/AAI-1052>`_ AAI is using -SNAPSHOT artifacts; remove -SNAPSHOT dependencies
644
645 - `AAI-1077 <https://jira.onap.org/browse/AAI-1077>`_ [Babel] master daily build job is not creating an autorelease staging repo
646
647 - `AAI-1082 <https://jira.onap.org/browse/AAI-1082>`_ Champ janus version incompatible with Resources janus version
648
649 - `AAI-1084 <https://jira.onap.org/browse/AAI-1084>`_ POST with PATCH override call is returning 405
650
651 - `AAI-1086 <https://jira.onap.org/browse/AAI-1086>`_ Babel: Compressed files contain proprietary markings
652
653 - `AAI-1088 <https://jira.onap.org/browse/AAI-1088>`_ aai-common: version.properties refers to previous patch release
654
655 - `AAI-1089 <https://jira.onap.org/browse/AAI-1089>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in HEAT config
656
657 - `AAI-1090 <https://jira.onap.org/browse/AAI-1090>`_ v13 does not support External System under cloud region
658
659 - `AAI-1091 <https://jira.onap.org/browse/AAI-1091>`_ ESR fails to register EMS
660
661 - `AAI-1094 <https://jira.onap.org/browse/AAI-1094>`_ Model-loader: failure to negotiate with message router in OOM
662
663 - `AAI-1096 <https://jira.onap.org/browse/AAI-1096>`_ Increase length for field:password in ESR-GUI VIM registration page
664
665 - `AAI-1100 <https://jira.onap.org/browse/AAI-1100>`_ OOM Resources and Traversal Config map missing release
666
667 - `AAI-1101 <https://jira.onap.org/browse/AAI-1101>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in OOM config
668
669 - `AAI-1105 <https://jira.onap.org/browse/AAI-1105>`_ aai-traversal job is failing when trying to start OOM
670
671 - `AAI-1106 <https://jira.onap.org/browse/AAI-1106>`_ aai-resources: scripts do not work properly with spring-boot
672
673 - `AAI-1107 <https://jira.onap.org/browse/AAI-1107>`_ Security: babel and m-l brings in springboot jersey starter, which includes logback 1.1.11
674
675 - `AAI-1108 <https://jira.onap.org/browse/AAI-1108>`_ [Babel] Remove license violations in latest commit.
676
677 - `AAI-1110 <https://jira.onap.org/browse/AAI-1110>`_ Model Loader logback.xml errors
678
679 - `AAI-1111 <https://jira.onap.org/browse/AAI-1111>`_ Update test-config project for Babel
680
681 - `AAI-1113 <https://jira.onap.org/browse/AAI-1113>`_ ESR VIM registration portal: Physical Location Id does not populate any data
682
683 - `AAI-1114 <https://jira.onap.org/browse/AAI-1114>`_ Security: [Champ] add Dockerfile and remove additional AJSC files
684
685 - `AAI-1116 <https://jira.onap.org/browse/AAI-1116>`_ [Gizmo] addressing Security vulnerabilities (Nexus IQ)
686
687 - `AAI-1117 <https://jira.onap.org/browse/AAI-1117>`_ [Champ] addressing Security vulnerabilities (Nexus IQ)
688
689 - `AAI-1118 <https://jira.onap.org/browse/AAI-1118>`_ [Gizmo] upgrade artefacts from aai-common to 1.2.4
690
691 - `AAI-1119 <https://jira.onap.org/browse/AAI-1119>`_ [Champ] Prevent deployment of Champ service jar
692
693 - `AAI-1120 <https://jira.onap.org/browse/AAI-1120>`_ [Gizmo] Fix Jacoco configuration
694
695 - `AAI-1121 <https://jira.onap.org/browse/AAI-1121>`_ Add the default realtime clients
696
697 - `AAI-1123 <https://jira.onap.org/browse/AAI-1123>`_ Babel logback.xml errors
698
699 - `AAI-1124 <https://jira.onap.org/browse/AAI-1124>`_ [router-core] NexusIQ reporting httpclient 4.5 vulnerability
700
701 - `AAI-1125 <https://jira.onap.org/browse/AAI-1125>`_ [data-router] NexusIQ reporting httpclient 4.5 vulnerability
702
703 - `AAI-1126 <https://jira.onap.org/browse/AAI-1126>`_ [Babel] Authorisation mechanism is not functioning
704
705 - `AAI-1127 <https://jira.onap.org/browse/AAI-1127>`_ [sparky-be] doesn't release artifacts because it is missing the staging plugin
706
707 - `AAI-1132 <https://jira.onap.org/browse/AAI-1132>`_ AAI's OOM server certificate doesn't include all k8 names
708
709 - `AAI-1133 <https://jira.onap.org/browse/AAI-1133>`_ AAI's haproxy server config doesn't include all k8 names
710
711 - `AAI-1134 <https://jira.onap.org/browse/AAI-1134>`_ OOF not defined in AAI realm properties files
712
713 - `AAI-1135 <https://jira.onap.org/browse/AAI-1135>`_ [traversal] closed loop named-query is missing property-collect-list
714
715 - `AAI-1136 <https://jira.onap.org/browse/AAI-1136>`_ Babel doesnt start in HEAT due to log directory permissions
716
717 - `AAI-1138 <https://jira.onap.org/browse/AAI-1138>`_ [Champ] Bump to 1.2.1-SNAPSHOT and 1.2.1 in version.properties
718
719 - `AAI-1139 <https://jira.onap.org/browse/AAI-1139>`_ [resources and traversal] do not release artifacts properly
720
721 - `AAI-1141 <https://jira.onap.org/browse/AAI-1141>`_ [champ] duplicate dependency in pom.xml
722
723 - `AAI-1142 <https://jira.onap.org/browse/AAI-1142>`_ [champ] doesn't create release artifacts
724
725 - `AAI-1143 <https://jira.onap.org/browse/AAI-1143>`_ [resources] createDbSchema.sh tries to add -SNAPSHOT version to classpath
726
727 - `AAI-1144 <https://jira.onap.org/browse/AAI-1144>`_ [oom and test-config] robot-ete is missing from realtime clients list
728
729 - `AAI-1146 <https://jira.onap.org/browse/AAI-1146>`_ [champ] daily build job is failing
730
731 - `AAI-1148 <https://jira.onap.org/browse/AAI-1148>`_ [Model-Loader] Rollback of VNF Images fails
732
733 - `AAI-1151 <https://jira.onap.org/browse/AAI-1151>`_ [Champ & Gizmo] Fix JJB jenkins jobs
734
735 - `AAI-1153 <https://jira.onap.org/browse/AAI-1153>`_ [Champ] Bump to 1.2.2-SNAPSHOT and 1.2.2 in version.properties
736
737 **Known Issues**
738
739 If the either the aai-resources or aai-traversal pod is deleted, haproxy will not automatically detect when the pod is re-instantiated.  As a temporary workaround, you can delete the haproxy pod (the one named "aai", for example, "dev-aai-8794fbff5-clx7d") and when the aai pod restarts the service should operate normally. A proposed fix is here: https://gerrit.onap.org/r/#/c/51075/1 if you want to see how to configure the haproxy service to auto-recover when the IP address of either the aai-resources or aai-traversal pod changes.
740
741 **Security Notes**
742
743 AAI code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The AAI open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25441383>`_.
744
745 Quick Links:
746
747 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
748 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
749 - `R2 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=25441383>`_
750
751 Version: 1.1.1
752 --------------
753
754 :Release Date: 2018-01-18
755
756 **Bug Fixes**
757
758 - `AAI-456 <https://jira.onap.org/browse/AAI-456>`_ AAI named-query for policy not returning extra-properties
759
760 - `AAI-458 <https://jira.onap.org/browse/AAI-458>`_ [aai] ML, Search, DR, and Sparky Jenkins jobs not creating autorelease repo
761
762 - `AAI-459 <https://jira.onap.org/browse/AAI-459>`_ aai-common child pom still depends on openecomp artifacts
763
764 - `AAI-461 <https://jira.onap.org/browse/AAI-461>`_ AAI mS configuration files are using old openecomp params in test-config
765
766 - `AAI-462 <https://jira.onap.org/browse/AAI-462>`_ Fix the resources junit tests broken in windows environment
767
768 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
769
770 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
771
772 - `AAI-566 <https://jira.onap.org/browse/AAI-566>`_ AAI Eclipse build failure - aai-traversal pom as hardcoded 1.8.0_101 jdk.tools version
773
774 - `AAI-621 <https://jira.onap.org/browse/AAI-621>`_ Update the snapshot in test-config for v1.1.1-SNAPSHOT
775
776 Version: 1.1.0
777 --------------
778
779 :Release Date: 2017-11-16
780
781 **New Features**
782
783 Initial release of Active and Available Inventory (AAI) for Open Network Automation Platform (ONAP).  AAI provides ONAP with its logically centralized view of inventory data, taking in updates from orchestrators, controllers, and assurance systems.  AAI provides core REST services.
784
785 ONAP AAI R1 includes the following components:
786
787 - AAI Data Management
788 - Resources (CRUD operations)
789 - Traversal (Advanced search operations)
790 - Data Router (Route/persist AAI event data for consumption by the UI)
791 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
792 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
793 - Applications
794 - Sparky (AAI User Interface)
795
796 Source code of AAI is released under the following repositories at https://gerrit.onap.org .
797
798 - aai/aai-common
799 - aai/aai-config
800 - aai/aai-data
801 - aai/aai-service
802 - aai/babel
803 - aai/champ
804 - aai/data-router
805 - aai/esr-gui
806 - aai/esr-server
807 - aai/gizmo
808 - aai/logging-service
809 - aai/model-loader
810 - aai/resources
811 - aai/rest-client
812 - aai/router-core
813 - aai/search-data-service
814 - aai/sparky-be
815 - aai/sparky-fe
816 - aai/test-config
817 - aai/traversal
818
819 **Epic**
820
821 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
822 - `AAI-20 <https://jira.onap.org/browse/AAI-20>`_ Champ Library
823 - `AAI-22 <https://jira.onap.org/browse/AAI-22>`_ Amsterdam User Case Schema Updates
824 - `AAI-23 <https://jira.onap.org/browse/AAI-23>`_ Model Loader Support for R1
825 - `AAI-58 <https://jira.onap.org/browse/AAI-58>`_ Define and build functional test cases for CSIT
826 - `AAI-72 <https://jira.onap.org/browse/AAI-72>`_ External System Register
827 - `AAI-254 <https://jira.onap.org/browse/AAI-254>`_ Documentation of REST APIs, dev guides, onboarding, etc.
828 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ Confguration enhancements
829
830 **Bug Fixes**
831
832 - `AAI-11 <https://jira.onap.org/browse/AAI-11>`_ robot_vm: demo.sh failing - '200' does not match '^(201|412)$' on vanilla openstack
833
834 - `AAI-13 <https://jira.onap.org/browse/AAI-13>`_ VM_init is failing to get sparky
835
836 - `AAI-31 <https://jira.onap.org/browse/AAI-31>`_ Compilation failure in aai-traversal
837
838 - `AAI-48 <https://jira.onap.org/browse/AAI-48>`_ AAI Common REST Client returns an error on a 204 (No Content) server response
839
840 - `AAI-49 <https://jira.onap.org/browse/AAI-49>`_ Health check is failing in DFW 1.1 RS. Connection refused
841
842 - `AAI-62 <https://jira.onap.org/browse/AAI-62>`_ Search Data Service should not implicitly create indexes on document write
843
844 - `AAI-63 <https://jira.onap.org/browse/AAI-63>`_ Data Router must handle Search Service document create failures if index does not exit
845
846 - `AAI-73 <https://jira.onap.org/browse/AAI-73>`_ Sparky sync issues
847
848 - `AAI-76 <https://jira.onap.org/browse/AAI-76>`_ Jenkins stage-site builds failing on resources and traversal
849
850 - `AAI-94 <https://jira.onap.org/browse/AAI-94>`_ AAI Certificate will expire 30 Nov 2017 - fyi
851
852 - `AAI-146 <https://jira.onap.org/browse/AAI-146>`_ Both esr-server and esr-gui Jenkins failed
853
854 - `AAI-192 <https://jira.onap.org/browse/AAI-192>`_ Model Loader depends on httpclient version 4.4.1
855
856 - `AAI-205 <https://jira.onap.org/browse/AAI-205>`_ Having an invalid xml namespace for v11, named-query api returns 500 error, model query return incorrect error message
857
858 - `AAI-206 <https://jira.onap.org/browse/AAI-206>`_ Model based delete is failing
859
860 - `AAI-217 <https://jira.onap.org/browse/AAI-217>`_ Remove internal references from A&AI seed code
861
862 - `AAI-222 <https://jira.onap.org/browse/AAI-222>`_ the version property of esr-server is incorrect
863
864 - `AAI-224 <https://jira.onap.org/browse/AAI-224>`_ aai/esr-gui daily build failed
865
866 - `AAI-225 <https://jira.onap.org/browse/AAI-225>`_ aai/esr-server daily build failed
867
868 - `AAI-265 <https://jira.onap.org/browse/AAI-265>`_ EdgePropertyMap throws NullPointer if edge rule does not include property
869
870 - `AAI-266 <https://jira.onap.org/browse/AAI-266>`_ auth-info edge rule does not include contains-other-v
871
872 - `AAI-273 <https://jira.onap.org/browse/AAI-273>`_ Fix the esr-server setup error issue
873
874 - `AAI-278 <https://jira.onap.org/browse/AAI-278>`_ AAI throws exception about mismatch keys adding esr-system-info to cloud-region
875
876 - `AAI-293 <https://jira.onap.org/browse/AAI-293>`_ Jenkins job failing for aai-sparky-fe-master-release-version-java-daily
877
878 - `AAI-377 <https://jira.onap.org/browse/AAI-377>`_ esr-gui docker build failed
879
880 - `AAI-393 <https://jira.onap.org/browse/AAI-393>`_ The jjb defiend in a error way that cause CSIT build failed.
881
882 - `AAI-398 <https://jira.onap.org/browse/AAI-398>`_ If a cloud-region didn't contain a external system info, there will be an null pointer error
883
884 - `AAI-400 <https://jira.onap.org/browse/AAI-400>`_ Register ServiceTest to microservice
885
886 - `AAI-401 <https://jira.onap.org/browse/AAI-401>`_ Remove DMaaP router duplication
887
888 - `AAI-407 <https://jira.onap.org/browse/AAI-407>`_ There is an error to startup esr-gui docker
889
890 - `AAI-412 <https://jira.onap.org/browse/AAI-412>`_ Replace the type specification in this constructor call with the diamond operator ("<>")
891
892 - `AAI-417 <https://jira.onap.org/browse/AAI-417>`_ Rackspace 20170928 fails to authenticate nexus3 on 10003 during *_init.sh* (sdnc for example)
893
894 - `AAI-420 <https://jira.onap.org/browse/AAI-420>`_ Can not get the MSB address in esr-server
895
896 - `AAI-422 <https://jira.onap.org/browse/AAI-422>`_ The esr-server csit failed
897
898 - `AAI-424 <https://jira.onap.org/browse/AAI-424>`_ The integration catalog is not in use, should be removed
899
900 - `AAI-425 <https://jira.onap.org/browse/AAI-425>`_ Fix the artifact of esr-gui
901
902 - `AAI-426 <https://jira.onap.org/browse/AAI-426>`_ Fix the artifact of esr-server
903
904 - `AAI-431 <https://jira.onap.org/browse/AAI-431>`_ esr-gui files did not contained in webapp of tomcat
905
906 - `AAI-433 <https://jira.onap.org/browse/AAI-433>`_ Failed to pre-load vCPE data to AAI. No response from AAI
907
908 - `AAI-434 <https://jira.onap.org/browse/AAI-434>`_ Can not visit ESR portal with demo deployment
909
910 - `AAI-435 <https://jira.onap.org/browse/AAI-435>`_ default tenant need be input to A&AI while register VIM
911
912 - `AAI-436 <https://jira.onap.org/browse/AAI-436>`_ Call the API from MultiCloud failed
913
914 - `AAI-440 <https://jira.onap.org/browse/AAI-440>`_ The version input box should be changed in a more easy to use when register a VIM
915
916 - `AAI-441 <https://jira.onap.org/browse/AAI-441>`_ Can not input the vendor and version information to EMS, but there is a default data for the two parameter
917
918 - `AAI-442 <https://jira.onap.org/browse/AAI-442>`_ Can't instantiate a service
919
920 - `AAI-444 <https://jira.onap.org/browse/AAI-444>`_ Cannot associate multiple service-instances to PNFs
921
922 - `AAI-446 <https://jira.onap.org/browse/AAI-446>`_ vnf to esr-system-info named-query is missing vnfc
923
924 - `AAI-448 <https://jira.onap.org/browse/AAI-448>`_ Remove snapshot dependencies from aai-common, data-router, and rest-client
925
926 - `AAI-450 <https://jira.onap.org/browse/AAI-450>`_ Named Query needs to be updated to return VNFC Info
927
928 - `AAI-453 <https://jira.onap.org/browse/AAI-453>`_ Fix stage-site jenkins job for aai-common
929
930 - `AAI-454 <https://jira.onap.org/browse/AAI-454>`_ LoggingContext.requestId required NULL handling in aai/aai-common (20170607) - during demo.sh init_customer
931
932 **Known Issues**
933
934 - `AAI-61 <https://jira.onap.org/browse/AAI-61>`_ AAI cleaned up references to OpenECOMP but in order to keep the release stable for R1, the XML namespace still contains openecomp.
935
936 Client systems should use http://org.openecomp.aai.inventory/v11 as the XML namespace for ONAP AAI R1.
937
938 **Security Issues**
939
940 See Common Vulnerabilities and Exposures `CVE <https://cve.mitre.org>`
941
942 ONAP docker images and repos include demo TLS server certificates that are signed by a demo Certificate Authority. DO NOT use the demo certificates in a production environment.
943
944 AAI uses HTTPS Basic Authentication.
945
946 **Upgrade Notes**
947
948 This is an initial release
949
950 **Deprecation Notes**
951
952 AAI Amsterdam provides support for legacy versions of the API, v8 and v11 in this release.  v11 is the latest and preferred version.
953
954 **Other**
955
956 ===========
957
958 End of Release Notes