Page History

...

Title

Responsible

Status

Last discussed

Notes

1

Unreleased docker images in helm chart

Team

Status

colour	Green
title	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

Keong Lim

Status

colour	Green
title	Open

Raised as JIRA case

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-2437

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.

SoumyaNaikis invited to a future session to discuss further

32

Dublin Branching

James Forsyth

Status

colour	Yellow
title	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

34

Review El Alto proposals

AAI Epics in JIRA:

Jira

server	ONAP JIRA
jqlQuery	project=AAI and issuetype in (Epic) and fixVersion = "El Alto Release" order by key desc
count	true
serverId	425b2b0a-557c-3c0c-b515-579789cceedb

45

Cached vs realtime connection

Keong Lim

Status

colour	Blue
title	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:

In graphadmin\src\main\resources\etc\appprops\aaiconfig.properties:
Line 47: aai.realtime.clients=RO,SDNC,MSO,SO
In resources\aai-resources\src\main\resources\etc\appprops\aaiconfig.properties:
Line 92: aai.realtime.clients=RO,SDNC,MSO,SO
In traversal\aai-traversal\src\main\resources\etc\appprops\aaiconfig.properties:
Line 69: aai.realtime.clients=SDNC,SO,MSO

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:

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-2416

56

debugging Traversal custom query problem

Keong Lim

Status

colour	Blue
title	Done

10th May 2019

Calling Traversal custom query with curl:

Code Block

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:

Code Block
{ "start": [ "network/generic-vnfs/generic-vnf/test-bulkadd-gvnf-4" ], "query": "query/count-vnf-byVnfType" }

Response returns error:

Code Block

