Update release notes for CMR
[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
10 Version: 1.3.1
11 --------------
12
13 :Release Date: 2019-01-31
14
15 **New Features**
16
17 The Casablanca Maintenance Release provides a number of security and
18 bug fixes. Highlights of the issues corrected in the Casablanca
19 Maintenance Release:
20
21 - `AAI-2047 <https://jira.onap.org/browse/AAI-2047>`_ Make success of createDbSchema job required to proceed in AAI startup
22
23 - `AAI-1923 <https://jira.onap.org/browse/AAI-1923>`_ Problem deleting due to EdgeRules in CCVPN usecase Casablanca
24
25 Dependencies were updated in multiple repos to patch security
26 vulnerabilities.
27
28 **Known Issues**
29
30 Users should pay special attention to `AAI-2064
31 <https://jira.onap.org/browse/AAI-2064>`_ and should consult `this
32 page <https://www.rabbitmq.com/ssl.html>`_ for instructions on how to
33 properly secure it if they are concerned about the issue.
34
35 **Security Notes**
36
37 AAI code has been formally scanned during build time using NexusIQ and
38 all Critical vulnerabilities have been addressed, items that remain
39 open have been assessed for risk and determined to be false
40 positive. The AAI open Critical security vulnerabilities and their
41 risk assessment have been documented as part of the `R3 project wiki
42 <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_.
43
44 Quick Links:
45
46 - `AAI main project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
47 - `CMR Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
48
49
50 Version: 1.3.0
51 --------------
52
53 :Release Date: 2018-11-30
54
55 **New Features**
56
57 The R3 Casablanca release of ONAP again focuses on platform maturity
58 and deployablity. AAI continued to leverage oom and kubernetes, and
59 added new data types in support of multiple R3 use cases.  AAI added a
60 new schema ingest library which moves AAI closer to being more
61 model-driven and a new microservice called "graphadmin" which provides
62 graph maintenance and configuration facilities.
63
64 AAI is more model driven in Casablanca, which means it dynamically
65 operationalize new and updated models at run-time, with minimal
66 downtime and coding, so that the latest service and resource models
67 can be delivered quickly. To do this, AAI must update its internal
68 model, external API and behavior to respond to change to service and
69 resource models, including schema changes. There are changes required
70 to align on implementation across different ONAP components to provide
71 a more strategic model-driven A&AI implementation. For this release
72 decomposing AAI model/schema artifacts (OXM/XSD) into a more granular
73 approach better enables extensibility and support logical
74 subdivision of models.
75
76 AAI added support fo the Cross Domain and Carrier Layer VPN use case
77 by adding new object types, models, and edge rules.
78
79 AAI delivered 50%+ test coverage on all Java-based repos.
80
81 Added support Support for SR-IOV.
82
83 Authentication and Authorization is performed using AAF with the
84 CADI framework. We use basic authentication with RBAC (Role Based
85 Access Control) to secure the AAI REST APIs.
86
87 AAI added automation support for orchestrating SR-IOV Provider
88 Networks that are compatible with the Network Cloud 1.0
89 infrastructure solution based on standard SR-IOV. Allow for standard
90 SR-IOV Provider Networks to be defined with a set of one or more
91 VLAN associations.
92
93 AAI added suport to allow clients to specify the format on GET
94 operations in the resources micoservices to output like the custom
95 query API does.
96
97 Added support for VLAN tagging.
98
99 **Known Issues**
100
101 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>`_
102
103 **Security Notes**
104
105 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>`_.
106
107 Quick Links:
108
109 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
110 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
111 - `Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=45307817>`_
112
113
114 Version: 1.2.0
115 --------------
116
117 :Release Date: 2018-06-07
118
119 **New Features**
120
121 The R2 Beijing release of ONAP focuses on platform maturity - to that
122 end, AAI has switched from Titan on hbase to JanusGraph on a
123 multi-replica cassandra deployment.  We have added several
124 microservices which will be fully operational in R3 Casablanca.
125 Another significant change in R2 is that we converted our
126 Microservices from ASJC 2 to Springboot 1.5.  AAI provides
127 configurations for orchestration via HEAT or via OOM / kubernetes for
128 scaling and resiliency.
129
130 AAI added champ, a graph abstraction microservice, and Gizmo, a new
131 way to perform CRUD operations on the graph in a more atomic way that
132 exposes more of the underlying graph infrastructure.  Babel is a new
133 microservice that does TOSCA model translation on behalf of model
134 loader.  Event client provides an abstraction for dmaap events.
135
136 ONAP AAI R2 includes the following components:
137
138 - AAI Data Management
139 - Resources (CRUD operations)
140 - Traversal (Advanced search operations)
141 - Data Router (Route/persist AAI event data for consumption by the UI)
142 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
143 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
144 - Babel (TOSCA translation for model-loader)
145 - Event-client (DMaaP abstraction
146 - Champ (Graph abstraction microservice)
147 - Applications
148 - Sparky (AAI User Interface)
149
150 Source code of AAI is released under the following repositories at https://gerrit.onap.org 
151
152 - aai/aai-common
153 - aai/event-client
154 - aai/babel
155 - aai/champ
156 - aai/data-router
157 - aai/esr-gui
158 - aai/esr-server
159 - aai/gizmo
160 - aai/logging-service
161 - aai/model-loader
162 - aai/resources
163 - aai/rest-client
164 - aai/router-core
165 - aai/search-data-service
166 - aai/sparky-be
167 - aai/sparky-fe
168 - aai/test-config
169 - aai/traversal
170
171 **Epic**
172
173 - `AAI-16 <https://jira.onap.org/browse/AAI-16>`_ A&AI Platform Deployment
174
175 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
176
177 - `AAI-21 <https://jira.onap.org/browse/AAI-21>`_ Gizmo 
178
179 - `AAI-24 <https://jira.onap.org/browse/AAI-24>`_ Move to Active Open Source Graph Database
180
181 - `AAI-38 <https://jira.onap.org/browse/AAI-38>`_ AAI Microservice to generate AAI model XML
182
183 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ This epic groups together the various requests for making AAI more configurable
184
185 - `AAI-466 <https://jira.onap.org/browse/AAI-466>`_ Beijing R2 AAI Schema Updates
186
187 - `AAI-680 <https://jira.onap.org/browse/AAI-680>`_ HPA Use Case Support in AAI
188
189 - `AAI-681 <https://jira.onap.org/browse/AAI-681>`_ Change Management Use Case Support in AAI
190
191 - `AAI-682 <https://jira.onap.org/browse/AAI-682>`_ Scale Out Use Case Support in AAI
192
193 - `AAI-769 <https://jira.onap.org/browse/AAI-769>`_ Required updates to the v13 REST API
194
195 **Bug Fixes**
196
197 - `AAI-129 <https://jira.onap.org/browse/AAI-129>`_ RestClientBuilder SSL protocol should be configurable
198
199 - `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
200
201 - `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
202
203 - `AAI-295 <https://jira.onap.org/browse/AAI-295>`_ ChampDAO tests failing in gizmo
204
205 - `AAI-460 <https://jira.onap.org/browse/AAI-460>`_ vm1-aai-inst1 aai-resources fails to start
206
207 - `AAI-463 <https://jira.onap.org/browse/AAI-463>`_ Wrong Error message when we use PUT instead of POST to create the relationship
208
209 - `AAI-521 <https://jira.onap.org/browse/AAI-521>`_ A&AI resources container sporadically hangs on startup
210
211 - `AAI-523 <https://jira.onap.org/browse/AAI-523>`_ Sparky UI does not display RelationshipList nodes
212
213 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
214
215 - `AAI-559 <https://jira.onap.org/browse/AAI-559>`_ CSIT jobs should use a set of streams, not a list of branches
216
217 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
218
219 - `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
220
221 - `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
222
223 - `AAI-603 <https://jira.onap.org/browse/AAI-603>`_ Sonar only push to master
224
225 - `AAI-666 <https://jira.onap.org/browse/AAI-666>`_ aai/datarouter startup fails to find logback.xml
226
227 - `AAI-679 <https://jira.onap.org/browse/AAI-679>`_ A&AI UI failed to search service-instance based on service-instance-id
228
229 - `AAI-699 <https://jira.onap.org/browse/AAI-699>`_ SDC Tosca does not generate Groups from resource yaml
230
231 - `AAI-738 <https://jira.onap.org/browse/AAI-738>`_ When register service to MSB, esr-server still will register to MSB automaticly
232
233 - `AAI-788 <https://jira.onap.org/browse/AAI-788>`_ fix the cookie decryption algorithm
234
235 - `AAI-796 <https://jira.onap.org/browse/AAI-796>`_ AAI is logging %PARSER_ERROR instead of REMOTE_USER
236
237 - `AAI-833 <https://jira.onap.org/browse/AAI-833>`_ The url of query vim type from multiCloud is incorrect
238
239 - `AAI-838 <https://jira.onap.org/browse/AAI-838>`_ Add back the properties that got removed
240
241 - `AAI-874 <https://jira.onap.org/browse/AAI-874>`_ Fix the test-config traversal aaiconfig to use proper timeout keys
242
243 - `AAI-948 <https://jira.onap.org/browse/AAI-948>`_ aai-rest-client build fails with non-resolvable parent POM
244
245 - `AAI-961 <https://jira.onap.org/browse/AAI-961>`_ Fix aai-sparky-be-master-aai-docker-java-daily
246
247 - `AAI-985 <https://jira.onap.org/browse/AAI-985>`_ Sparky-be: Change dependency to make use of sparky-fe war file from Beijing version
248
249 - `AAI-987 <https://jira.onap.org/browse/AAI-987>`_ Update ML with the latest changes
250
251 - `AAI-993 <https://jira.onap.org/browse/AAI-993>`_ Champ docker image name incorrect
252
253 - `AAI-994 <https://jira.onap.org/browse/AAI-994>`_ Crud-service (Gizmo) docker tag version is incorrect
254
255 - `AAI-995 <https://jira.onap.org/browse/AAI-995>`_ Gizmo docker image name incorrect
256
257 - `AAI-996 <https://jira.onap.org/browse/AAI-996>`_ Change ML pom file to address build failure problems
258
259 - `AAI-1005 <https://jira.onap.org/browse/AAI-1005>`_ Fix docker-compose-db.yml in test-config
260
261 - `AAI-1006 <https://jira.onap.org/browse/AAI-1006>`_ Babel start script does not set all required properties
262
263 - `AAI-1007 <https://jira.onap.org/browse/AAI-1007>`_ Babel: java.lang.NoClassDefFoundError: com/att/aft/dme2/internal/gson/JsonSyntaxException
264
265 - `AAI-1016 <https://jira.onap.org/browse/AAI-1016>`_ Model-loader: properties files are incorrectly named and have errors
266
267 - `AAI-1017 <https://jira.onap.org/browse/AAI-1017>`_ Fix Champ build - incorrect definition of Java system path
268
269 - `AAI-1018 <https://jira.onap.org/browse/AAI-1018>`_ Model-loader: CONF_INVALID_MSG_BUS_ADDRESS
270
271 - `AAI-1019 <https://jira.onap.org/browse/AAI-1019>`_ aai-resources: does not require username/password after springboot upgrade
272
273 - `AAI-1020 <https://jira.onap.org/browse/AAI-1020>`_ aai-traversal: does not require username/password after springboot upgrade
274
275 - `AAI-1024 <https://jira.onap.org/browse/AAI-1024>`_ Test-config: model-loader MSG_BUS_ADDRESSES not set
276
277 - `AAI-1025 <https://jira.onap.org/browse/AAI-1025>`_ Test-config: traversal updateQueryData.sh fails to update models and queries
278
279 - `AAI-1026 <https://jira.onap.org/browse/AAI-1026>`_ test-config: model-loader is attempting 2-way TLS with AAI
280
281 - `AAI-1027 <https://jira.onap.org/browse/AAI-1027>`_ ModelLoader basic auth failure with aai-resources
282
283 - `AAI-1029 <https://jira.onap.org/browse/AAI-1029>`_ The DOC about ESR installation should be update
284
285 - `AAI-1034 <https://jira.onap.org/browse/AAI-1034>`_ [sparky-be] Portal API Proxy missing from Spring Boot Sparky
286
287 - `AAI-1035 <https://jira.onap.org/browse/AAI-1035>`_ Security: Springboot 1.5.10 has new nexusIQ critical exceptions
288
289 - `AAI-1038 <https://jira.onap.org/browse/AAI-1038>`_ Babel missing .gitreview file
290
291 - `AAI-1049 <https://jira.onap.org/browse/AAI-1049>`_ [Model Loader] - Remove dependency on PowerMockito
292
293 - `AAI-1051 <https://jira.onap.org/browse/AAI-1051>`_ API Spec is specifying v12 in v13 file
294
295 - `AAI-1052 <https://jira.onap.org/browse/AAI-1052>`_ AAI is using -SNAPSHOT artifacts; remove -SNAPSHOT dependencies
296
297 - `AAI-1077 <https://jira.onap.org/browse/AAI-1077>`_ [Babel] master daily build job is not creating an autorelease staging repo
298
299 - `AAI-1082 <https://jira.onap.org/browse/AAI-1082>`_ Champ janus version incompatible with Resources janus version
300
301 - `AAI-1084 <https://jira.onap.org/browse/AAI-1084>`_ POST with PATCH override call is returning 405
302
303 - `AAI-1086 <https://jira.onap.org/browse/AAI-1086>`_ Babel: Compressed files contain proprietary markings
304
305 - `AAI-1088 <https://jira.onap.org/browse/AAI-1088>`_ aai-common: version.properties refers to previous patch release
306
307 - `AAI-1089 <https://jira.onap.org/browse/AAI-1089>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in HEAT config
308
309 - `AAI-1090 <https://jira.onap.org/browse/AAI-1090>`_ v13 does not support External System under cloud region
310
311 - `AAI-1091 <https://jira.onap.org/browse/AAI-1091>`_ ESR fails to register EMS
312
313 - `AAI-1094 <https://jira.onap.org/browse/AAI-1094>`_ Model-loader: failure to negotiate with message router in OOM
314
315 - `AAI-1096 <https://jira.onap.org/browse/AAI-1096>`_ Increase length for field:password in ESR-GUI VIM registration page
316
317 - `AAI-1100 <https://jira.onap.org/browse/AAI-1100>`_ OOM Resources and Traversal Config map missing release
318
319 - `AAI-1101 <https://jira.onap.org/browse/AAI-1101>`_ haproxy, aai-resources, and aai-traversal using outdated certificate in OOM config
320
321 - `AAI-1105 <https://jira.onap.org/browse/AAI-1105>`_ aai-traversal job is failing when trying to start OOM
322
323 - `AAI-1106 <https://jira.onap.org/browse/AAI-1106>`_ aai-resources: scripts do not work properly with spring-boot
324
325 - `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
326
327 - `AAI-1108 <https://jira.onap.org/browse/AAI-1108>`_ [Babel] Remove license violations in latest commit.
328
329 - `AAI-1110 <https://jira.onap.org/browse/AAI-1110>`_ Model Loader logback.xml errors
330
331 - `AAI-1111 <https://jira.onap.org/browse/AAI-1111>`_ Update test-config project for Babel
332
333 - `AAI-1113 <https://jira.onap.org/browse/AAI-1113>`_ ESR VIM registration portal: Physical Location Id does not populate any data
334
335 - `AAI-1114 <https://jira.onap.org/browse/AAI-1114>`_ Security: [Champ] add Dockerfile and remove additional AJSC files
336
337 - `AAI-1116 <https://jira.onap.org/browse/AAI-1116>`_ [Gizmo] addressing Security vulnerabilities (Nexus IQ)
338
339 - `AAI-1117 <https://jira.onap.org/browse/AAI-1117>`_ [Champ] addressing Security vulnerabilities (Nexus IQ)
340
341 - `AAI-1118 <https://jira.onap.org/browse/AAI-1118>`_ [Gizmo] upgrade artefacts from aai-common to 1.2.4
342
343 - `AAI-1119 <https://jira.onap.org/browse/AAI-1119>`_ [Champ] Prevent deployment of Champ service jar
344
345 - `AAI-1120 <https://jira.onap.org/browse/AAI-1120>`_ [Gizmo] Fix Jacoco configuration
346
347 - `AAI-1121 <https://jira.onap.org/browse/AAI-1121>`_ Add the default realtime clients
348
349 - `AAI-1123 <https://jira.onap.org/browse/AAI-1123>`_ Babel logback.xml errors
350
351 - `AAI-1124 <https://jira.onap.org/browse/AAI-1124>`_ [router-core] NexusIQ reporting httpclient 4.5 vulnerability
352
353 - `AAI-1125 <https://jira.onap.org/browse/AAI-1125>`_ [data-router] NexusIQ reporting httpclient 4.5 vulnerability
354
355 - `AAI-1126 <https://jira.onap.org/browse/AAI-1126>`_ [Babel] Authorisation mechanism is not functioning
356
357 - `AAI-1127 <https://jira.onap.org/browse/AAI-1127>`_ [sparky-be] doesn't release artifacts because it is missing the staging plugin
358
359 - `AAI-1132 <https://jira.onap.org/browse/AAI-1132>`_ AAI's OOM server certificate doesn't include all k8 names
360
361 - `AAI-1133 <https://jira.onap.org/browse/AAI-1133>`_ AAI's haproxy server config doesn't include all k8 names
362
363 - `AAI-1134 <https://jira.onap.org/browse/AAI-1134>`_ OOF not defined in AAI realm properties files
364
365 - `AAI-1135 <https://jira.onap.org/browse/AAI-1135>`_ [traversal] closed loop named-query is missing property-collect-list
366
367 - `AAI-1136 <https://jira.onap.org/browse/AAI-1136>`_ Babel doesnt start in HEAT due to log directory permissions
368
369 - `AAI-1138 <https://jira.onap.org/browse/AAI-1138>`_ [Champ] Bump to 1.2.1-SNAPSHOT and 1.2.1 in version.properties
370
371 - `AAI-1139 <https://jira.onap.org/browse/AAI-1139>`_ [resources and traversal] do not release artifacts properly
372
373 - `AAI-1141 <https://jira.onap.org/browse/AAI-1141>`_ [champ] duplicate dependency in pom.xml
374
375 - `AAI-1142 <https://jira.onap.org/browse/AAI-1142>`_ [champ] doesn't create release artifacts
376
377 - `AAI-1143 <https://jira.onap.org/browse/AAI-1143>`_ [resources] createDbSchema.sh tries to add -SNAPSHOT version to classpath
378
379 - `AAI-1144 <https://jira.onap.org/browse/AAI-1144>`_ [oom and test-config] robot-ete is missing from realtime clients list
380
381 - `AAI-1146 <https://jira.onap.org/browse/AAI-1146>`_ [champ] daily build job is failing
382
383 - `AAI-1148 <https://jira.onap.org/browse/AAI-1148>`_ [Model-Loader] Rollback of VNF Images fails
384
385 - `AAI-1151 <https://jira.onap.org/browse/AAI-1151>`_ [Champ & Gizmo] Fix JJB jenkins jobs
386
387 - `AAI-1153 <https://jira.onap.org/browse/AAI-1153>`_ [Champ] Bump to 1.2.2-SNAPSHOT and 1.2.2 in version.properties
388
389 **Known Issues**
390
391 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.
392
393 **Security Notes**
394
395 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>`_.
396
397 Quick Links:
398
399 - `AAI project page <https://wiki.onap.org/display/DW/Active+and+Available+Inventory+Project>`_
400 - `Passing Badge information for AAI <https://bestpractices.coreinfrastructure.org/en/projects/1591>`_
401 - `R2 Project Vulnerability Review Table for AAI <https://wiki.onap.org/pages/viewpage.action?pageId=25441383>`_
402
403 Version: 1.1.1
404 --------------
405
406 :Release Date: 2018-01-18
407
408 **Bug Fixes**
409
410 - `AAI-456 <https://jira.onap.org/browse/AAI-456>`_ AAI named-query for policy not returning extra-properties
411
412 - `AAI-458 <https://jira.onap.org/browse/AAI-458>`_ [aai] ML, Search, DR, and Sparky Jenkins jobs not creating autorelease repo
413
414 - `AAI-459 <https://jira.onap.org/browse/AAI-459>`_ aai-common child pom still depends on openecomp artifacts
415
416 - `AAI-461 <https://jira.onap.org/browse/AAI-461>`_ AAI mS configuration files are using old openecomp params in test-config
417
418 - `AAI-462 <https://jira.onap.org/browse/AAI-462>`_ Fix the resources junit tests broken in windows environment
419
420 - `AAI-558 <https://jira.onap.org/browse/AAI-558>`_ aai-resources java daily jenkins job is failing
421
422 - `AAI-561 <https://jira.onap.org/browse/AAI-561>`_ aai-traversal java daily jenkins job is failing
423
424 - `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
425
426 - `AAI-621 <https://jira.onap.org/browse/AAI-621>`_ Update the snapshot in test-config for v1.1.1-SNAPSHOT
427                
428 Version: 1.1.0
429 --------------
430
431 :Release Date: 2017-11-16
432
433 **New Features**
434
435 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. 
436
437 ONAP AAI R1 includes the following components:
438
439 - AAI Data Management
440 - Resources (CRUD operations)
441 - Traversal (Advanced search operations)
442 - Data Router (Route/persist AAI event data for consumption by the UI)
443 - Model Loader (Obtains SDC artifacts and loads them into the A&AI Resources service for storage)
444 - Search Data Service (Abstraction layer for searchengine, supporting queries and updates)
445 - Applications
446 - Sparky (AAI User Interface)
447
448 Source code of AAI is released under the following repositories at https://gerrit.onap.org .
449
450 - aai/aai-common
451 - aai/aai-config
452 - aai/aai-data
453 - aai/aai-service
454 - aai/babel
455 - aai/champ
456 - aai/data-router
457 - aai/esr-gui
458 - aai/esr-server
459 - aai/gizmo
460 - aai/logging-service
461 - aai/model-loader
462 - aai/resources
463 - aai/rest-client
464 - aai/router-core
465 - aai/search-data-service
466 - aai/sparky-be
467 - aai/sparky-fe
468 - aai/test-config
469 - aai/traversal
470
471 **Epic**
472
473 - `AAI-17 <https://jira.onap.org/browse/AAI-17>`_ Seed code stabilization
474 - `AAI-20 <https://jira.onap.org/browse/AAI-20>`_ Champ Library
475 - `AAI-22 <https://jira.onap.org/browse/AAI-22>`_ Amsterdam User Case Schema Updates
476 - `AAI-23 <https://jira.onap.org/browse/AAI-23>`_ Model Loader Support for R1
477 - `AAI-58 <https://jira.onap.org/browse/AAI-58>`_ Define and build functional test cases for CSIT
478 - `AAI-72 <https://jira.onap.org/browse/AAI-72>`_ External System Register
479 - `AAI-254 <https://jira.onap.org/browse/AAI-254>`_ Documentation of REST APIs, dev guides, onboarding, etc.
480 - `AAI-280 <https://jira.onap.org/browse/AAI-280>`_ Confguration enhancements
481
482 **Bug Fixes**
483
484 - `AAI-11 <https://jira.onap.org/browse/AAI-11>`_ robot_vm: demo.sh failing - '200' does not match '^(201|412)$' on vanilla openstack
485
486 - `AAI-13 <https://jira.onap.org/browse/AAI-13>`_ VM_init is failing to get sparky
487
488 - `AAI-31 <https://jira.onap.org/browse/AAI-31>`_ Compilation failure in aai-traversal
489
490 - `AAI-48 <https://jira.onap.org/browse/AAI-48>`_ AAI Common REST Client returns an error on a 204 (No Content) server response
491
492 - `AAI-49 <https://jira.onap.org/browse/AAI-49>`_ Health check is failing in DFW 1.1 RS. Connection refused
493
494 - `AAI-62 <https://jira.onap.org/browse/AAI-62>`_ Search Data Service should not implicitly create indexes on document write
495
496 - `AAI-63 <https://jira.onap.org/browse/AAI-63>`_ Data Router must handle Search Service document create failures if index does not exit
497
498 - `AAI-73 <https://jira.onap.org/browse/AAI-73>`_ Sparky sync issues
499
500 - `AAI-76 <https://jira.onap.org/browse/AAI-76>`_ Jenkins stage-site builds failing on resources and traversal
501
502 - `AAI-94 <https://jira.onap.org/browse/AAI-94>`_ AAI Certificate will expire 30 Nov 2017 - fyi
503
504 - `AAI-146 <https://jira.onap.org/browse/AAI-146>`_ Both esr-server and esr-gui Jenkins failed
505
506 - `AAI-192 <https://jira.onap.org/browse/AAI-192>`_ Model Loader depends on httpclient version 4.4.1
507
508 - `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
509
510 - `AAI-206 <https://jira.onap.org/browse/AAI-206>`_ Model based delete is failing
511
512 - `AAI-217 <https://jira.onap.org/browse/AAI-217>`_ Remove internal references from A&AI seed code
513
514 - `AAI-222 <https://jira.onap.org/browse/AAI-222>`_ the version property of esr-server is incorrect
515
516 - `AAI-224 <https://jira.onap.org/browse/AAI-224>`_ aai/esr-gui daily build failed
517
518 - `AAI-225 <https://jira.onap.org/browse/AAI-225>`_ aai/esr-server daily build failed
519
520 - `AAI-265 <https://jira.onap.org/browse/AAI-265>`_ EdgePropertyMap throws NullPointer if edge rule does not include property
521
522 - `AAI-266 <https://jira.onap.org/browse/AAI-266>`_ auth-info edge rule does not include contains-other-v
523
524 - `AAI-273 <https://jira.onap.org/browse/AAI-273>`_ Fix the esr-server setup error issue
525
526 - `AAI-278 <https://jira.onap.org/browse/AAI-278>`_ AAI throws exception about mismatch keys adding esr-system-info to cloud-region
527
528 - `AAI-293 <https://jira.onap.org/browse/AAI-293>`_ Jenkins job failing for aai-sparky-fe-master-release-version-java-daily
529
530 - `AAI-377 <https://jira.onap.org/browse/AAI-377>`_ esr-gui docker build failed
531
532 - `AAI-393 <https://jira.onap.org/browse/AAI-393>`_ The jjb defiend in a error way that cause CSIT build failed.
533
534 - `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
535
536 - `AAI-400 <https://jira.onap.org/browse/AAI-400>`_ Register ServiceTest to microservice
537
538 - `AAI-401 <https://jira.onap.org/browse/AAI-401>`_ Remove DMaaP router duplication
539
540 - `AAI-407 <https://jira.onap.org/browse/AAI-407>`_ There is an error to startup esr-gui docker
541
542 - `AAI-412 <https://jira.onap.org/browse/AAI-412>`_ Replace the type specification in this constructor call with the diamond operator ("<>")
543
544 - `AAI-417 <https://jira.onap.org/browse/AAI-417>`_ Rackspace 20170928 fails to authenticate nexus3 on 10003 during *_init.sh* (sdnc for example)
545
546 - `AAI-420 <https://jira.onap.org/browse/AAI-420>`_ Can not get the MSB address in esr-server
547
548 - `AAI-422 <https://jira.onap.org/browse/AAI-422>`_ The esr-server csit failed
549
550 - `AAI-424 <https://jira.onap.org/browse/AAI-424>`_ The integration catalog is not in use, should be removed
551
552 - `AAI-425 <https://jira.onap.org/browse/AAI-425>`_ Fix the artifact of esr-gui
553
554 - `AAI-426 <https://jira.onap.org/browse/AAI-426>`_ Fix the artifact of esr-server
555
556 - `AAI-431 <https://jira.onap.org/browse/AAI-431>`_ esr-gui files did not contained in webapp of tomcat
557
558 - `AAI-433 <https://jira.onap.org/browse/AAI-433>`_ Failed to pre-load vCPE data to AAI. No response from AAI
559
560 - `AAI-434 <https://jira.onap.org/browse/AAI-434>`_ Can not visit ESR portal with demo deployment
561
562 - `AAI-435 <https://jira.onap.org/browse/AAI-435>`_ default tenant need be input to A&AI while register VIM
563
564 - `AAI-436 <https://jira.onap.org/browse/AAI-436>`_ Call the API from MultiCloud failed
565
566 - `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
567
568 - `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
569
570 - `AAI-442 <https://jira.onap.org/browse/AAI-442>`_ Can't instantiate a service
571
572 - `AAI-444 <https://jira.onap.org/browse/AAI-444>`_ Cannot associate multiple service-instances to PNFs
573
574 - `AAI-446 <https://jira.onap.org/browse/AAI-446>`_ vnf to esr-system-info named-query is missing vnfc
575
576 - `AAI-448 <https://jira.onap.org/browse/AAI-448>`_ Remove snapshot dependencies from aai-common, data-router, and rest-client
577
578 - `AAI-450 <https://jira.onap.org/browse/AAI-450>`_ Named Query needs to be updated to return VNFC Info
579
580 - `AAI-453 <https://jira.onap.org/browse/AAI-453>`_ Fix stage-site jenkins job for aai-common
581
582 - `AAI-454 <https://jira.onap.org/browse/AAI-454>`_ LoggingContext.requestId required NULL handling in aai/aai-common (20170607) - during demo.sh init_customer
583
584 **Known Issues**
585
586 - `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.
587           
588 Client systems should use http://org.openecomp.aai.inventory/v11 as the XML namespace for ONAP AAI R1.
589
590 **Security Issues**
591
592 See Common Vulnerabilities and Exposures `CVE <https://cve.mitre.org>`
593
594 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.
595
596 AAI uses HTTPS Basic Authentication.
597
598 **Upgrade Notes**
599
600 This is an initial release
601
602 **Deprecation Notes**
603
604 AAI Amsterdam provides support for legacy versions of the API, v8 and v11 in this release.  v11 is the latest and preferred version.
605
606 **Other**
607
608 ===========
609
610 End of Release Notes