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