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.
13 This document provides release notes for the Active and Available Inventory Project's Guilin Release
20 :Release Date: 2020-12-03 (TBD)
25 The R7 Guilin release of ONAP includes updates to both use cases and non-functional requirements. The AAI platform maturity rating graduated from Incubation to Mature in Guilin. AAI is serving v21 as the latest version of the REST APIs, and has support for v19.
28 * Model updates as part of CCVPN Transport Slicing Feature
29 * Model updates as part of xNF Software Upgrade feature
30 * Model updates as part of Multi-tenancy
31 * Updates to SDC model parsing to support Bulk PM/PM Data Control Extension & E2E Network Slicing features
32 * Configurable ability to control concurrency locking
33 * Configurable ability to enforce ownership of owning entity on pnf crud interactions (Multi-tenancy poc)
34 * Enhancements to the model based on physical inventory
35 * Support for nested json formatted responses using the as-tree=true parameter for traversal mS calls
36 - Non-functional Updates
37 * Updated microservices to run as non-root
38 * Spring boot 2 upgrades to our microservices
40 * Added limits to aai pods
41 * Update mS based on license scan findings
43 * ESR Server is retired
45 * AAI Sparky UI is not supported in Guilin nor is its supporting mS data-router, search-data-service, or elastic. Targeted for retirement in Honolulu.
47 Known Limitations, Issues, and Workarounds
48 ==========================================
53 * `AAI-3219 <https://jira.onap.org/browse/AAI-3219>`_ - AAI-EVENT notifications failed to be published to DMaap
58 The following is our workaround (i.e., replacing HTTPS with HTTP):
62 /** Change each of these configmaps below**/
63 kubectl -n onap edit configmaps dev-aai-resources-configmap
64 kubectl -n onap edit configmaps dev-aai-traversal-configmap
65 kubectl -n onap edit configmaps dev-aai-graphadmin-configmap
66 kubectl -n onap edit configmaps dev-aai-data-router-dynamic
67 // The target attributes need to be changed are:
68 // change Dmaap port from 3905 => 3904
69 // change Dmaap protocol from https => http
70 /** Restart related pods **/
71 kubectl n onap delete pod {POD1} {POD2} {POD3} {POD4}
72 //where POD1-4 are pod names of dev-aai-resources, dev-aai-traversal, dev-aai-graphadmin, and dev-aai-data-router, respectively.
79 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
80 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
82 For more information on the ONAP Guilin release, please see:
85 #. `ONAP Documentation`_
86 #. `ONAP Release Downloads`_
89 .. _`ONAP Home Page`: https://www.onap.org
90 .. _`ONAP Wiki Page`: https://wiki.onap.org
91 .. _`ONAP Documentation`: https://docs.onap.org
92 .. _`ONAP Release Downloads`: https://git.onap.org
97 :Release Date: 2020-06-04
102 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).
104 - Implemented new parent POM under org.onap.aai.aai-common.aai-parent for simplified management of 3rd party dependencies
105 - Upgrade to spring-boot 2 (partially complete)
106 - Model updates and edge rules changes in support of the following use cases:
109 * Multi-Domain Optical Network Services
111 - Papyrus XMI UML files for run-time data model reverse engineering
112 - Integration with sonarcloud
113 - All containers run as non-root user
115 champ, spike, and gizmo are deprecated and removed from the helm chart.
117 Known Limitations, Issues, and Workarounds
118 ==========================================
123 * `AAI-2766 <https://jira.onap.org/browse/AAI-2766>`_ - AAI data-router cannot communicate with DMaaP message router service
124 * `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
126 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.
131 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.
133 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.
140 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
141 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
143 For more information on the ONAP Frankfurt release, please see:
146 #. `ONAP Documentation`_
147 #. `ONAP Release Downloads`_
150 .. _`ONAP Home Page`: https://www.onap.org
151 .. _`ONAP Wiki Page`: https://wiki.onap.org
152 .. _`ONAP Documentation`: https://docs.onap.org
153 .. _`ONAP Release Downloads`: https://git.onap.org
157 :Release Date: 2019-10-03
161 The R5 El Alto release of ONAP is a maintenance release, focusing on
162 deployability, technical debt, and footprint opimization.
164 AAI focused on converting all of our microservices to Alpine, created
165 common images for users to select either Alpine or Ubuntu, and reduced
166 the number of microservices that is started by default for the
167 demo. We updated to newer versions of spring boot - we are in the
168 process of moving to spring-boot 2, but many of the microservices are
169 still running 1.5.21. We updated to JanusGraph 0.2.3, which is a
170 seamless upgrade from 0.2.0 which was used in Dublin.
172 Users who would like to further reduce the AAI footprint can update the
175 To re-enable the services that have been disabled by default, update
176 to "enabled: true" in aai/oom/values.yaml:
187 To disable other components that are not critical to the Integration
188 use cases (vFw, vLB, vDNS, etc), add "enabled: false" in
189 aai/oom/values.yaml for each of the following services:
202 *Known Vulnerabilities in Used Modules*
204 AAI code has been formally scanned during build time using NexusIQ and
205 all Critical vulnerabilities have been addressed, items that remain
206 open have been assessed for risk and determined to be false
207 positive. The AAI open Critical security vulnerabilities and their
208 risk assessment have been documented as part of the linkTBD
212 The AAI UI is now integrated with Portal and AAF. However, the AAF
213 default boostrap does not include a role that is necessary the demo
214 user to access the AAI UI.
216 Run the following as a workaround, adjust the URL and credentials
217 according to your environment. The user in CRED must be able to update
218 the org.onap.aai namespace. The following example has been tested from
219 inside the AAI resources pod.
223 URL='https://aaf-service.onap:8100'
224 CRED='aai@aai.onap.org:demo123456!'
226 curl -v -k -u "$CRED" -H "Content-Type: application/RoleRequest+json" $URL/authz/role -d '{"name":"org.onap.aai.aaiui"}'
228 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" }'
230 Frankfurt will include the role and role assignment in the
231 default bootstrap data (being tracked under `AAI-2475 <https://jira.onap.org/browse/AAI-2475>`__)
233 - `AAI-2606 <https://jira.onap.org/browse/AAI-2606>`_ Schema-service entity description is not available
235 - `AAI-2457 <https://jira.onap.org/browse/AAI-2457>`_ Inconsistent error messages when getting AAI resources
237 - `AAI-2457 <https://jira.onap.org/browse/AAI-2457>`_ Inconsistent error messages when getting AAI resources
239 - `AAI-2092 <https://jira.onap.org/browse/AAI-2092>`_ aai-resources does excessive amounts of logging
241 - `AAI-2082 <https://jira.onap.org/browse/AAI-2082>`_ aai-resources gives incorrect output when aai-cassandra has shutdown with failure
245 - `Active and Available Inventory project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
246 - `R5 Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
247 - `R5 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=64003431>`_
253 :Release Date: 2019-06-08
257 The R4 Dublin release of ONAP is a balanced release, focusing on
258 platform maturity and deployablity while also bringing in significant
259 new features and use cases . AAI continued to leverage oom and
260 kubernetes, and added new data types in support of multiple R4 use
261 cases. AAI added a new schema service which moves AAI closer to being
262 more model-driven and flexible.
264 AAI is more model driven in Casablanca, which means it dynamically
265 operationalize new and updated models at run-time, with minimal
266 downtime and coding, so that the latest service and resource models
267 can be delivered quickly. To do this, AAI must update its internal
268 model, external API and behavior to respond to change to service and
269 resource models, including schema changes. The schema service provides
270 ONAP users the ability to quickly change the AAI data model without
271 re-building key microservices.
273 AAI delivered 55%+ test coverage on all Java-based repos.
275 See `AAI-1779 <https://jira.onap.org/browse/AAI-1779>`__ for details
276 on the schema updates in R4.
278 Some AAI services can be configured to leverage the ONAP Pluggable
279 Security Sidecar proof of concept (disabled by default, see the charts
280 under aai/oom for more details).
282 AAI now manages its own helm charts. See `aai/oom <https://gerrit.onap.org/r/admin/repos/aai/oom>`__
286 The AAI UI is now integrated with Portal and AAF. However, the AAF
287 default boostrap does not include a role that is necessary the demo
288 user to access the AAI UI.
290 Run the following as a workaround, adjust the URL and credentials
291 according to your environment. The user in CRED must be able to update
292 the org.onap.aai namespace. The following example has been tested from
293 inside the AAI resources pod.
297 URL='https://aaf-service.onap:8100'
298 CRED='aai@aai.onap.org:demo123456!'
300 curl -v -k -u "$CRED" -H "Content-Type: application/RoleRequest+json" $URL/authz/role -d '{"name":"org.onap.aai.aaiui"}'
302 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" }'
304 Future releases will include the role and role assignment in the
305 default bootstrap data (being tracked under `AAI-2475 <https://jira.onap.org/browse/AAI-2475>`__)
310 *Fixed Security Issues*
312 - `OJSI-114 <https://jira.onap.org/browse/OJSI-114>`_ In default deployment AAI (aai) exposes HTTP port 30232 outside of cluster.
314 *Known Security Issues*
316 *Known Vulnerabilities in Used Modules*
318 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>`_.
322 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
323 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
324 - `R4 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=64003431>`_
332 :Release Date: 2019-03-31
336 AAI demo certificates were going to expire before Dublin release, so they've been refreshed to last until 2020.
338 - `AAI-2282 <https://jira.onap.org/browse/AAI-2282>`_ Update certifcate for Casablanca 3.0.2
343 :Release Date: 2019-01-31
347 The Casablanca Maintenance Release provides a number of security and
348 bug fixes. Highlights of the issues corrected in the Casablanca
351 - `AAI-2047 <https://jira.onap.org/browse/AAI-2047>`_ Make success of createDbSchema job required to proceed in AAI startup
353 - `AAI-1923 <https://jira.onap.org/browse/AAI-1923>`_ Problem deleting due to EdgeRules in CCVPN usecase Casablanca
355 - `AAI-1776 <https://jira.onap.org/browse/AAI-1776>`_ Champ fails to start
357 - `AAI-1958 <https://jira.onap.org/browse/AAI-1958>`_ [graphadmin] createDbSchema.sh job loses detailed logfile
359 - `AAI-1973 <https://jira.onap.org/browse/AAI-1973>`_ Schema update wiki is out of data of Casablanca
361 - `AAI-2058 <https://jira.onap.org/browse/AAI-2058>`_ Upgrade to latest jetty-security
363 - `AAI-2076 <https://jira.onap.org/browse/AAI-2076>`_ A&AI healthcheck timeout
365 - `AAI-2079 <https://jira.onap.org/browse/AAI-2079>`_ aai-traversal and aai container failure to deploy issues in casablanca 3.0.0-ONAP
367 Dependencies were updated in multiple repos to patch security
372 - `AAI-2090 <https://jira.onap.org/browse/AAI-2090>`_ aai-data-router pod enters CrashLoopBackOff state
374 This issue can still present itself if you use the OOM chart which
375 references version 1.3.2 (which is the version specified in the
376 casablanca branch of oom), data-router will not start. The workaround
377 is to set 1.3.3 in the values.yaml file for data-router, or use the
378 docker-manifest to override. File is oom/kubernetes/aai/charts/aai-data-router/values.yaml
380 Users should pay special attention to `AAI-2064
381 <https://jira.onap.org/browse/AAI-2064>`_ and should consult `this
382 page <https://www.rabbitmq.com/ssl.html>`_ for instructions on how to
383 properly secure it if they are concerned about the issue.
387 AAI code has been formally scanned during build time using NexusIQ and
388 all Critical vulnerabilities have been addressed, items that remain
389 open have been assessed for risk and determined to be false
390 positive. The AAI open Critical security vulnerabilities and their
391 risk assessment have been documented as part of the `R3 project wiki
392 <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_.
396 - `AAI main project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
397 - `CMR Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
403 :Release Date: 2018-11-30
407 The R3 Casablanca release of ONAP again focuses on platform maturity
408 and deployablity. AAI continued to leverage oom and kubernetes, and
409 added new data types in support of multiple R3 use cases. AAI added a
410 new schema ingest library which moves AAI closer to being more
411 model-driven and a new microservice called "graphadmin" which provides
412 graph maintenance and configuration facilities.
414 AAI is more model driven in Casablanca, which means it dynamically
415 operationalize new and updated models at run-time, with minimal
416 downtime and coding, so that the latest service and resource models
417 can be delivered quickly. To do this, AAI must update its internal
418 model, external API and behavior to respond to change to service and
419 resource models, including schema changes. There are changes required
420 to align on implementation across different ONAP components to provide
421 a more strategic model-driven A&AI implementation. For this release
422 decomposing AAI model/schema artifacts (OXM/XSD) into a more granular
423 approach better enables extensibility and support logical subdivision
426 AAI added support fo the Cross Domain and Carrier Layer VPN use case
427 by adding new object types, models, and edge rules.
429 AAI delivered 50%+ test coverage on all Java-based repos.
431 Added support Support for SR-IOV.
433 Authentication and Authorization is performed using AAF with the CADI
434 framework. We use basic authentication with RBAC (Role Based Access
435 Control) to secure the AAI REST APIs.
437 AAI added automation support for orchestrating SR-IOV Provider
438 Networks that are compatible with the Network Cloud 1.0 infrastructure
439 solution based on standard SR-IOV. Allow for standard SR-IOV Provider
440 Networks to be defined with a set of one or more VLAN associations.
442 AAI added suport to allow clients to specify the format on GET
443 operations in the resources micoservices to output like the custom
446 Added support for VLAN tagging.
450 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>`_
454 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>`_.
458 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
459 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
460 - `R3 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
466 :Release Date: 2018-06-07
470 The R2 Beijing release of ONAP focuses on platform maturity - to that
471 end, AAI has switched from Titan on hbase to JanusGraph on a
472 multi-replica cassandra deployment. We have added several
473 microservices which will be fully operational in R3 Casablanca.
474 Another significant change in R2 is that we converted our
475 Microservices from ASJC 2 to Springboot 1.5. AAI provides
476 configurations for orchestration via HEAT or via OOM / kubernetes for
477 scaling and resiliency.
479 AAI added champ, a graph abstraction microservice, and Gizmo, a new
480 way to perform CRUD operations on the graph in a more atomic way that
481 exposes more of the underlying graph infrastructure. Babel is a new
482 microservice that does TOSCA model translation on behalf of model
483 loader. Event client provides an abstraction for dmaap events.
485 ONAP AAI R2 includes the following components:
487 - AAI Data Management
488 - Resources (CRUD operations)
489 - Traversal (Advanced search operations)
490 - Data Router (Route/persist AAI event data for consumption by the UI)
491 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
492 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
493 - Babel (TOSCA translation for model-loader)
494 - Event-client (DMaaP abstraction
495 - Champ (Graph abstraction microservice)
497 - Sparky (AAI User Interface)
499 Source code of AAI is released under the following repositories at https://gerrit.onap.org
509 - aai/logging-service
514 - aai/search-data-service
522 - `AAI-16 <https://jira.onap.org/browse/AAI-16>`_ A&AI Platform Deployment
524 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
526 - `AAI-21 <https://jira.onap.org/browse/AAI-21>`_ Gizmo
528 - `AAI-24 <https://jira.onap.org/browse/AAI-24>`_ Move to Active Open Source Graph Database
530 - `AAI-38 <https://jira.onap.org/browse/AAI-38>`_ AAI Microservice to generate AAI model XML
532 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ This epic groups together the various requests for making AAI more configurable
534 - `AAI-466 <https://jira.onap.org/browse/AAI-466>`_ Beijing R2 AAI Schema Updates
536 - `AAI-680 <https://jira.onap.org/browse/AAI-680>`_ HPA Use Case Support in AAI
538 - `AAI-681 <https://jira.onap.org/browse/AAI-681>`_ Change Management Use Case Support in AAI
540 - `AAI-682 <https://jira.onap.org/browse/AAI-682>`_ Scale Out Use Case Support in AAI
542 - `AAI-769 <https://jira.onap.org/browse/AAI-769>`_ Required updates to the v13 REST API
546 - `AAI-129 <https://jira.onap.org/browse/AAI-129>`_ RestClientBuilder SSL protocol should be configurable
548 - `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
550 - `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
552 - `AAI-295 <https://jira.onap.org/browse/AAI-295>`_ ChampDAO tests failing in gizmo
554 - `AAI-460 <https://jira.onap.org/browse/AAI-460>`_ vm1-aai-inst1 aai-resources fails to start
556 - `AAI-463 <https://jira.onap.org/browse/AAI-463>`_ Wrong Error message when we use PUT instead of POST to create the relationship
558 - `AAI-521 <https://jira.onap.org/browse/AAI-521>`_ A&AI resources container sporadically hangs on startup
560 - `AAI-523 <https://jira.onap.org/browse/AAI-523>`_ Sparky UI does not display RelationshipList nodes
562 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
564 - `AAI-559 <https://jira.onap.org/browse/AAI-559>`_ CSIT jobs should use a set of streams, not a list of branches
566 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
568 - `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
570 - `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
572 - `AAI-603 <https://jira.onap.org/browse/AAI-603>`_ Sonar only push to master
574 - `AAI-666 <https://jira.onap.org/browse/AAI-666>`_ aai/datarouter startup fails to find logback.xml
576 - `AAI-679 <https://jira.onap.org/browse/AAI-679>`_ A&AI UI failed to search service-instance based on service-instance-id
578 - `AAI-699 <https://jira.onap.org/browse/AAI-699>`_ SDC Tosca does not generate Groups from resource yaml
580 - `AAI-738 <https://jira.onap.org/browse/AAI-738>`_ When register service to MSB, esr-server still will register to MSB automaticly
582 - `AAI-788 <https://jira.onap.org/browse/AAI-788>`_ fix the cookie decryption algorithm
584 - `AAI-796 <https://jira.onap.org/browse/AAI-796>`_ AAI is logging %PARSER_ERROR instead of REMOTE_USER
586 - `AAI-833 <https://jira.onap.org/browse/AAI-833>`_ The url of query vim type from multiCloud is incorrect
588 - `AAI-838 <https://jira.onap.org/browse/AAI-838>`_ Add back the properties that got removed
590 - `AAI-874 <https://jira.onap.org/browse/AAI-874>`_ Fix the test-config traversal aaiconfig to use proper timeout keys
592 - `AAI-948 <https://jira.onap.org/browse/AAI-948>`_ aai-rest-client build fails with non-resolvable parent POM
594 - `AAI-961 <https://jira.onap.org/browse/AAI-961>`_ Fix aai-sparky-be-master-aai-docker-java-daily
596 - `AAI-985 <https://jira.onap.org/browse/AAI-985>`_ Sparky-be: Change dependency to make use of sparky-fe war file from Beijing version
598 - `AAI-987 <https://jira.onap.org/browse/AAI-987>`_ Update ML with the latest changes
600 - `AAI-993 <https://jira.onap.org/browse/AAI-993>`_ Champ docker image name incorrect
602 - `AAI-994 <https://jira.onap.org/browse/AAI-994>`_ Crud-service (Gizmo) docker tag version is incorrect
604 - `AAI-995 <https://jira.onap.org/browse/AAI-995>`_ Gizmo docker image name incorrect
606 - `AAI-996 <https://jira.onap.org/browse/AAI-996>`_ Change ML pom file to address build failure problems
608 - `AAI-1005 <https://jira.onap.org/browse/AAI-1005>`_ Fix docker-compose-db.yml in test-config
610 - `AAI-1006 <https://jira.onap.org/browse/AAI-1006>`_ Babel start script does not set all required properties
612 - `AAI-1007 <https://jira.onap.org/browse/AAI-1007>`_ Babel: java.lang.NoClassDefFoundError: com/att/aft/dme2/internal/gson/JsonSyntaxException
614 - `AAI-1016 <https://jira.onap.org/browse/AAI-1016>`_ Model-loader: properties files are incorrectly named and have errors
616 - `AAI-1017 <https://jira.onap.org/browse/AAI-1017>`_ Fix Champ build - incorrect definition of Java system path
618 - `AAI-1018 <https://jira.onap.org/browse/AAI-1018>`_ Model-loader: CONF_INVALID_MSG_BUS_ADDRESS
620 - `AAI-1019 <https://jira.onap.org/browse/AAI-1019>`_ aai-resources: does not require username/password after springboot upgrade
622 - `AAI-1020 <https://jira.onap.org/browse/AAI-1020>`_ aai-traversal: does not require username/password after springboot upgrade
624 - `AAI-1024 <https://jira.onap.org/browse/AAI-1024>`_ Test-config: model-loader MSG_BUS_ADDRESSES not set
626 - `AAI-1025 <https://jira.onap.org/browse/AAI-1025>`_ Test-config: traversal updateQueryData.sh fails to update models and queries
628 - `AAI-1026 <https://jira.onap.org/browse/AAI-1026>`_ test-config: model-loader is attempting 2-way TLS with AAI
630 - `AAI-1027 <https://jira.onap.org/browse/AAI-1027>`_ ModelLoader basic auth failure with aai-resources
632 - `AAI-1029 <https://jira.onap.org/browse/AAI-1029>`_ The DOC about ESR installation should be update
634 - `AAI-1034 <https://jira.onap.org/browse/AAI-1034>`_ [sparky-be] Portal API Proxy missing from Spring Boot Sparky
636 - `AAI-1035 <https://jira.onap.org/browse/AAI-1035>`_ Security: Springboot 1.5.10 has new nexusIQ critical exceptions
638 - `AAI-1038 <https://jira.onap.org/browse/AAI-1038>`_ Babel missing .gitreview file
640 - `AAI-1049 <https://jira.onap.org/browse/AAI-1049>`_ [Model Loader] - Remove dependency on PowerMockito
642 - `AAI-1051 <https://jira.onap.org/browse/AAI-1051>`_ API Spec is specifying v12 in v13 file
644 - `AAI-1052 <https://jira.onap.org/browse/AAI-1052>`_ AAI is using -SNAPSHOT artifacts; remove -SNAPSHOT dependencies
646 - `AAI-1077 <https://jira.onap.org/browse/AAI-1077>`_ [Babel] master daily build job is not creating an autorelease staging repo
648 - `AAI-1082 <https://jira.onap.org/browse/AAI-1082>`_ Champ janus version incompatible with Resources janus version
650 - `AAI-1084 <https://jira.onap.org/browse/AAI-1084>`_ POST with PATCH override call is returning 405
652 - `AAI-1086 <https://jira.onap.org/browse/AAI-1086>`_ Babel: Compressed files contain proprietary markings
654 - `AAI-1088 <https://jira.onap.org/browse/AAI-1088>`_ aai-common: version.properties refers to previous patch release
656 - `AAI-1089 <https://jira.onap.org/browse/AAI-1089>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in HEAT config
658 - `AAI-1090 <https://jira.onap.org/browse/AAI-1090>`_ v13 does not support External System under cloud region
660 - `AAI-1091 <https://jira.onap.org/browse/AAI-1091>`_ ESR fails to register EMS
662 - `AAI-1094 <https://jira.onap.org/browse/AAI-1094>`_ Model-loader: failure to negotiate with message router in OOM
664 - `AAI-1096 <https://jira.onap.org/browse/AAI-1096>`_ Increase length for field:password in ESR-GUI VIM registration page
666 - `AAI-1100 <https://jira.onap.org/browse/AAI-1100>`_ OOM Resources and Traversal Config map missing release
668 - `AAI-1101 <https://jira.onap.org/browse/AAI-1101>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in OOM config
670 - `AAI-1105 <https://jira.onap.org/browse/AAI-1105>`_ aai-traversal job is failing when trying to start OOM
672 - `AAI-1106 <https://jira.onap.org/browse/AAI-1106>`_ aai-resources: scripts do not work properly with spring-boot
674 - `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
676 - `AAI-1108 <https://jira.onap.org/browse/AAI-1108>`_ [Babel] Remove license violations in latest commit.
678 - `AAI-1110 <https://jira.onap.org/browse/AAI-1110>`_ Model Loader logback.xml errors
680 - `AAI-1111 <https://jira.onap.org/browse/AAI-1111>`_ Update test-config project for Babel
682 - `AAI-1113 <https://jira.onap.org/browse/AAI-1113>`_ ESR VIM registration portal: Physical Location Id does not populate any data
684 - `AAI-1114 <https://jira.onap.org/browse/AAI-1114>`_ Security: [Champ] add Dockerfile and remove additional AJSC files
686 - `AAI-1116 <https://jira.onap.org/browse/AAI-1116>`_ [Gizmo] addressing Security vulnerabilities (Nexus IQ)
688 - `AAI-1117 <https://jira.onap.org/browse/AAI-1117>`_ [Champ] addressing Security vulnerabilities (Nexus IQ)
690 - `AAI-1118 <https://jira.onap.org/browse/AAI-1118>`_ [Gizmo] upgrade artefacts from aai-common to 1.2.4
692 - `AAI-1119 <https://jira.onap.org/browse/AAI-1119>`_ [Champ] Prevent deployment of Champ service jar
694 - `AAI-1120 <https://jira.onap.org/browse/AAI-1120>`_ [Gizmo] Fix Jacoco configuration
696 - `AAI-1121 <https://jira.onap.org/browse/AAI-1121>`_ Add the default realtime clients
698 - `AAI-1123 <https://jira.onap.org/browse/AAI-1123>`_ Babel logback.xml errors
700 - `AAI-1124 <https://jira.onap.org/browse/AAI-1124>`_ [router-core] NexusIQ reporting httpclient 4.5 vulnerability
702 - `AAI-1125 <https://jira.onap.org/browse/AAI-1125>`_ [data-router] NexusIQ reporting httpclient 4.5 vulnerability
704 - `AAI-1126 <https://jira.onap.org/browse/AAI-1126>`_ [Babel] Authorisation mechanism is not functioning
706 - `AAI-1127 <https://jira.onap.org/browse/AAI-1127>`_ [sparky-be] doesn't release artifacts because it is missing the staging plugin
708 - `AAI-1132 <https://jira.onap.org/browse/AAI-1132>`_ AAI's OOM server certificate doesn't include all k8 names
710 - `AAI-1133 <https://jira.onap.org/browse/AAI-1133>`_ AAI's haproxy server config doesn't include all k8 names
712 - `AAI-1134 <https://jira.onap.org/browse/AAI-1134>`_ OOF not defined in AAI realm properties files
714 - `AAI-1135 <https://jira.onap.org/browse/AAI-1135>`_ [traversal] closed loop named-query is missing property-collect-list
716 - `AAI-1136 <https://jira.onap.org/browse/AAI-1136>`_ Babel doesnt start in HEAT due to log directory permissions
718 - `AAI-1138 <https://jira.onap.org/browse/AAI-1138>`_ [Champ] Bump to 1.2.1-SNAPSHOT and 1.2.1 in version.properties
720 - `AAI-1139 <https://jira.onap.org/browse/AAI-1139>`_ [resources and traversal] do not release artifacts properly
722 - `AAI-1141 <https://jira.onap.org/browse/AAI-1141>`_ [champ] duplicate dependency in pom.xml
724 - `AAI-1142 <https://jira.onap.org/browse/AAI-1142>`_ [champ] doesn't create release artifacts
726 - `AAI-1143 <https://jira.onap.org/browse/AAI-1143>`_ [resources] createDbSchema.sh tries to add -SNAPSHOT version to classpath
728 - `AAI-1144 <https://jira.onap.org/browse/AAI-1144>`_ [oom and test-config] robot-ete is missing from realtime clients list
730 - `AAI-1146 <https://jira.onap.org/browse/AAI-1146>`_ [champ] daily build job is failing
732 - `AAI-1148 <https://jira.onap.org/browse/AAI-1148>`_ [Model-Loader] Rollback of VNF Images fails
734 - `AAI-1151 <https://jira.onap.org/browse/AAI-1151>`_ [Champ & Gizmo] Fix JJB jenkins jobs
736 - `AAI-1153 <https://jira.onap.org/browse/AAI-1153>`_ [Champ] Bump to 1.2.2-SNAPSHOT and 1.2.2 in version.properties
740 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.
744 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>`_.
748 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
749 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
750 - `R2 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=25441383>`_
755 :Release Date: 2018-01-18
759 - `AAI-456 <https://jira.onap.org/browse/AAI-456>`_ AAI named-query for policy not returning extra-properties
761 - `AAI-458 <https://jira.onap.org/browse/AAI-458>`_ [aai] ML, Search, DR, and Sparky Jenkins jobs not creating autorelease repo
763 - `AAI-459 <https://jira.onap.org/browse/AAI-459>`_ aai-common child pom still depends on openecomp artifacts
765 - `AAI-461 <https://jira.onap.org/browse/AAI-461>`_ AAI mS configuration files are using old openecomp params in test-config
767 - `AAI-462 <https://jira.onap.org/browse/AAI-462>`_ Fix the resources junit tests broken in windows environment
769 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
771 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
773 - `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
775 - `AAI-621 <https://jira.onap.org/browse/AAI-621>`_ Update the snapshot in test-config for v1.1.1-SNAPSHOT
780 :Release Date: 2017-11-16
784 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.
786 ONAP AAI R1 includes the following components:
788 - AAI Data Management
789 - Resources (CRUD operations)
790 - Traversal (Advanced search operations)
791 - Data Router (Route/persist AAI event data for consumption by the UI)
792 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
793 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
795 - Sparky (AAI User Interface)
797 Source code of AAI is released under the following repositories at https://gerrit.onap.org .
809 - aai/logging-service
814 - aai/search-data-service
822 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
823 - `AAI-20 <https://jira.onap.org/browse/AAI-20>`_ Champ Library
824 - `AAI-22 <https://jira.onap.org/browse/AAI-22>`_ Amsterdam User Case Schema Updates
825 - `AAI-23 <https://jira.onap.org/browse/AAI-23>`_ Model Loader Support for R1
826 - `AAI-58 <https://jira.onap.org/browse/AAI-58>`_ Define and build functional test cases for CSIT
827 - `AAI-72 <https://jira.onap.org/browse/AAI-72>`_ External System Register
828 - `AAI-254 <https://jira.onap.org/browse/AAI-254>`_ Documentation of REST APIs, dev guides, onboarding, etc.
829 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ Confguration enhancements
833 - `AAI-11 <https://jira.onap.org/browse/AAI-11>`_ robot_vm: demo.sh failing - '200' does not match '^(201|412)$' on vanilla openstack
835 - `AAI-13 <https://jira.onap.org/browse/AAI-13>`_ VM_init is failing to get sparky
837 - `AAI-31 <https://jira.onap.org/browse/AAI-31>`_ Compilation failure in aai-traversal
839 - `AAI-48 <https://jira.onap.org/browse/AAI-48>`_ AAI Common REST Client returns an error on a 204 (No Content) server response
841 - `AAI-49 <https://jira.onap.org/browse/AAI-49>`_ Health check is failing in DFW 1.1 RS. Connection refused
843 - `AAI-62 <https://jira.onap.org/browse/AAI-62>`_ Search Data Service should not implicitly create indexes on document write
845 - `AAI-63 <https://jira.onap.org/browse/AAI-63>`_ Data Router must handle Search Service document create failures if index does not exit
847 - `AAI-73 <https://jira.onap.org/browse/AAI-73>`_ Sparky sync issues
849 - `AAI-76 <https://jira.onap.org/browse/AAI-76>`_ Jenkins stage-site builds failing on resources and traversal
851 - `AAI-94 <https://jira.onap.org/browse/AAI-94>`_ AAI Certificate will expire 30 Nov 2017 - fyi
853 - `AAI-146 <https://jira.onap.org/browse/AAI-146>`_ Both esr-server and esr-gui Jenkins failed
855 - `AAI-192 <https://jira.onap.org/browse/AAI-192>`_ Model Loader depends on httpclient version 4.4.1
857 - `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
859 - `AAI-206 <https://jira.onap.org/browse/AAI-206>`_ Model based delete is failing
861 - `AAI-217 <https://jira.onap.org/browse/AAI-217>`_ Remove internal references from A&AI seed code
863 - `AAI-222 <https://jira.onap.org/browse/AAI-222>`_ the version property of esr-server is incorrect
865 - `AAI-224 <https://jira.onap.org/browse/AAI-224>`_ aai/esr-gui daily build failed
867 - `AAI-225 <https://jira.onap.org/browse/AAI-225>`_ aai/esr-server daily build failed
869 - `AAI-265 <https://jira.onap.org/browse/AAI-265>`_ EdgePropertyMap throws NullPointer if edge rule does not include property
871 - `AAI-266 <https://jira.onap.org/browse/AAI-266>`_ auth-info edge rule does not include contains-other-v
873 - `AAI-273 <https://jira.onap.org/browse/AAI-273>`_ Fix the esr-server setup error issue
875 - `AAI-278 <https://jira.onap.org/browse/AAI-278>`_ AAI throws exception about mismatch keys adding esr-system-info to cloud-region
877 - `AAI-293 <https://jira.onap.org/browse/AAI-293>`_ Jenkins job failing for aai-sparky-fe-master-release-version-java-daily
879 - `AAI-377 <https://jira.onap.org/browse/AAI-377>`_ esr-gui docker build failed
881 - `AAI-393 <https://jira.onap.org/browse/AAI-393>`_ The jjb defiend in a error way that cause CSIT build failed.
883 - `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
885 - `AAI-400 <https://jira.onap.org/browse/AAI-400>`_ Register ServiceTest to microservice
887 - `AAI-401 <https://jira.onap.org/browse/AAI-401>`_ Remove DMaaP router duplication
889 - `AAI-407 <https://jira.onap.org/browse/AAI-407>`_ There is an error to startup esr-gui docker
891 - `AAI-412 <https://jira.onap.org/browse/AAI-412>`_ Replace the type specification in this constructor call with the diamond operator ("<>")
893 - `AAI-417 <https://jira.onap.org/browse/AAI-417>`_ Rackspace 20170928 fails to authenticate nexus3 on 10003 during *_init.sh* (sdnc for example)
895 - `AAI-420 <https://jira.onap.org/browse/AAI-420>`_ Can not get the MSB address in esr-server
897 - `AAI-422 <https://jira.onap.org/browse/AAI-422>`_ The esr-server csit failed
899 - `AAI-424 <https://jira.onap.org/browse/AAI-424>`_ The integration catalog is not in use, should be removed
901 - `AAI-425 <https://jira.onap.org/browse/AAI-425>`_ Fix the artifact of esr-gui
903 - `AAI-426 <https://jira.onap.org/browse/AAI-426>`_ Fix the artifact of esr-server
905 - `AAI-431 <https://jira.onap.org/browse/AAI-431>`_ esr-gui files did not contained in webapp of tomcat
907 - `AAI-433 <https://jira.onap.org/browse/AAI-433>`_ Failed to pre-load vCPE data to AAI. No response from AAI
909 - `AAI-434 <https://jira.onap.org/browse/AAI-434>`_ Can not visit ESR portal with demo deployment
911 - `AAI-435 <https://jira.onap.org/browse/AAI-435>`_ default tenant need be input to A&AI while register VIM
913 - `AAI-436 <https://jira.onap.org/browse/AAI-436>`_ Call the API from MultiCloud failed
915 - `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
917 - `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
919 - `AAI-442 <https://jira.onap.org/browse/AAI-442>`_ Can't instantiate a service
921 - `AAI-444 <https://jira.onap.org/browse/AAI-444>`_ Cannot associate multiple service-instances to PNFs
923 - `AAI-446 <https://jira.onap.org/browse/AAI-446>`_ vnf to esr-system-info named-query is missing vnfc
925 - `AAI-448 <https://jira.onap.org/browse/AAI-448>`_ Remove snapshot dependencies from aai-common, data-router, and rest-client
927 - `AAI-450 <https://jira.onap.org/browse/AAI-450>`_ Named Query needs to be updated to return VNFC Info
929 - `AAI-453 <https://jira.onap.org/browse/AAI-453>`_ Fix stage-site jenkins job for aai-common
931 - `AAI-454 <https://jira.onap.org/browse/AAI-454>`_ LoggingContext.requestId required NULL handling in aai/aai-common (20170607) - during demo.sh init_customer
935 - `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.
937 Client systems should use http://org.openecomp.aai.inventory/v11 as the XML namespace for ONAP AAI R1.
941 See Common Vulnerabilities and Exposures `CVE <https://cve.mitre.org>`
943 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.
945 AAI uses HTTPS Basic Authentication.
949 This is an initial release
951 **Deprecation Notes**
953 AAI Amsterdam provides support for legacy versions of the API, v8 and v11 in this release. v11 is the latest and preferred version.