Versions Compared

Old Version 3

changes.mady.by.user Keong Lim

Saved on

compared with

New Version Current

changes.mady.by.user Keong Lim

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contributors

Contributors
ordername

Glossary

TermDefinition
AAI-internal-clients

Sub-projects of AAI that are direct clients of schema services (currently have dependency on aai-schema-ingest library) including:

  • data-router, gizmo, resources, router-core, sparky-be, spike, traversal, validation

Sub-projects of AAI that are indirect clients of schema services (via aai-common library) or are schema-agnostic including:

  • babel, cacher, chameleon, champ, data-router, eis, enricher, esr, gallifrey, gizmo, graphadmin, graphgraph, logging-service, model-loader, resources, rest-client, router-core, search-data-service, sparky-fe, spike, tabular-data-service, traversal, validation
ONAP-project-clients

Projects of ONAP that are definitely clients of AAI including:

Projects of ONAP that are likely clients of AAI including:

  • CLAMP
, DCAE
  • , DMaaP, ExtAPI, Holmes, MSB, MultiVIM, OOM, Policy, Portal, SDC, SO, SDNC, VFC, VNFSDK
, VID, UUI

...

  • , UUI
producer-consumer pairings

Apart from "internal" AAI data, the data in AAI is produced by a non-AAI component and then consumed by another non-AAI component. Therefore the schema definitions and intended meanings of each schema element are not controlled by AAI itself.

See examples in AAI Schema Producer-Consumer Pairings

deployment tools

Tools (e.g. Helm, ansible, Docker Compose, etc) used to:

  • place the microservices into their run-time environment
  • distribute data files for initial configuration
  • perform the initial configuration of microservices
  • get the ONAP system running as intended
IDL Files

Some form of "Interface Definition Language" which unifies and replaces the OXM files and EdgeRule files as definition of AAI schema

Purple highlightsHighlight change from predecessor ONAP Release

References

Use Case Outlines

ONAP Release TargetCasablancaAAI Schema asAAI Schema asdistributed via deployment tools to AAI-internal-clients deployment tools to

AAI Schema as:

G
ONAP Release TargetUse Case SummaryDeprecated Functions
Amsterdam, Beijing

AAI Schema asis:

  • single-data-file configuration per version, i.e. one OXM file and one EdgeRule file
  • distributed via source-code repository to AAI-internal-clients and ONAP-project-clients
  • built into and deployed as microservice JAR file
  • effective only upon microservice startup
Amsterdam, Beijing
Casablanca

AAI Schema asis:

  • multiple-data-file configuration, i.e. multiple OXM files and multiple EdgeRule files
  • distributed via source-code repository to AAI-internal-clients and ONAP-project-clients
  • built into and deployed as microservice JAR file
  • effective only upon microservice startup
  • single-data-file configuration per version
Dublin

AAI Schema asis:

  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. multiple OXM files and multiple EdgeRule files, without change to JAR files
    deployed as data files
    • effective only upon AAI-internal-clients startup
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple OXM files and multiple EdgeRule files
    • effective only upon AAI Schema Service startup
  • distributed via run-time API to AAI-internal-clients without change to JAR files
    • effective only upon AAI-internal-clients startup
  • distributed via source-code repository to ONAP-project-clients, i.e. XSD files and generated POJOs
  • built into and deployed as ONAP-project-clients JAR file
    • effective only upon ONAP-project-clients startup
  • single-data-file configuration per version
  • distributed via source-code repository to AAI-internal-clients
  • built into and deployed as microservice JAR file
Dublin and beyondEach of the AAI Schema as-internal-clients and ONAP-project-clients will need to identify the relevant pieces of AAI schema that relates uniquely to their operations. The multiple-data-file configuration to be grouped by producer-consumer pairings.
Dublin and beyondEach of the AAI-internal-clients will need to decide when/how to proceed with changing over to the updated methods of distributing the AAI schema.
El Alto

AAI Schema is:

  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. multiple OXM files and multiple EdgeRule files, without change to JAR files
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple OXM files and multiple EdgeRule files
    • effective only upon AAI Schema Service startuprun-time refresh
  • distributed via run-time API to AAI-internal-clients
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to ONAP-project-clients without change to JAR files
    • effective only upon ONAP-project-clients startup
  • single-data-file configuration per version
  • distributed via source-code repository to AAI-internal-clients
  • built into and deployed as microservice JAR file
  • effective only upon AAI Schema Service startup
  • effective only upon AAI-internal-clients startup
  • distributed via source-code repository to ONAP-project-clients
  • XSD files and generated POJOs
El Alto and beyondEach of the ONAP-project-clients will need to decide when/how to proceed with changing over to the updated methods of distributing the AAI schema.
  • Needing to deal with schema change fragility (see JIRA for "UnrecognizedPropertyException" or "Unrecognized field" error messages)
