docs/release-notes.rst

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