2019-05-16 AAI Developers Meeting
- Keong Lim
- James Forsyth
Attachments (including meeting recording)
| Status | OPEN | IN PROGRESS | ON HOLD | DONE | CANCELLED |
|---|
Agenda Items
START RECORDING
| Title | Responsible | Status | Last discussed | Notes | |
|---|---|---|---|---|---|
| 1 | Unreleased docker images in helm chart | Team | OPEN | 2019-05-16 | Merge change if artifacts are released in timely fashion, need to add release notes (or documentation somewhere) on the various options in the helm charts, things like replica count for cassandra local/shared, enabling/disabling sidecar, aaf, etc. |
| 2 | Optimise ad-hoc retrieval of any resource with any of its cousin relationships | OPEN | Raised as JIRA case AAI-2437 - Getting issue details... STATUS but holding back the gerrit review until after the Dublin branch is cut so it doesn't count against release criteria. Would like to gather opinions on the implementation (see the comments in the JIRA case). The query has been tested in my dev environment but unsure if the query is done the best way.
| ||
| 3 | Dublin Branching | IN PROGRESS | 2019-05-09 | El Alto runs Jun - Sep - technical debt and S3P/deployability release Frankfurt starts in Sep As of now, master will accept feature development for Frankfurt We tag dublin at release time (early June) The Dublin branch becomes El Alto (similar to a Dublin Maintenance Release) El Alto changes will be cherry picked back to master | |
| 4 | Review El Alto proposals | AAI Epics in JIRA: Getting issues... | |||
| 5 | Cached vs realtime connection | DONE | 9th May 2019 | Have been testing with Traversal custom queries and Resources bulkadd API. It appears that the caching causes a delay of approx. 1 to 10 seconds between creating new objects in Resources API and observing them in Traversal API (seems to have 2 or 3 modes which are fairly consistent). What is the reasoning for using cached rather than realtime connection mode for some clients but not others? Cache being out-of-date would seem to be a cause of problems. There is some discrepancy in the default configs for AAI microservices:
Apparently the HTTP header "Real-Time: true" can be used to force a realtime connection. Would this refresh the Traversal cache so that all clients can immediately observe new objects? (Further testing shows the cache is not refreshed; should this be raised in a JIRA bug?) Is there some way to know how far behind a cached connection is from realtime? e.g. by observing the latest resource-version value? Would want to avoid polling the microservice. Assuming that the "Real-Time" header has not been specified, is there any part of the response that indicates whether a "Real-Time" connection was used by default or not? 9th May: AAI-2416 - Getting issue details... STATUS | |
| 6 | debugging Traversal custom query problem | DONE | 10th May 2019 | Calling Traversal custom query with curl: curl --verbose --silent --insecure --user AAI:AAI --header 'Accept: application/json' --header 'X-TransactionId: testaai' --header 'Content-Type: application/json' --header 'X-FromAppId: AAI' --header 'Real-Time: true' --upload-file data-customquery-count-vnf.json https://<IPADDR>:30233/aai/v14/query Request body for PUT is: {
"start": [
"network/generic-vnfs/generic-vnf/test-bulkadd-gvnf-4"
],
"query": "query/count-vnf-byVnfType"
}
Response returns error: {
"requestError": {
"serviceException": {
"messageId": "SVC3002",
"text": "Error writing output performing %1 on %2 (msg=%3) (ec=%4)",
"variables": [
"GET",
"v14/query",
"Internal Error:java.lang.ClassCastException: java.util.HashMap$Node cannot be cast to org.apache.tinkerpop.gremlin.structure.Vertex",
"ERR.5.4.4000"
]
}
}
}
Stored-query definition appears to be: "count-vnf-byVnfType":{
"stored-query":"builder.getVerticesByProperty('aai-node-type', 'generic-vnf').groupCount().by('vnf-type').store('x').unfold()"
}
How do I debug/fix this query? 9th May: Venkata Harish Kajur could you take a quick look at this and email me? Keong Lim This custom query seems to only support one format which is the console. The reason is the output of this query just return a list of counts grouped by vnf type. It doesn't make sense to be able to support any other format. The default format I believe is the graphson so thats why its failing. Add the query parameter format=console and it should fix this issue. We should probably update the documentation to say that this custom query will only be working with format=console 10th May: added to AAI-2408 - Getting issue details... STATUS . Also raised AAI-2417 - Getting issue details... STATUS | |
| 7 | GraphGraph demo | Former user (Deleted) | IN PROGRESS | 2nd May 2019 | A 5-10 minute demo of GraphGraph AAI-531 - Getting issue details... STATUS . Feedback needed! |
| 8 | AAI Modeling Multi-part key for schema elements | IN PROGRESS | 25th Apr 2019 | From https://lists.onap.org/g/onap-discuss/topic/31317665 Discussion:
| |
| 9 | Return codes and messages for WS | IN PROGRESS | 25th Apr 2019 | Is there a guide for the description of the error message and the error codes? How are new error states (message + code) added?
| |
| 10 | AAI test data bootstrap | Keong Lim | IN PROGRESS | 25th Apr 2019 | 3rd May: See also AAI Simulator in Policy: https://gerrit.onap.org/r/gitweb?p=policy/models.git;a=blob;f=models-interactions/model-simulators/src/main/java/org/onap/policy/simulators/AaiSimulatorJaxRs.java;hb=HEAD . Was recently updated for custom query https://gerrit.onap.org/r/#/q/pramod+custom and contains hard-coded AAI data/schema. Maybe discuss with Pamela Dragosh about how this data is maintained? 25th Apr: Wiki page OOF - HPA guide for integration testing updated for https://gerrit.onap.org/r/#/c/86588/ 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 AAI-1948 - Getting issue details... STATUS on the brittleness of the ReadTheDocs links to data files. One for VIM: How-To: Register a VIM/Cloud Instance to ONAP and AAI-1928 - Getting issue details... STATUS Potential issues:
Possible solution/action:
|
| 11 | Purpose of fields in AAI | IN PROGRESS | 18th April 2019 | Dénes Németh wrote in AAI-1104 - Getting issue details... STATUS : In think it would be good to answer what is the meaning of the field (collection of PEMs of the CA xor URL) 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 18th Apr: Can we have this documentation go into ONAP in a generic way? 24th Apr: See also questions about "sw-version" in https://lf-onap.atlassian.net/wiki/display/DW/5G+-+PNF+Plug+and+Play?focusedCommentId=16367935 | |
| 12 | range query | IN PROGRESS | 7th Feb 2019 |
| |
| 13 | 2 Types of logging in A&AI WS | ON HOLD | 1st Nov 2018 | There are 2 types of logging in the services
Is that correct? Shouldn't there be just 1 type? 1st Nov: After Casablanca release investigate logging guidelines and figure out what library to use in order to unify logging within A&AI 26th Nov: See also ONAP Application Logging Specification - Post Dublin 29th Nov: how does this fit with LOG-877 - Getting issue details... STATUS ? | |
| 14 | Schema-service roadmap | ON HOLD | 21st Mar 2019 | 31st Jan 2019: The schema-service is ready. Currently it provides file-sharing capabilities in terms of schema/edgerule files. In order for GraphGraph to take advantage of the schema parsing/processing in schema-service additional abstractions have to be implemented on top of the crude file2string functionality currently in schema-service.
GraphGraph needs the following functionality: Venkata Harish Kajur and Manisha Aggarwal What is missing in schema service that is needed in graphgraph is the following:
20. Mar 2019: Open questions for schema-service:
21st Mar 2019: Based on William Reehil comments https://lf-onap.atlassian.net/wiki/display/DW/AAI+Schema+Service?focusedCommentId=16325457 what is "our future proposed functionality"? | |
| 15 | New AAF Certificates at startup | Jimmy Forsyth | ON HOLD | 24th Jan 2019 | AAF will generate certificates to the be used by the containers at startup; AAI services should use the run-time generated certs instead of the ones that are in the repos or oom charts. In dublin the services will mount a volume with certificates. This is on the roadmap for Dublin as a feature.
|
| 16 | Change PNF to use pnf-id as unique key | ON HOLD | 7th March 2019 | Potentially breaking change: AAI-2096 - Getting issue details... STATUS / blocked by ONAPARC-409 - Getting issue details... STATUS See also:
Questions:
| |
| 17 | A&AI monitoring and failure prevention initiative | ON HOLD | 24th Jan 2019 | Mike Elliott wrote in OOM Meeting Notes - 2018-12-5 f. AAI team wanted to get notified of AAI Cassandra issues automatically Keep an eye out for new issues! This should be part of a larger A&AI monitoring and failure prevention initiative! | |
| 18 | AAI HAProxy and 2-way-TLS | ON HOLD | 29th Nov | Technical solution to either decommission the proxy or make design changes to AAF to enable client side certificates. After VF2F we will know if this is a requirement in Dublin. We discuss after this date. question raised: MSB - would client authentication be supported?
| |
| 19 | AAI too slow for OOF/HAS | Keong Lim | ON HOLD | 25th Apr 2019 | Under OOF Homing and Allocation Service (HAS) section, Dileep Ranganathan wrote about Project Specific enhancements:
See also OPTFRA-268 - Getting issue details... STATUS / OPTFRA-291 - Getting issue details... STATUS 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. For holmes, we could possibly create a custom query to address it. What can we do about this? Would the AAI Cacher AAI-1337 - Getting issue details... STATUS help to improve performance? |
| 20 | MultiCloud usage of AAI for HPA telemetry/time-series data to OOF | ON HOLD | 18th April 2019 | Bin Yang and Lianhao Lu (Deactivated) wrote in MULTICLOUD-274 - Getting issue details... STATUS : HPA telemetry data collection and make it persistent in A&AI, from which OOF can leverage during its decision making process.and
and The reason why we propose here is that VES mechanism doesn't store the telemetry data into A&AI. And OOF now can only get those kind of data from A&AI. Some concerns:
| |
| 21 | AAI Backup and Restore | ON HOLD | 10th Jan 2019 | FREEMAN, BRIAN D asked on Re: Backup and Restore Solution: ONAP-OOM : what would be the approach to backup an entire ONAP instance particualarly SDC, AAI, SDNC data ? would it be a script with all the references to the helm deploy releases or something that does a helm list and then for each entry does the ark backup ? What is the AAI strategy for backup and restore? What is the overall ONAP strategy for backup and restore? Should it be unified with the data migration strategy as per "Hbase to Cassandra migration" on 2018-11-14 AAI Meeting Notes?
Jimmy didn't directly raise the topic but there was movement - Keong Lim asked "if istio service mesh is a no-go, is there a replacement for secure onap communications? is backup/restore/upgradability included in s3p?" Michael O'Brien replied that a reference tool set for backup and restore was introduced in Casablanca: Backup and Restore Solution: ONAP-OOM Mike Elliott said he would look at Brian's question, AAI will provide support as needed. | |
| 22 |