{
  "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:

Code Block
"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

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-2408

. Also raised

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-2417

67

GraphGraph demo

Pavel Paroulek

Status

colour	Yellow
title	In Progress

2nd May 2019

A 5-10 minute demo of GraphGraph

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-531

.

Feedback needed!

78

AAI Modeling Multi-part key for schema elements

Keong Lim

Status

colour	Yellow
title	In Progress

25th Apr 2019

From https://lists.onap.org/g/onap-discuss/topic/31317665

Discussion:

The cloud-region schema element is unusual in that it has a two-part key i.e. "cloud-owner" and "cloud-region-id". There are not many other usages of it ("ctag-pool" , "service-capability" and "route-target" are three others, out of over 100 other schema elements)
Is it possible to enhance the error message to indicate that part of the key value is missing from the relationship-data?
Jira
server ONAP JIRA
columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId 425b2b0a-557c-3c0c-b515-579789cceedb
key AAI-2391
Is it time to deprecate the relationship-data and switch over to using the related-link only?
Is there any modeling guidance that would steer new designs away from using multi-part key for schema elements?
Are there other caveats to using the multi-part key design for schema elements?
Can we get feedback from Chandra Cinthalaon the key design for multi-part keys and whether this will be more common going forward?
From: CINTHALA, CHANDRA [mailto:cc1196@att.com]
Sent: Tuesday, April 30, 2019 12:16 AM
To: Keong Lim <Keong.Lim@huawei.com>; FORSYTH, JAMES <jf2512@att.com>
Cc: AGGARWAL, MANISHA <amanisha@att.com>
Subject: Re: [confluence] Keong Lim has assigned tasks to you in "2019-05-02 AAI Developers Meeting"

Keong,

I think we have no plans to deprecate the relation-data option the in the A&AI relationship payload.
It's another option for the client to specify the relationship.

Thanks
Chandra
See also email from Marco Platania in https://lists.onap.org/g/onap-discuss/topic/31385256

89

Return codes and messages for WS

Pavel Paroulek

Status

colour	Yellow
title	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?

William LaMont will send James Forsyth the output of a script that formats the error.properties file to make a wiki page and readthedocs
James Forsyth should commit that script and create a wiki for the error properties

910

AAI test data bootstrap

Keong Lim

Status

colour	Yellow
title	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/

The below put_vLB.sh script can be used to submit the vLB data to A&AI in order to run ConfigScaleOut use case. This script and referenced JSON files are used on an AAI instance where the cloud-region and tenant are already defined.

Similarly:

Jira
server ONAP JIRA
serverId 425b2b0a-557c-3c0c-b515-579789cceedb
key TEST-133
Jira
server ONAP JIRA
serverId 425b2b0a-557c-3c0c-b515-579789cceedb
key INT-705
vCPE Use Case Tutorial: Design and Deploy based on ONAP

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	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

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-1928

Potential issues:

fragility of static import data file w.r.t. schema changes and version upgrades for each ONAP release?
how "common" is this knowledge, i.e. what to load, where to get it, who else should be using it, etc?
should it be automated/scripted, rather than manual steps to bootstrap?
should it be a simulator program or test harness, rather than a static data file?
should it reside within AAI CI/CD jobs for maintenance and upgrade of schema versions?
who maintains the data itself? Is there a "data repository" which can be delegated to other teams, e.g. like documentation repository links in git?
how many other teams have similar private stashes of AAI bootstrap data?
does it need to be published at a stable URL to avoid linkrot?

Possible solution/action:

Look at the examples API and possibly enhance it to get the desired behavior
Collect all the known data samples, commit to test-config repo, update the teams/wiki to point to test-config repo instead of keeping private stash of AAI data
Jira
server ONAP JIRA
serverId 425b2b0a-557c-3c0c-b515-579789cceedb
key AAI-2399

1011

Purpose of fields in AAI

Keong Lim

Status

colour	Yellow
title	In Progress

18th April 2019

Dénes Németh wrote in

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-1104

:

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?
2. Or does AAI simply reflect the wishes of all the client projects that use it to store and retrieve data?

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://wiki.onap.org/display/DW/5G+-+PNF+Plug+and+Play?focusedCommentId=63996633#comment-63996633

1112

range query

Keong Lim

Status

colour	Yellow
title	In Progress

7th Feb 2019

if I had some AAI data with attributes that are strings but nominally contain date/timestamps, is there a way to query for a particular range of values?
is there a way to do partial match? regex?
PUT /aai/v13/query?format=raw
Code Block
{"gremlin": "g.V().has('aai-ts', org.janusgraph.core.attribute.Text.textContains('URL'))"}
https://github.com/JanusGraph/janusgraph/blob/master/janusgraph-core/src/main/java/org/janusgraph/core/attribute/Text.java

Invite Arul Nambi and CT Paterson to next week's dev call to talk about how sparky/elastic does partial/range matches

1213

2 Types of logging in A&AI WS

Pavel Paroulek

Status

title	On Hold

1st Nov 2018

There are 2 types of logging in the services

one read from EELFManager
the other Logger log = Logger.getLogger( ...

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

29th Nov: how does this fit with

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	LOG-877

?

1314

Schema-service roadmap

James Forsyth

Pavel Paroulek

Status

title	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.

Venkata Harish Kajurwill ask Manisha Aggarwalif the current functionality of the schema-service is the final version for Dublin and if there will be further enhancements in next releases.

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:

rest call to get available schemas
list of all schema nodes/items (like vserver, tenant, p-interfaces..) for example on a REST path /schemas/{schema}/nodes
all relevant attributes of a given node/item for example on REST path /schemas/{schema}/nodes/{node}
edges/relationships with their attributes between schema nodes/items (for example on REST path /schemas/{schema}/edges where you specify a "from" "to" schema items as query params)
subgraph of the schema, where you specify 1. initial (root) items/node (like tenant or vserver) 2. schema version and 3. number of parent/cousin/child hops from the initial item/node
all paths in a given schema graph between 2 items/nodes (like vserver and tenant) for a given schema version
edges in the schema graph should be composed of edges in the schema file + edges created from the edgerules file
edges should contain basic attributes when delivered via the subgraph call (like parent/child relationship and important properties from edgerules) and have additional (or all) attributes when queries via /schemas/{schema}/edges REST endpoint.

20. Mar 2019:

Open questions for schema-service:

what is the current implemented functionality?
what are the business use-cases in ONAP for schema-service? Description of functionality in relation to other services/projects is needed. In other words who needs it and why?
if no business use-cases can be formulated we should consider removing schema-service from A&AI and replacing it with standard file-sharing mechanisms.

21st Mar 2019:

Based on William Reehil comments

https://wiki.onap.org/display/DW/AAI+Schema+Service?focusedCommentId=45299262#comment-45299262 what is "our future proposed functionality"?

1415

New AAF Certificates at startup

Jimmy Forsyth

Status

title	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.

is this for all service and/or HAProxy?
Where are the certificates coming from (OOM/gerrit/generated by AAF)

James Forsythwill ask Jonathan Gatham when the certificate init image is going to be available in ONAP and wether it is documented 31 Jan 2019

1516

Change PNF to use pnf-id as unique key

Status

title	On Hold

7th March 2019

Potentially breaking change:

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	AAI-2096

/ blocked by

Jira

server	ONAP JIRA
serverId	425b2b0a-557c-3c0c-b515-579789cceedb
key	ONAPARC-409

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version Current

Key