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