2019-01-03 AAI Developers Meeting
Attachments (including meeting recording)
Chat Server
private group aai-dev on Rocketchat server: http://onap-integration.eastus.cloudapp.azure.com:3000/group/aai-dev
Agenda Items
START RECORDING
Title | Responsible | Status | Last discussed | Notes | |
|---|---|---|---|---|---|
| 1 | Dublin use-cases | @Chandra Cinthala | In Progress | 3rd Jan 2019 | BBS Broadband Service Use Case (Dublin) Change Management Dublin Extensions Edge Automation Functional Requirements for Dublin OpenSource Access Manager (OSAM) Use Case K8S based Cloud Region Support @Chandra Cinthala will go over all these use cases and will write a 1 page report per use-case where he lays out the impact and needed high-level description of changes in order to support the use-cases in A&AI. He will send this reports to @James Forsyth so he can plan accordingly. The 1 pagers should be discussed with the modelling comitee before sending them to @James Forsyth . @Chandra Cinthala should start here https://lf-onap.atlassian.net/wiki/display/DW/Joining+the+ONAP+Technical+Community when integrating to the ONAP community and the mailing list https://lists.onap.org/g/main. The deadline for @Chandra Cinthala to send the reports to @James Forsyth is Jan 15, 2019 The Dublin use-cases for review are Release 4 (Dublin) Use Cases and functional requirements On AAI weekly call on Wednesday @Chandra Cinthala will report on his progress in analyzing the use-cases. |
| 2 | CCVPN Extension Dublin | @Davide Cherubini @Former user (Deleted) @Emmanuel Sarris Christopher Sheng Tony Noori | In Progress | 20th Dec 2018 | During the VF2F we have presented the CCVPN Use Case extension for Dublin Release. In particular, we have defined the E-LAN Service (EP-LAN. EVP-LAN) sub-Use Case. More details can be found at this page (the presentation given to the Use Case SubCommittee and during the VF2F can also be found in that page). We have also created 2 additional pages where we describe the: In the former page, we have identified Option 2 (for Service Creation) and Option A (for Service Modification) as the “ideal” implementation. The Impacts in the latter page are based on such an assumption. We would be grateful if you could help us with the assessment for A&AI and if you could confirm the project commitment to CCVPN. 14th Dec: Regarding the Options and Impact assessment linked above:
As far as I know, the ServiceComposite pattern hasn't even exited the Modelling team's discussions for R3 or R4 workshops @Hui Deng : This would seem like a stretch goal given the impacts on all the downstream clients of AAI, if it would require reworking any existing schema elements. However, if you are looking for a zero-impact method of implementation, the EdgeRules already contain service-instance-to-service-instance relationship with label "org.onap.relationships.inventory.ComposedOf", so AAI can do the composite data with this relationship. @James Forsythwill send a reminder e-mail to Tony and Christopher to engage them on this task, the plan is to discuss this issues and modeling in general in the first 2 weeks in January Update 3rd January 2019 from CFL comment:
|
| 3 | Multi-CPU architecture images | @Paul-Ionut Vaduva @Adolfo Perez-Duran @Adolfo Perez-Duran (Deactivated) | In Progress | 3rd Jan 2019 | I am writting you because of your comment here: We have the following issue: https://jira.onap.org/browse/INT-759 Briefly put, do you think you can help us with the Dockerfile you use to build aai-common docker image, for Casablanca and maybe master if it differs ? Best Regards, Paul 14th Dec: See also 20th Dec: Clarified that the aaionap/aai-common docker image is not the same as the aai/aai-common gerrit repository, despite the shared name. @Venkata Harish Kajur will commit the aai-common docker image Dockerfile to ?somewhere?, we need to inspect it a figure out how to have a general base image. Afterwards we need to provide the information to Paul Ionut Vaduva + Adolfo. What repository to use for AAI: https://lf-onap.atlassian.net/browse/AAI-2050 @Keong Lim raised https://lf-onap.atlassian.net/browse/TSC-80 List of core project to change is https://lf-onap.atlassian.net/browse/AAI-2025 |
| 4 | HAproxy in OOM | @Former user (Deleted) | Done | 1st Nov 2018 | Why is the pod for HAproxy not named (hard to figure out that there is a proxy), unsure how it is logging and where @James Forsyth creates JIRA tasks to 1. to have the pod named 2. add logging to the proxy https://lf-onap.atlassian.net/browse/AAI-1807https://lf-onap.atlassian.net/browse/AAI-1810 |
| 5 | AAI-DMaaP event problems? | @Keong Lim | Open | Just had a look at this DMaaP bug https://lf-onap.atlassian.net/browse/DMAAP-896 which shows up two AAI-related exceptions when getting events: INFO org.onap.dmaap.dmf.mr.service.impl.EventsServiceImpl - KafkaConsumer is not safe for multi-threaded accesson AAI-EVENT datarouter ****** datarouter from Remote10.42.133.135
INFO org.onap.dmaap.dmf.mr.service.impl.EventsServiceImpl - [AAI-EVENT/datarouter/datarouter]
INFO org.onap.dmaap.dmf.mr.service.impl.EventsServiceImpl - KafkaConsumer is not safe for multi-threaded accesson champRawEvents spike ****** spike from Remote10.42.121.41
INFO org.onap.dmaap.dmf.mr.service.impl.EventsServiceImpl - [champRawEvents/spike/spike]Anyone else seen or reported similar problems in AAI? | |
| 6 | aai-cassandra performance issues | @Keong Lim | Open | @Michael O'Brien has documented performance issues in aai-cassandra:
Is there something that should be tweaked in AAI config? Or documentation on the recommended setup to run the VM? I'll come to the next AAI meet (conflicts with pomba meet) - | |
| 7 | get notified of AAI Casandra issues automatically | @Keong Lim | Open | @Mike Elliott wrote in OOM Meeting Notes - 2018-12-5
Keep an eye out for new issues! | |
| 8 | Purpose of fields in AAI | @Keong Lim | Open | @Dénes Németh wrote in https://lf-onap.atlassian.net/browse/AAI-1104:
Questions: 1. Is AAI intended to strictly prescribe how the fields are used and what contents are in the values? Even if (1) is true, AAI is not really in any position to enforce how clients use the data, so really (2) is always true and we need to consult the original producers of the data and the ultimate consumers of the data to document their intended meanings. How do we push to have documentation on the purpose and meaning of the fields in AAI? Where does all this documentation go? Should the documentation be backed up by validation code? See also discussion about AAI in 2018-11-28 ExtAPI Meeting notes 29th Nov: Started on new wiki page AAI Schema Producer-Consumer Pairings | |
| 9 | Postel's Law / Robustness Principle for AAI data inputs | @Keong Lim | Open | 6th Dec 2018 | While helping UUI team to debug a family of related issues such as https://lf-onap.atlassian.net/browse/AAI-1915, found that their JSON request bodies had inserted extra lines that were not acceptable to AAI, e.g. Not Accepted Input{
ext-aai-network: {
"aai-id": "VDF",
"schema-version": "version-1",
"resource-version": "1542082337501"
}
}vs Expected Input Format{
"aai-id": "VDF",
"schema-version": "version-1",
"resource-version": "1542082337501"
}Initially, I thought this could be due to XML-to-JSON translation error, but it could also have been a copy-paste from the output of a GET, e.g. > GET /aai/v14/network/ext-aai-networks HTTP/1.1
{
"ext-aai-network": [
{
"aai-id": "createAndDelete",
"schema-version": "version-1",
"resource-version": "1542247826990"
},
{
"aai-id": "aaiId-2",
"schema-version": "version-2",
"resource-version": "1542029867153"
}
]
}In the spirit of Postel's Law ("be liberal in what you accept"), could/should AAI accept both variations of the input data above? There could be additional validation that the element name inside the request body matches the element name in the URL of the API (similar validation is already performed for the key ID value). It would also allow for simple methods of data transfer/migration, where AAI output is directly accepted as AAI input. 7th Dec: As per Jimmy's comment below, the difference between the "Not Accepted Input" and "Expected Input Format" is the behaviour controlled by "SerializationFeature.WRAP_ROOT_VALUE" as described in: |
| 10 | Copyright license header restricted to 1 company | @Former user (Deleted) | Open | In the copyright /** * ============LICENSE_START======================================================= * org.onap.aai * ================================================================================ * Copyright © 2017-2018 AT&T Intellectual Property. All rights reserved. If there is a company other than AT&T the build fails saying the license header is wrong | |
| 11 | Return codes and messages for WS | @Former user (Deleted) | Open | Is there a guide for the description of the error message and the error codes? How are new error states (message + code) added? | |
| 12 | OOM Artifacts | @Former user (Deleted) | Open | Some of our top level OOM deployment artifacts are not unique (i.e. don’t take namespace into account as all other deployables), is that intentional? | |
| 13 | AAI test data bootstrap | @Keong Lim | Open | Looking at AAI usage in OOF - HPA guide for integration testing by @Dileep Ranganathan, wondering whether there is a better way to bootstrap AAI test data?
Similarly, @Scott Seabolt and @J / @Joss Armstrong wrote for APPC Sample A&AI Data Setup for vLB/vDNS for APPC Consumption and Script to load vLB into AAI:
Similarly: Related https://lf-onap.atlassian.net/browse/AAI-1948 on the brittleness of the ReadTheDocs links to data files. One for VIM: How-To: Register a VIM/Cloud Instance to ONAP and https://lf-onap.atlassian.net/browse/AAI-1928 Potential issues:
| |
| 14 | AAI too slow for OOF/HAS | @Keong Lim | Open | Under OOF Homing and Allocation Service (HAS) section, @Dileep Ranganathan wrote about Project Specific enhancements:
See also https://lf-onap.atlassian.net/browse/OPTFRA-268 / https://lf-onap.atlassian.net/browse/OPTFRA-291 Similarly to the "AAI too slow for Holmes" item below, this introduction of extra caching of AAI data is a worrisome development and sad indictment of the performance of the system architecture. What can we do about this? Would the AAI Cacher https://lf-onap.atlassian.net/browse/AAI-1337 help to improve performance? | |
| 15 | MultiCloud usage of AAI for HPA telemetry/time-series data to OOF | @Keong Lim | Open | @Bin Yang and @Lianhao Lu (Deactivated) wrote in https://lf-onap.atlassian.net/browse/MULTICLOUD-274:
and
and
Some concerns:
| |
| 16 | Relationship between POMBA Common Model and AAI schema? | @Keong Lim | Open | Under POMBA Common Model, @Geora Barsky and @Sharon Chisholm discuss objects that seem to overlap the AAI schema:
Curious to know what is the relationship between the POMBA Common Model and the AAI schema? There seems to be an overlap in these object definitions and relationships. Is POMBA a potential client for AAI schema services? 15th Nov: As per Geora's and Sharon's comments:
and
So, POMBA needs to evolve independently of AAI, even though it has common ancestry. As we are having discussions about the AAI Schema Services with a view to future dynamic schema updates, e.g. via SDC modelling, we will need to be aware of the downstream impacts of such a change. I think this needs to be added to the use cases for AAI Schema Services (and GraphGraph?) behaviours. | |
| 17 | AAI-BBS for Dublin | @Keong Lim | Open | Started collating proposed changes in wiki AAI-BBS Proposals for Dublin Release Investigating code proposal 1:
Is it already covered by spike? If so, how to consume the events? If not, how to make AAI publish new events to DMaaP? | |
| 18 | Orchestration Scenarios for VNFs | @Keong Lim | Open | Comments on Orchestration Scenarios related to AAI: @Viswanath Kumar Skand Priya / @kspviswa said:
and @Fernando Oliveira replied:
As I understand, ESR has "esr-vnfm-list", which has an "esr-vnfm", which has "esr-system-info-list", which has "esr-system-info", which has a "relationship-list" that can contain relationships to "generic-vnf" and other AAI objects. The "generic-vnf" object also contains "self-link", "ipv4OamAddress", "ipv4OamGatewayAddress", etc, which links the AAI object back to its "source-of-truth" external-system. Is there some new data, new schema or new API that is required on top of this? @Fernando Oliveira; Apologies for my lack of knowledge, but a few comments:
@Bo Lv can comment more on the current ESR capabilities, but I believe there are only 3 kinds of systems so far: EMS, VNFM and third-party SDNC. ESR could be extended to handle VNFO as another kind of system. @Fernando Oliveira : I created JIRA stories: for various parts of the scenario. | |
| 19 | Modeling team R4 discussion, including extra AAI attributes in a model-driven way | @Keong Lim | In Progress | 15th Nov 2018 | Modelling team having Service Instance thoughts by @Chesla Wechsler, which will affect AAI schema. Also referred from comments on ONAP R4+ Service Modeling Discussion Calls
See also Modeling 2018-11-13 The service-instance already uses a "metadata" relationship, which can store an arbitrary list of key-value pairs, but perhaps AAI should extend the use of the "properties" element, which is also an arbitrary list of name-value pairs or the "extra-properties" element, which is also an arbitrary list of name-value pairs. 15th Nov: Having seen Chesla's presentation, it should be called "Model-driven schema" rather than "schemaless" behaviour, since the idea is that the changes are controlled by SDC modelling. Seems aligned to the eventual goal in AAI Schema Service Use Case Proposals and AAI Schema Service. |
| 20 | Jackson Replacement | Team @Keong Lim @Tian Lee | Done
| 1st Nov 2018 | Security subcommittee has recommended teams move away from jackson, and will be presenting alternatives and asking for an assessment from each project. Our team will need to do an analysis - this would not be trivial, especially given how many of our repos are impacted. As of now, this would be a very high LOE for the team, we need to understand what the recommendation from the SECCOM is before we can provide better details on what the LOE would be. Updated: Using Google gson vs FasterXML Jackson 10th Oct: Present to Seccom meeting 15th Oct: Present to PTL meeting 31st Oct: Debatable whether the cost of swapping Cassandra and changing code is worth the benefit of removing Jackson from the vulnerabilities list. On-Hold until @James Forsyth consults with other PTLs: PTL 2018-11-05 10th Dec: Mentioned as S3P in vF2F meeting: ONAP Project Developers Event, Dec 10 - 12, 2018, (Virtual Webinars) Conclusion: For Dublin we won't replace Jackson due to resource shortage. This point could be opened in future releases |
| 21 | AAI too slow for Holmes | @Keong Lim @CT Paterson | In Progress | 1st Nov 2018 | @Guangrong Fu mentioned AAI in Baseline Measurements based on Testing Results: |