Frankfurt

AAI Schema is:

  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. XSD files and generated POJOsbuilt into and deployed as multiple IDL files, without change to JAR files
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple IDL files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time SDC API to AAI Schema Service, i.e. multiple TOSCA files and CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time API to AAI-internal-clients
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to ONAP-project-clients without change to JAR filefiles
    • effective only upon ONAP-project-clients startup
  • single-data-file configurationper version
  • distributed via source-code repository to AAI-internal-clients
  • distributed via deployment tools to AAI-internal-clients
Dublin
  • built into and deployed as microservice JAR file
  • effective only upon AAI Schema Service startup
  • effective only upon AAI-internal-clients startup
  • distributed via source-code repository to ONAP-project-clients
  • XSD files and generated POJOs
  • multiple OXM files and multiple EdgeRule files
G release

AAI Schema is:

  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. multiple IDL files or multiple TOSCA files and CSAR files, without change to JAR files
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple OXM IDL files or multiple TOSCA files and multiple EdgeRule CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time SDC API to AAI Schema Service, i.e. multiple TOSCA files and CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time API to AAI-internal-clients
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to ONAP-project-clients without change to JAR files
    • effective only upon ONAP-project-clients startup
  • distributed via run-time API to ONAP-project-clients
    • effective only upon ONAP-project-clients startup
  • single-data-file configurationper version
  • distributed via source-code repository to AAI-internal-clients
    distributed via deployment tools to AAI-internal-clients
  • built into and deployed as microservice JAR file
  • effective only upon AAI Schema Service startup
  • effective only upon AAI-internal-clients startup
El Alto

  • distributed via source-code repository to ONAP-project-clients
  • XSD files and generated POJOs
  • multiple OXM files and multiple EdgeRule files
G release and beyondEach of the ONAP-project-clients will need to decide when/how to proceed with changing over to the updated methods of distributing the AAI schema.
H release and beyond

AAI Schema is:

  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. multiple IDL files or multiple TOSCA files and CSAR files, without change to JAR files
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple OXM IDL files or multiple TOSCA files and multiple EdgeRule CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time SDC API to AAI Schema Service, i.e. multiple TOSCA files and CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time API to AAI-internal-clients
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to ONAP-project-clients without change to JAR files
    • effective upon ONAP-project-clients run-time refresh
  • distributed via run-time API to ONAP-project-clients
    • effective only upon ONAP-project-clients startuprun-time refresh
  • single-data-file configurationper version
  • distributed via source-code repository to AAI-internal-clients
  • built into and deployed as microservice JAR file
  • effective only upon AAI Schema Service startup
  • effective only upon AAI-internal-clients startup
  • distributed via
  • source-code repository to ONAP-project-clients
  • XSD files and generated POJOs
  • multiple OXM files and multiple EdgeRule files
  • effective only upon ONAP-project-clients startup
Frankfurt
I release and beyond

AAI Schema is:

  • federation of AAI instances with disjoint/partially-overlapping schemas and databases
    • facade to stitch disjoint schema and data back into a unified representation
    • schema change and version upgrade by deploying new AAI instance to join federation
    • rolling upgrade and data migration between AAI instances within federation
    • support for multiple-sources-of-truth scenario:
      Jira Legacy
      serverSystem Jira
      serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
      keyAAI-1343
  • multiple-data-file configuration
  • distributed as data files via deployment tools to AAI-internal-clients, i.e. multiple IDL files or multiple TOSCA files and CSAR files, without change to JAR files
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to AAI Schema Service, i.e. multiple
OXM
  • IDL files or multiple TOSCA files and
multiple EdgeRule
  • CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time SDC API to AAI Schema Service, i.e. multiple TOSCA files and CSAR files
    • effective upon AAI Schema Service run-time refresh
  • distributed via run-time API to AAI-internal-clients
    • effective upon AAI-internal-clients run-time refresh
  • distributed as data files via deployment tools to ONAP-project-clients without change to JAR files
    • effective upon ONAP-project-clients run-time refresh
  • distributed via run-time API to ONAP-project-clients
    • effective upon ONAP-project-clients run-time refresh
  • single-data-file configurationper version
  • distributed via source-code repository to AAI-internal-clients
    distributed via deployment tools to AAI-internal-clients
  • built into and deployed as microservice JAR file
  • effective only upon AAI Schema Service startup
  • effective only upon AAI-internal-clients startup
  • distributed via deployment toolssource-code repository to ONAP-project-clients
  • XSD files and generated POJOs
  • multiple OXM files and multiple EdgeRule files
  • effective only upon ONAP-project-clients startup
  • single unified AAI schema and database
J release and beyond
  • ???