docs/release-notes.rst

   1 .. ============LICENSE_START==========================================
   2 .. ===================================================================
   3 .. Copyright © 2017-2019 AT&T Intellectual Property. All rights reserved.
   4 .. ===================================================================
   5 .. Licensed under the Creative Commons License, Attribution 4.0 Intl.  (the "License");
   6 .. you may not use this documentation except in compliance with the License.
   7 .. You may obtain a copy of the License at
   8 ..
   9 ..  https://creativecommons.org/licenses/by/4.0/
  10 ..
  11 .. Unless required by applicable law or agreed to in writing, software
  12 .. distributed under the License is distributed on an "AS IS" BASIS,
  13 .. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 .. See the License for the specific language governing permissions and
  15 .. limitations under the License.
  16 .. ============LICENSE_END============================================
  17 .. _release_notes:
  18
  19 Release Notes
  20 =============
  21
  22 .. note
  23 ..      * This Release Notes must be updated each time the team decides to Release new artifacts.
  24 ..      * The scope of this Release Notes is for this particular component. In other words, each ONAP component has its Release Notes.
  25 ..      * This Release Notes is cumulative, the most recently Released artifact is made visible in the top of this Release Notes.
  26 ..      * Except the date and the version number, all the other sections are optional but there must be at least one section describing the purpose of this new release.
  27 ..      * This note must be removed after content has been added.
  28
  29
  30 Abstract
  31 ========
  32
  33 This document provides the release notes for the Application Controller Project's Frankfurt release.
  34
  35 Summary
  36 =======
  37
  38 The Application Controller (APPC) performs functions to manage the lifecycle of VNFs and their components providing model driven configuration, abstracts cloud/VNF interfaces for repeatable actions, uses vendor agnostic mechanisms (NETCONF, Chef via Chef Server and Ansible) and enables automation.
  39
  40 Release Data
  41 ============
  42
  43 Version: 1.7.2
  44 --------------
  45
  46 :Release Date: 2020-5-23
  47
  48
  49 New features
  50 ------------
  51
  52          - Upgraded OpenDaylight (ODL) version to Neon SR1
  53
  54          - Added support for the following LCM actions (a desciption of all of the above LCM actions can be found in the APPC LCM API Guide on readthedoc):
  55
  56                 - ActivateNESw
  57
  58                 - ConfigScaleIn
  59
  60                 - DownloadNESw
  61
  62                 - GetConfig
  63
  64                 - LicenseManagement
  65
  66                 - PostEvacuate
  67
  68                 - PostMigrate
  69
  70                 - PostRebuild
  71
  72                 - PreConfigure
  73
  74                 - PreEvacuate
  75
  76                 - PreMigrate
  77
  78                 - PreRebuild
  79
  80                 - Provisioning
  81
  82                 - StartTraffic
  83
  84                 - StatusTraffic
  85
  86                 - StopTraffic
  87
  88          - Move northbound DMAAP adapter out from ODL OSGI Karaf base
  89
  90          - vnfc/vf-module/v-server operations support for ansible LCMs
  91
  92          - Resource resolution via CDS
  93
  94
  95 Known Limitations, Issues and Workarounds
  96 =========================================
  97
  98 System Limitations
  99 ------------------
 100
 101  - OpenStack Restriction:
 102
 103                 - Currently APPC only supports OpenStack.
 104
 105                 - Admin level access for Tenant level operations.
 106
 107                 - OpenStack Hypervisorcheck is turned off by default.
 108
 109  - Netconf Restriction:
 110
 111                 - Currently APPC only tested with Honeycomb.
 112
 113 Known Vulnerabilities
 114 ---------------------
 115
 116 * `AAF-987 <https://jira.onap.org/browse/AAF-987>`_ - Bath function in AAF can not be functioned with different users and roles, which are associated with Opendaylight AAA users.
 117
 118 Workarounds
 119 -----------
 120
 121
 122 Security Notes
 123 --------------
 124
 125  - Password removal from helm charts
 126
 127  - Allow overriding of keystore and truststore in APPC helm charts
 128
 129  - All application processes are running non-root user in containers
 130
 131 References
 132 ==========
 133
 134 For more information on the ONAP Frankfurt release, please see:
 135
 136 #. `ONAP Home Page`_
 137 #. `ONAP Documentation`_
 138 #. `ONAP Release Downloads`_
 139 #. `ONAP Wiki Page`_
 140
 141
 142 .. _`ONAP Home Page`: https://www.onap.org
 143 .. _`ONAP Wiki Page`: https://wiki.onap.org
 144 .. _`ONAP Documentation`: https://docs.onap.org
 145 .. _`ONAP Release Downloads`: https://git.onap.org
 146
 147
 148 ..      ==========================
 149 ..      * * *     EL ALTO    * * *
 150 ..      ==========================
 151
 152
 153 Version: 1.6.4
 154 --------------
 155
 156 :Release Date: 2019-9-30
 157
 158 The El Alto added the following feature, bug fixes and security enhancements:
 159
 160 **New Features**
 161
 162          - Upgraded OpenDaylight (ODL) version to Fluorine SR2
 163
 164 **Bug Fixes**
 165
 166       - `APPC-1319 <https://jira.onap.org/browse/APPC-1319>`_ - apidoc shows ""undefined"" when netconf successfully mounted
 167       - `APPC-1584 <https://jira.onap.org/browse/APPC-1584>`_ - Incorrect Package name in Audit Directed Graph
 168       - `APPC-1587 <https://jira.onap.org/browse/APPC-1587>`_ - Publish config field mismatch in onap documentaion & Audit DG
 169       - `APPC-1588 <https://jira.onap.org/browse/APPC-1588>`_ - Publish config filed missing in Sync LCM in documentation
 170       - `APPC-1589 <https://jira.onap.org/browse/APPC-1589>`_ - Cvaas directory is not mounted in docker image,Dublin Release
 171       - `APPC-1590 <https://jira.onap.org/browse/APPC-1590>`_ - Sync & Audit Payload to include the file name
 172       - `APPC-1604 <https://jira.onap.org/browse/APPC-1604>`_ - APPC Not Picking up Mesasges from Dmaap
 173       - `APPC-1613 <https://jira.onap.org/browse/APPC-1613>`_ - Exception for LCM request with parameter read from A&AI
 174       - `APPC-1627 <https://jira.onap.org/browse/APPC-1627>`_ - Daexim directory owned by root - access denied during boot
 175       - `APPC-1634 <https://jira.onap.org/browse/APPC-1634>`_ - Mark the fields transient of RequestFailedException.java Serializable class to full-fill Serializable class contract,
 176       - `APPC-1635 <https://jira.onap.org/browse/APPC-1635>`_ - Mark the fields transient of EventMessage.java Serializable class to full-fill Serializable class contract
 177       - `APPC-1639 <https://jira.onap.org/browse/APPC-1639>`_ - Error during CDT SQL query
 178       - `APPC-1713 <https://jira.onap.org/browse/APPC-1713>`_ - Appc eelf logging resource bundle error after ODL upgrade
 179       - `APPC-1736 <https://jira.onap.org/browse/APPC-1736>`_ - change mountpoint for pax property file
 180
 181 **Known Issues**
 182
 183       - `APPC-1710 <https://jira.onap.org/browse/APPC-1710>`_ - Need for "ReadWriteMany" access on storage when deploying on Kubernetes?
 184          - to work around this is to add "accessMode: ReadWriteOnce" to values.yaml in APPC helm chart
 185       - `APPC-1766 <https://jira.onap.org/browse/APPC-1766>`_ - openStackEncryptedPassword value is not encrypted
 186          - to work around this is to change "provider1.tenant1.password={{.Values.config.openStackEncryptedPassword}}" to "provider1.tenant1.password=<non-encrypted plaintext password>" in APPC helm chart's appc.properties.
 187
 188
 189 **Security Notes**
 190
 191 *Fixed Security Issues*
 192
 193       - `OJSI-25 <https://jira.onap.org/browse/OJSI-25>`_ - SQL Injection in APPC (CVE-2019-12316)
 194       - `OJSI-104 <https://jira.onap.org/browse/OJSI-104>`_ - appc exposes plain text HTTP endpoint using port 30211
 195       - `OJSI-113 <https://jira.onap.org/browse/OJSI-113>`_ - appc exposes plain text HTTP endpoint using port 30230
 196       - `OJSI-146 <https://jira.onap.org/browse/OJSI-146>`_ - appc-cdt exposes plain text HTTP endpoint using port 30289
 197       - `OJSI-185 <https://jira.onap.org/browse/OJSI-185>`_ - appc exposes ssh service on port 30231
 198         SSH is exposed by ODL in order to use NETCONF within SSH session based on `RFC-6242 <https://tools.ietf.org/html/rfc6242>` so currently it cannot be avoided.
 199         Taken into account that this design is well documented in RFC, we no longer consider this to be a security issue but only a hardening opportunity.
 200
 201 Version: 1.5.3
 202 --------------
 203
 204 :Release Date: 2019-6-19
 205
 206 **New Features**
 207
 208 The Dublin release added the following functionality:
 209
 210          - Upgraded OpenDaylight (ODL) version to Fluorine SR1
 211
 212          - Migrated CDT docker to node.js base docker image
 213
 214          - Added support for the following LCM actions (a desciption of all of the above LCM actions can be found in the APPC LCM API Guide on readthedoc):
 215
 216          - To support in-place software upgrade:
 217
 218                 - DistributeTrafficCheck
 219
 220          - Added Multiple standalone ansible servers support
 221
 222          - Additional contributions as part of Dublin include:
 223
 224                 - Test Coverage increased to 83.8%
 225
 226                 - Support for Platform Maturity requirements, including:
 227
 228                    - Security
 229
 230                          - Applicaton runs as non-root user in all APPC dockers
 231
 232                          - Migrated to https for CDT GUI
 233
 234                    - Stability
 235
 236                           - Executed 72 hour stability test on both Heat and OOM deployed environments using JMeter to drive a steady set of transactions over the 72 hour period (see the following wiki page for more details: https://wiki.onap.org/display/DW/APPC+72+Hour+Stability+Testing+Dublin )
 237
 238                    - Resiliency
 239
 240                           - Support for OOM deployment, which enables resiliency via use of Kubernetes (see https://wiki.onap.org/display/DW/APPC+Resiliency for additional details)
 241
 242
 243 **Bug Fixes**
 244
 245       - `APPC-1242 <https://jira.onap.org/browse/APPC-1242>`_ - vFWCL ModifyConfig only works on one node in an APPC cluster.
 246       - `APPC-1263 <https://jira.onap.org/browse/APPC-1263>`_ - Two methods of Artifact Transformer in appc-config-params will always return null.
 247       - `APPC-1264 <https://jira.onap.org/browse/APPC-1264>`_ - Errors in unit tests in config-generator package.
 248       - `APPC-1270 <https://jira.onap.org/browse/APPC-1270>`_ - Unit tests in ccadaptor code not testing correctly.
 249       - `APPC-1274 <https://jira.onap.org/browse/APPC-1274>`_ - APPC DG : RestAdapter plugin : lack of documentation.
 250       - `APPC-1303 <https://jira.onap.org/browse/APPC-1303>`_ - DependencyModelParser works toward incorrectly spelled property name.
 251       - `APPC-1331 <https://jira.onap.org/browse/APPC-1331>`_ - Test cases in appc-common cause intermittent failures.
 252       - `APPC-1367 <https://jira.onap.org/browse/APPC-1367>`_ - APPC returns UnknownHostException during Netconf operations.
 253       - `APPC-1435 <https://jira.onap.org/browse/APPC-1435>`_ - APPC Ansible Server keeps crashing.
 254       - `APPC-1441 <https://jira.onap.org/browse/APPC-1441>`_ - incompatible cherrypy version in ansible server container.
 255       - `APPC-1463 <https://jira.onap.org/browse/APPC-1463>`_ - Error in ControllerImpl class.
 256       - `APPC-1472 <https://jira.onap.org/browse/APPC-1472>`_ - Not possible to call ansible healthcheck from SO VnfConfigUpdate workflow.
 257       - `APPC-1479 <https://jira.onap.org/browse/APPC-1479>`_ - Logic error in ScheduledPublishingPolicyImpl.
 258       - `APPC-1480 <https://jira.onap.org/browse/APPC-1480>`_ - MetricRegistryImpl code has problems with casting.
 259       - `APPC-1489 <https://jira.onap.org/browse/APPC-1489>`_ - SO VnfConfigUpdate workflow fails with timeout error.
 260       - `APPC-1528 <https://jira.onap.org/browse/APPC-1528>`_ - APPC DB table creation failed.
 261       - `APPC-1537 <https://jira.onap.org/browse/APPC-1537>`_ - UNIQUE KEY is too long in DEVICE_AUTHENTICATION.
 262       - `APPC-1542 <https://jira.onap.org/browse/APPC-1542>`_ - ExecuteNodeActionImpl is not instatiate.
 263       - `APPC-1545 <https://jira.onap.org/browse/APPC-1545>`_ - Problem with Ansible handling in EncryptionToolDGWrapper.
 264       - `APPC-1548 <https://jira.onap.org/browse/APPC-1548>`_ - "MariaDB 10.2.4 adds ""ROWS"" as an SQL keyword".
 265       - `APPC-1574 <https://jira.onap.org/browse/APPC-1574>`_ - FileParameters not supported for Ansible LCM action.
 266       - `APPC-1576 <https://jira.onap.org/browse/APPC-1576>`_ - FileParameters content is wrongly processed.
 267       - `APPC-1577 <https://jira.onap.org/browse/APPC-1577>`_ - Ansible Server  playbook execution does not work.
 268       - `APPC-1583 <https://jira.onap.org/browse/APPC-1583>`_ - ansible user privileges problem.
 269       - `APPC-1584 <https://jira.onap.org/browse/APPC-1584>`_ - Incorrect Package name in Audit Directed Graph.
 270       - `APPC-1589 <https://jira.onap.org/browse/APPC-1589>`_ - Cvaas directory is not mounted in docker image.
 271       - `APPC-1593 <https://jira.onap.org/browse/APPC-1593>`_ - CDT doesn't push info to DB.
 272       - `APPC-1600 <https://jira.onap.org/browse/APPC-1600>`_ - "APPC DB doesn't have any artifact for ""artifact-type""=""APPC-CONFIG""".
 273       - `APPC-1604 <https://jira.onap.org/browse/APPC-1604>`_ - APPC Not Picking up Mesasges from Dmaap.
 274       - `APPC-1610 <https://jira.onap.org/browse/APPC-1610>`_ - Config vFW Netconf URI should be stream-count:stream-count intead of sample-plugin:pg-streams.
 275       - `APPC-1611 <https://jira.onap.org/browse/APPC-1611>`_ - VNF_DG_MAPPING and PROCESS_FLOW_REFERENCE tables are empty.
 276       - `APPC-1612 <https://jira.onap.org/browse/APPC-1612>`_ - InventoryNames parameter support for APPC Ansible LCM.
 277
 278 **Known Issues**
 279
 280       - `APPC-1613 <https://jira.onap.org/browse/APPC-1613>`_ - Exception for LCM request with parameter read from A&AI.
 281          - to work around this is to switch to the  fixed parameter in the template or passed as configuration parameter in stead of using A&AI that APPC received the value from the request.
 282
 283 **Security Notes**
 284
 285 *Fixed Security Issues*
 286
 287       - `OJSI-146 <https://jira.onap.org/browse/OJSI-146>`_ - In default deployment APPC (appc-cdt) exposes HTTP port 30289 outside of cluster.
 288       - `OJSI-104 <https://jira.onap.org/browse/OJSI-104>`_ - In default deployment APPC (appc) exposes HTTP port 30211 outside of cluster.
 289
 290 *Known Security Issues*
 291
 292       - CVE-2019-12316 `OJSI-25 <https://jira.onap.org/browse/OJSI-25>`_ - SQL Injection in APPC
 293       - `OJSI-29 <https://jira.onap.org/browse/OJSI-29>`_ - Unsecured Swagger UI Interface in AAPC
 294       - CVE-2019-12124 `OJSI-63 <https://jira.onap.org/browse/OJSI-63>`_ - APPC exposes Jolokia Interface which allows to read and overwrite any arbitrary file
 295       - `OJSI-95 <https://jira.onap.org/browse/OJSI-95>`_ - appc-cdt allows to impersonate any user by setting USER_ID
 296       - `OJSI-112 <https://jira.onap.org/browse/OJSI-112>`_ - In default deployment APPC (appc-dgbuilder) exposes HTTP port 30228 outside of cluster.
 297       - `OJSI-113 <https://jira.onap.org/browse/OJSI-113>`_ - In default deployment APPC (appc) exposes HTTP port 30230 outside of cluster.
 298       - `OJSI-185 <https://jira.onap.org/browse/OJSI-185>`_ - appc exposes ssh service on port 30231
 299
 300 *Known Vulnerabilities in Used Modules*
 301
 302 Quick Links:
 303
 304         - `APPC project page <https://wiki.onap.org/display/DW/Application+Controller+Project>`_
 305
 306         - `Passing Level Badge information for APPC <https://bestpractices.coreinfrastructure.org/en/projects/1579>`_
 307
 308         - `Silver Level Badge information for APPC <https://bestpractices.coreinfrastructure.org/en/projects/1579?criteria_level=1>`_
 309
 310         - `Project Vulnerability Review Table for APPC <https://wiki.onap.org/pages/viewpage.action?pageId=51282466>`_
 311
 312 **Other**
 313
 314 - Limitations, Constraints and other worthy notes:
 315
 316         - OpenStack Restriction:
 317
 318                 - Currently APPC only supports OpenStack.
 319
 320                 - Admin level access for Tenant level operations.
 321
 322                 - OpenStack Hypervisorcheck is turned off by default.
 323
 324
 325 Version: 1.4.4
 326 --------------
 327
 328 :Release Date: 2019-1-31
 329
 330
 331 **Bug Fixes**
 332
 333 The Casablanca maintenance release fixed the following bugs:
 334
 335         - `APPC-1247 <https://jira.onap.org/browse/APPC-1247>`_ - java.lang.NoClassDefFoundError when publishing DMAAP message
 336
 337         - `CCSDK-741 <https://jira.onap.org/browse/CCSDK-741>`_ - Removed Work-around required for vCPE use case to correct the error described in CCSDK ticket.
 338
 339 Special Note for `APPC-1367 <https://jira.onap.org/browse/APPC-1367>`_ - APPC fails healthcheck with 404 error:
 340
 341        During testing, we found there is a timing issue. When using OOM to deploy to k8s environment the clustered MariaDB database is not accessible at the time when the APPC pod is trying to insert the DG into MariaDb. This would cause the healthcheck issue. The workaround to solve this issue is redeploying the APPC pod.
 342
 343 Version: 1.4.3
 344 --------------
 345
 346 :Release Date: 2018-11-30
 347
 348
 349 **New Features**
 350
 351 The Casablanca release added the following functionality:
 352
 353          - Upgraded OpenDaylight (ODL) version to Oxygen
 354
 355          - Upgraded to Karaf 4.1.5
 356
 357          - Migrated DB from mysql to maria db with galeira, tested on k8s clustering platform
 358
 359          - Added an ansible docker container, tested for DistributeTraffic LCM action
 360
 361          - Added support for the following LCM actions (a desciption of all of the above LCM actions can be found in the APPC LCM API Guide on readthedoc):
 362
 363                 - To support in-place software upgrade:
 364
 365                   - DistributeTraffic
 366
 367                 - To support storage management in OpenStack
 368
 369                   - Reboot with hard and soft option
 370
 371          - Additional contributions as part of Casablanca include:
 372
 373                 - Support for Platform Maturity requirements, including:
 374
 375                    - Increased security
 376
 377                           - Enabled bath feature from AAF, CDT GUI and APIDOC can be used when AAF enbled  (see `APPC-1237 <https://jira.onap.org/browse/APPC-1237>`_ for additional details)
 378                           - Addressed critical alerts reported via Nexus IQ to the extent possible (see `APPC-770 <https://jira.onap.org/browse/APPC-770>`_ and wiki: https://wiki.onap.org/pages/viewpage.action?pageId=40927352 )
 379
 380                    - Stability
 381
 382                           - Executed 72 hour stability test on both Heat and OOM deployed environments using JMeter to drive a steady set of transactions over the 72 hour period (see the following wiki page for more details: https://wiki.onap.org/display/DW/APPC+72+Hour+Stability+Testing+Casablanca )
 383
 384                    - Resiliency
 385
 386                           - Support for OOM deployment, which enables resiliency via use of Kubernetes (see https://wiki.onap.org/display/DW/APPC+Resiliency for additional details)
 387
 388
 389 **Bug Fixes**
 390
 391         - `APPC-1009 <https://jira.onap.org/browse/APPC-1009>`_ - An incorrect regex in appc-provider-model was causing intermittent unit test failures. This is now fixed.
 392
 393         - `APPC-1021 <https://jira.onap.org/browse/APPC-1021>`_ - An unnecessary pseudoterminal allocation for SSH connection was causing problems when trying to connect to a ConfD NETCONF Server.
 394
 395         - `APPC-1107 <https://jira.onap.org/browse/APPC-1107>`_ - Database problems were causing artifacts created in CDT to not save to APPC. These have been fixed.
 396
 397         - `APPC-1111 <https://jira.onap.org/browse/APPC-1111>`_ - TestDmaapConsumerImpl.testFetch method was taking 130+ seconds to run test. Build time is shorter now.
 398
 399         - `APPC-1112 <https://jira.onap.org/browse/APPC-1112>`_ - Several unit tests in TimeTest.java had intermittent failures.
 400
 401         - `APPC-1157 <https://jira.onap.org/browse/APPC-1157>`_ - Mockito package was removed from the APPC client jar. It was causing conflicts with other applications using APPC client library.
 402
 403         - `APPC-1184 <https://jira.onap.org/browse/APPC-1184>`_ - The APPC LCM API documentation was outdated and did not reflect the correct endpoints.
 404
 405         - `APPC-1186 <https://jira.onap.org/browse/APPC-1186>`_ - VNF-Level OpenStack actions such as Restart were failing if the optional identity-url was omitted from the payload of the request.
 406
 407         - `APPC-1188 <https://jira.onap.org/browse/APPC-1188>`_ - Exception was occurring if force flag was set to false in a request from policy.
 408
 409         - `APPC-1192 <https://jira.onap.org/browse/APPC-1192>`_ - CDT was not updating the DEVICE_INTERFACE_PROTOCOL table, so APPC was unable to get the protocol during lcm actions.
 410
 411         - `APPC-1205 <https://jira.onap.org/browse/APPC-1205>`_ - Artifacts manually entered into CDT were not saving correctly, while artifacts created by uploading a template were.
 412
 413         - `APPC-1207 <https://jira.onap.org/browse/APPC-1207>`_ - Logging constants were missing in several features, causing incorrect logging messages.
 414
 415         - `APPC-1218 <https://jira.onap.org/browse/APPC-1218>`_ - Aai connection had certificate errors and path build exceptions.
 416
 417         - `APPC-1224 <https://jira.onap.org/browse/APPC-1224>`_ - SubRequestID was not being relayed back to Policy in DMaaP Response messages.
 418
 419         - `APPC-1226 <https://jira.onap.org/browse/APPC-1226>`_ - Mock code to mimic backend execution for Reboot was causing problems and has been removed.
 420
 421         - `APPC-1227 <https://jira.onap.org/browse/APPC-1227>`_ - APPC was not able to read VNF templates created with CDT.
 422
 423         - `APPC-1230 <https://jira.onap.org/browse/APPC-1230>`_ - APPC was using the GenericRestart DG instead of DGOrchestrator.
 424
 425         - `APPC-1231 <https://jira.onap.org/browse/APPC-1231>`_ - APPC was not updating the TRANSACTIONS table correctly when an operation completed.
 426
 427         - `APPC-1233 <https://jira.onap.org/browse/APPC-1233>`_ - DGOrchestrator was incorrectly being given an output.payload parameter instead of output-payload.
 428
 429         - `APPC-1234 <https://jira.onap.org/browse/APPC-1234>`_ - AppC Open Day Light login was responding 401 unauthorized when AAF was enabled.
 430
 431         - `APPC-1237 <https://jira.onap.org/browse/APPC-1237>`_ - APPC was not properly url-encoding AAF credentials.
 432
 433         - `APPC-1243 <https://jira.onap.org/browse/APPC-1243>`_ - Container was not preserving mysql data after kubectl edit statefulset.
 434
 435         - `APPC-1244 <https://jira.onap.org/browse/APPC-1244>`_ - Ansible Server would never start in oom.
 436
 437 **Known Issues**
 438
 439         - `APPC-1247 <https://jira.onap.org/browse/APPC-1247>`_ - java.lang.NoClassDefFoundError when publishing DMAAP message
 440             - This issue is relevant during the vCPE use case.
 441             - Due to this defect, the VM will perform four start/stop sequences, instead of the normal one.
 442             - After the four start/stop sequences, the VM will be left in the correct state that it should be in.
 443
 444         - Work-around required for vCPE use case to correct the error described in: `CCSDK-741 <https://jira.onap.org/browse/CCSDK-741>`_
 445             - CCSDK aai adapter doesn't recognize generic-vnf attribute in the response, as it is not defined by aai_schema XSD
 446             - To work around this, several steps must be performed as described here:
 447
 448                 1. Add a restapi template file into the appc docker containers
 449                     a. Enter the appc docker container (docker exec... or kubectl exec...)
 450                     b. Create a directory: /opt/onap/appc/templates
 451                     c. Download this file `aai-named-query.json <https://gerrit.onap.org/r/gitweb?p=appc/deployment.git;a=blob_plain;f=vcpe-workaround-files/aai-named-query.json;hb=refs/heads/casablanca>`_ and place it in that directory
 452                 2. Replace the generic restart DG with a new one
 453                     a. Download the `APPC_Generic_Restart.xml <https://gerrit.onap.org/r/gitweb?p=appc/deployment.git;a=blob_plain;f=vcpe-workaround-files/APPC_method_Generic_Restart_3.0.0.xml;hb=refs/heads/casablanca>`_
 454                     b. Edit the file. Find the parameter definition lines for restapiUrl, restapiUser, restapiPassword (lines 52-54) and replace these with the correct values for your aai server.
 455                     c. Copy this file into the appc docker containers to the /opt/onap/appc/svclogic/graphs directory (you will be replacing the old version of the file with this copy)
 456                 3. Load the new DG file
 457                     a. In the appc docker containers, enter the "/opt/appc/svclogic/bin directory
 458                     b. Run install-converted-dgs.sh
 459
 460 Quick Links:
 461
 462         - `APPC project page <https://wiki.onap.org/display/DW/Application+Controller+Project>`_
 463
 464         - `Passing Badge information for APPC <https://bestpractices.coreinfrastructure.org/en/projects/1579>`_
 465
 466         - `Project Vulnerability Review Table for APPC <https://wiki.onap.org/pages/viewpage.action?pageId=40927352>`_
 467
 468 **Other**
 469
 470 - Limitations, Constraints and other worthy notes:
 471
 472         - OpenStack Restriction:
 473
 474                 - Currently APPC only supports OpenStack.
 475
 476                 - Admin level access for Tenant level operations.
 477
 478                 - OpenStack Hypervisorcheck is turned off by default.
 479
 480
 481         - Integration with MultiCloud is supported for Standalone Restart (i.e., not via DGOrchestrator). For any other action, such as Stop, Start, etc.. via MultiCloud requires the MultiCloud identity URL to be either passed in the payload or defined in appc.properties.
 482
 483
 484
 485 Version: 1.3.0
 486 --------------
 487
 488
 489 :Release Date: 2018-06-07
 490
 491
 492 **New Features**
 493
 494 The Beijing release added the following functionality:
 495
 496          - Added support for the following LCM actions (a desciption of all of the above LCM actions can be found in the APPC LCM API Guide on readthedoc):
 497
 498                 - To support in-place software upgrade:
 499
 500                   - QuiesceTraffic
 501                   - ResumeTraffic
 502                   - UpgradeSoftware
 503                   - UpgradePreCheck
 504                   - UpgradePostCheck
 505                   - UpgradeBackup
 506                   - UpgradeBackout
 507
 508                 - To support storage management in OpenStack
 509
 510                   - AttachVolume
 511                   - DetachVolume
 512
 513                 - To support Manual Scale Out use case
 514
 515                   - ConfigScaleOut (more details can be found in teh APPC Epic: `APPC-431 <https://jira.onap.org/browse/APPC-431>`_ )
 516
 517                 - To support general operations
 518
 519                   - ActionStatus
 520
 521
 522          - Contributed the APPC Controller Design Tool (CDT), which enables self-serve capabilities by allowing users to model their VNF/VNFC for consumption by APPC to use in the execution of requests to perform life cycle management activities.
 523
 524                 - More details on the APPC CDT can be found in the APPC CDT User Guide in readthedocs.
 525                 - Additional information on how the APPC CDT tool was used to model the vLB and build teh artifacts needed by APPC to execute teh ConfigScaleOut action can be found at the following wiki pages: https://wiki.onap.org/pages/viewpage.action?pageId=33065185
 526
 527          - Additional contributions as part of Beijing include:
 528
 529                 - Support for Platform Maturity requirements, including:
 530
 531                    - Increased security
 532
 533                           - Added security to ODL web-based API access via AAF (see `APPC-404 <https://jira.onap.org/browse/APPC-404>`_ for additional details)
 534                           - Addressed critical alerts reported via Nexus IQ to the extent possible (see `APPC-656 <https://jira.onap.org/browse/APPC-656>`_ )
 535
 536                    - Stability
 537
 538                           - Executed 72 hour stability test on both Heat and OOM deployed environments using JMeter to drive a steady set of transactions over the 72 hour period (see the following wiki page for more details: https://wiki.onap.org/display/DW/ONAP+APPC+72+Hour+Stability+Test+Results )
 539
 540                    - Resiliency
 541
 542                           - Support for OOM deployment, which enables resiliency via use of Kubernetes (see `APPC-414 <https://jira.onap.org/browse/APPC-414>`_ for additional details)
 543
 544                 - Upgraded OpenDaylight (ODL) version to Nitrogen
 545
 546
 547
 548
 549 **Bug Fixes**
 550
 551 The following defects that were documented as known issues in Amsterdam have been fixed in Beijing release:
 552
 553         - `APPC-316 <https://jira.onap.org/browse/APPC-316>`_ - Null payload issue for Stop Application
 554
 555         - `APPC-315 <https://jira.onap.org/browse/APPC-315>`_ - appc-request-handler is giving error java.lang.NoClassDefFoundError
 556
 557         - `APPC-312 <https://jira.onap.org/browse/APPC-312>`_ - APPC request is going to wrong request handler and rejecting request
 558
 559         - `APPC-311 <https://jira.onap.org/browse/APPC-311>`_ - The APPC LCM Provider Healthcheck
 560
 561         - `APPC-309 <https://jira.onap.org/browse/APPC-309>`_ - APPC LCM Provider URL missing in appc.properties.
 562
 563         - `APPC-307 <https://jira.onap.org/browse/APPC-307>`_ - Embed jackson-annotations dependency in appc-dg-common during run-time
 564
 565         - `APPC-276 <https://jira.onap.org/browse/APPC-276>`_ - Some Junit are breaking convention causing excessively long build
 566
 567         - `APPC-248 <https://jira.onap.org/browse/APPC-248>`_ - There is an compatibility issue between PowerMock and Jacoco which causes Sonar coverage not to be captured. Fix is to move to Mockito.
 568
 569
 570 **Known Issues**
 571
 572 The following issues remain open at the end of Beijing release. Please refer to Jira for further details and workaround, if available.
 573
 574         - `APPC-987 <https://jira.onap.org/browse/APPC-987>`_ - APPC Investigate TRANSACTION Table Aging. See **Other** section for further information
 575
 576         - `APPC-977 <https://jira.onap.org/browse/APPC-977>`_ - Procedures needed for enabling AAF support in OOM. See **Other** section for further information
 577
 578         - `APPC-973 <https://jira.onap.org/browse/APPC-973>`_ - Fix delimiter string for xml-download CDT action
 579
 580         - `APPC-940 <https://jira.onap.org/browse/APPC-940>`_ - APPC CDT Tool is not updating appc_southbound.properties with the URL supplied for REST
 581
 582         - `APPC-929 <https://jira.onap.org/browse/APPC-929>`_ - LCM API - ConfigScaleOut- Payload parameter to be manadatory set to "true"
 583
 584         - `APPC-912 <https://jira.onap.org/browse/APPC-912>`_ - MalformedChunkCodingException in MDSALStoreImpl.getNodeName
 585
 586         - `APPC-892 <https://jira.onap.org/browse/APPC-892>`_ - Cntl+4 to highlight and replace feature-Textbox is accepting space  and able to submit without giving any value
 587
 588         - `APPC-869 <https://jira.onap.org/browse/APPC-869>`_ - VM Snapshot error occurs during image validation.
 589
 590         - `APPC-814 <https://jira.onap.org/browse/APPC-814>`_ - Update openecomp-tosca-datatype namespace
 591
 592         - `APPC-340 <https://jira.onap.org/browse/APPC-340>`_ - APPC rejecting request even for decimal of millisecond timestamp difference
 593
 594         - `APPC-154 <https://jira.onap.org/browse/APPC-154>`_ - Logging issue - Request REST API of APPC has RequestID (MDC) in Body or Payload section instead of Header.
 595
 596
 597 **Security Notes**
 598
 599 APPC 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 APPC open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25438971>`_.
 600
 601 Additionally, communication over DMaaP currently does not use secure topics in this release. This has dependency on DMaaP to enable.
 602
 603
 604 Quick Links:
 605         - `APPC project page <https://wiki.onap.org/display/DW/Application+Controller+Project>`_
 606
 607         - `Passing Badge information for APPC <https://bestpractices.coreinfrastructure.org/en/projects/1579>`_
 608
 609         - `Project Vulnerability Review Table for APPC <https://wiki.onap.org/pages/viewpage.action?pageId=25438971>`_
 610
 611 **Other**
 612
 613 - Limitations, Constraints and other worthy notes
 614
 615         - An issue was discovered with usage of AAF in an OOM deployed environment after the Beijing release was created. The issue was twofold (tracked under `APPC-977 <https://jira.onap.org/browse/APPC-977>`_):
 616
 617              - Needed APPC configuration files were missing in Beijing OOM , and
 618              - AAF updated their certificates to require 2way certs, which requires APPC updates
 619
 620           Additionally, in a Heat deployed environment, a manual workaround will be required to authorize with AAF if they are using 2way certificates.  For instruction on workaround steps needed depending on type of deployment, please refer to the following wiki: https://wiki.onap.org/display/DW/AAF+Integration+with+APPC.
 621
 622         - During the testing of the vCPE/vMUX closed loop scenarios in an OOM deployed environment, an issue was encountered where transactions were not being deleted from the TRANSACTION table and was blocking other Restart request from completing successfully (tracked under `APPC-987 <https://jira.onap.org/browse/APPC-987>`_). A workaround is available and documented in the Jira ticket.
 623
 624         - It is impossible for us to test all aspect of the application. Scope of testing done in Beijing is captured on the following wiki:   https://wiki.onap.org/display/DW/APPC+Beijing+Testing+Scope+and+Status
 625
 626         - Currently APPC only supports OpenStack
 627
 628         - OpenStack Hypervisorcheck is turned off by default. If you want to invoke this functionality via the appc.properties, you need to enable it and ensure you have Admin level access to OpenStack.
 629
 630         - Integration with MultiCloud is supported for Standalone Restart (i.e., not via DGOrchestrator). For any other action, such as Stop, Start, etc.. via MultiCloud requires the MultiCloud identity URL to be either passed in the payload or defined in appc.properties.
 631
 632         - APPC needs Admin level access for Tenant level operations.
 633
 634         - Currently, the "ModifyConfig" API and the implementation in the Master Directed Graph is only designed to work with the vFW Closed-Loop Demo.
 635
 636
 637 Version: 1.2.0
 638 --------------
 639
 640 :Release Date: 2017-11-16
 641
 642
 643 **New Features**
 644
 645 The Amsterdam release continued evolving the design driven architecture of and functionality for APPC.
 646 APPC aims to be completely agnostic and make no assumption about the network.
 647
 648 The main goal of the Amsterdam release was to:
 649  - Support the vCPE use case as part of the closed loop action to perform a Restart on the vGMUX
 650  - Demonstrate integration with MultiCloud as a proxy to OpenStack
 651  - Continue supporting the vFW closed loop use case as part of regression from the seed contribution.
 652
 653 Other key features added in this release include:
 654  - Support for Ansible
 655    - The Ansible Extension for APP-C allows management of VNFs that support Ansible. Ansible is a an open-source VNF management framework that provides an almost cli like set of tools in a structured form. APPC supports Ansible through the following three additions: An Ansible server interface, Ansible Adapter, and Ansible Directed Graph.
 656  - Support for Chef
 657    - The Chef Extension for APPC allows management of VNFs that support Chef through the following two additions: a Chef Adapter and Chef Directed Graph.
 658  - LifeCycle Management (LCM) APIs via standalone DGs or via the DGOrchestrator architecture to trigger actions on VMs, VNFs, or VNFCs
 659  - OAM APIs to manage the APPC application itself
 660  - Upgrade of OpenDaylight to Carbon version
 661
 662
 663
 664 **Bug Fixes**
 665
 666         - This is technically the first release of APPC, previous release was the seed code contribution. As such, the defects fixed in this release were raised during the course of the release. Anything not closed is captured below under Known Issues. If you want to review the defects fixed in the Amsterdam release, refer to `Jira <https://jira.onap.org/issues/?filter=10570&jql=project%20%3D%20APPC%20AND%20issuetype%20%3D%20Bug%20AND%20status%20%3D%20Closed%20AND%20fixVersion%20%3D%20%22Amsterdam%20Release%22>`_.
 667
 668         - Please also refer to the notes below. Given the timeframe and resource limitations, not all functions of the release could be validated. Items that were validated are documented on the wiki at the link provide below. If you find issues in the course of your work with APPC, please open a defect in the Application Controller project of Jira (jira.onpa.org)
 669
 670 **Known Issues**
 671
 672         - `APPC-312 <https://jira.onap.org/browse/APPC-312>`_ - APPC request is going to wrong request handler and rejecting request. Configure request failing with following error: ``REJECTED Action Configure is not supported on VM level``.
 673
 674         - `APPC-311 <https://jira.onap.org/browse/APPC-311>`_ - The APPC LCM Provider Healthcheck, which does a healthceck on a VNF, is failing. No known workaround at this time.
 675
 676         - `APPC-309 <https://jira.onap.org/browse/APPC-309>`_ - The property: ``appc.LCM.provider.url=http://127.0.0.1:8181/restconf/operations/appc-provider-lcm`` is missing from appc.properties in the appc deployment.  The property can be manually added as a workaround, then bounce the appc container.
 677
 678         - `APPC-307 <https://jira.onap.org/browse/APPC-307>`_ - Missing jackson-annotations dependency in appc-dg-common - This issue results in Rebuild operation via the APPC Provider not to work. Use instead Rebuild via the APPC LCM Provider using DGOrchestrator.
 679
 680         - `APPC-276 <https://jira.onap.org/browse/APPC-276>`_ - A number of junit testcases need to be reworked because they are causing APPC builds to take much  longer to complete. This issue does not cause the build to fail, just take longer. You can comment out these junit in your local build if this is a problem.
 681
 682         - `APPC-248 <https://jira.onap.org/browse/APPC-248>`_ - There is an compatibility issue between PowerMock and Jacoco which causes Sonar coverage not to be captured. There is no functional impact on APPC.
 683
 684         - `APPC-154 <https://jira.onap.org/browse/APPC-154>`_ - Logging issue - Request REST API of APPC has RequestID (MDC) in Body or Payload section instead of Header.
 685
 686
 687 **Security Issues**
 688         - Communication over DMaaP currently does not use secure topics in this release.
 689         - AAF is deactivated by default in this release and was not validated or committed as part of the Amsterdam Release.
 690
 691
 692 **Other**
 693
 694 - Limitations, Constraints and other worthy notes
 695
 696   - LCM Healthcheck and Configure actions do not work.
 697   - The APPC actions validated in this release are captured here: https://wiki.onap.org/display/DW/APPC+Testing+Scope+and+Status
 698   - Currently APPC only supports OpenStack
 699   - OpenStack Hypervisorcheck is turned off by default. If you want to invoke this functionality via the appc.properties, you need to enable it and ensure you have Admin level access to OpenStack.
 700   - Integration with MultiCloud is supported for Standalone Restart (i.e., not via DGOrchestrator). For any other action, such as Stop, Start, etc.. via MultiCloud requires the MultiCloud identity URL to be either passed in the payload or defined in appc.properties.
 701   - APPC needs Admin level access for Tenant level operations.
 702   - Currently, if DGs are modified in appc.git repo, they must be manually moved to the appc/deployment repo.
 703   - Currently, the "ModifyConfig" API and the implementation in the Master Directed Graph is only designed to work with the vFW Closed-Loop Demo.
 704
 705
 706 ===========
 707
 708 End of Release Notes