STATUS: Draft
AAI (Available and Active Inventory):
1 High Level Component Definition and Architectural Relationships
The AAI (Available and active inventory) function provides real-time views of the resource and services in managed by and their relationships. It provides
Realtime views of the managed resources and services and their relationships
The relivance of the managed resources and services to the ONAP components.
It is a registry of the active, available and assigned assets.
It maintains a multidimenstional relationship amonst the managed services and resouces.
2. API definitions
AAI provides the following interfaces:
Interface Name | Interface Definition | Interface Capabilities | Version | Status | Consumed Models |
---|---|---|---|---|---|
AAIE-1 | Inventory Service Interface. | An interface to create, update, retrieve, query, delete the service, resources and relationship inventory information for:
AAI also provides Inventory History information | v16 | ||
AAIE-2 | AAI Graphical User Interfaces | Provides the capability to view the inventory |
Note: xxxI interface is a Component internal interface. xxxxE interface is a component external interface
The current API documents can be found at:
AAI consumes the following Interfaces:
Interface Name | Purpose Reason For Use |
---|---|
SDCE-6 | To receive the service and resource artifacts from SDC. |
3. Component Description:
A more detailed figure and description of the component.
<< For later inclusion >>
4. known system limitations
- Multithreaded concurrent operations on the same objects can cause duplicates in the graph - we have implemented stickiness in the haproxy that sits between AAI and clients to keep a client bound to the same node which can mitigate this, but we do not force locking on updates which means that malicious or careless clients can cause duplicates in the graph. We provide cleanup utilities for data grooming, but we recommend that clients are careful not to send multiple requests on the same object within microseconds of one another.
- Operators should pay special attention to giving cassandra enough space, because we have known issues where things go pretty bad (like unhelpful or just wrong error messages) when the disks fill up on the cassandra cluster nodes.
5. Used Models
AAI uses the following models:
- Inventary Model
6. System Deployment Architecture
FFS
7. New Capabilities in this Release
This release, AAI adds the following Capabilities:
- -
8. References
- AAI read the docs: https://docs.onap.org/en/casablanca/submodules/aai/aai-common.git/docs/index.html?highlight=AAI
- AAI REST API Documentation - Dublin
- AAI GUI: AAI Graphical User Interface