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