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