You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 9
Next »
STATUS: Draft
AAI (Available and Active Inventory):
1 High Level Component Definition and Architectural Relationships
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlN0ZXBoZW4gVGVycmlsbCIsIm91dHB1dFR5cGUiOiJibG9jayIsImxhc3RNb2RpZmllck5hbWUiOiJTdGVwaGVuIFRlcnJpbGwiLCJsYW5ndWFnZSI6ImVuIiwiZGlhZ3JhbURpc3BsYXlOYW1lIjoiQUFJIFN5c3RlbSBWaWV3Iiwic0ZpbGVJZCI6IiIsImF0dElkIjoiNjA4ODQzOTIiLCJkaWFncmFtTmFtZSI6IkFBSSBTeXN0ZW0gQ29udGV4dCBWaWV3IiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IkFSQyBBQUkgQ29tcG9uZW50IERlc2NyaXB0aW9uIC0gRHVibGluIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjo2MDg4NDM4NiwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6Njg1NDMxODgsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjYsIm1hY3JvSWQiOiJlYzkyNWNhYy1jZmM0LTQ1NDUtOThlOS0zYWU0Yzg3NzJmYjYiLCJwcmV2aWV3TmFtZSI6IkFBSSBTeXN0ZW0gQ29udGV4dCBWaWV3LnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiI5NTEiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE1Njk5MzgwMzgwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
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.
AAI provides the following interfaces:
Interface Name | Interface Definition | Interface Capabilities |
---|
AAIE-1 | Inventary Service Interface. | An interface to create, update, retrieve, query, delete the service, resources and relationship inventary information for:- Cloud infrastructure (including cloud infrastructure regions and availability zones, cloud infrastructure resources such as servers, storage, VLANs, cloud network technologies,...)
- Paths and connectors
- Business Customers and busines customer relationship to managed assets
- Service Instances (including the relationship to used resources)
- Resource instances (including allotted resources) (virtual and physical, including VNFs, PNFs, Switches, VNF modules)
- External systems (systems that ONAP connects to)
- Images
- Networks
- Infrastructure tenants
- Relationships
- Interfaces
- IP addresses
- Configurations
- Licences
- Site resources
AAI also provides Inventory History information |
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:
6. System Deployment Architecture
AAI consists of X containers:
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IlN0ZXBoZW4gVGVycmlsbCIsIm91dHB1dFR5cGUiOiJibG9jayIsImxhc3RNb2RpZmllck5hbWUiOiJTdGVwaGVuIFRlcnJpbGwiLCJsYW5ndWFnZSI6ImVuIiwiZGlhZ3JhbURpc3BsYXlOYW1lIjoiQUFJIGRlcGxveW1lbnQgdmlldyIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjYwODg0Mzk0IiwiZGlhZ3JhbU5hbWUiOiJBQUkgcnVudGltZSBhcmNoaXRlY3R1cmUiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiQVJDIEFBSSBDb21wb25lbnQgRGVzY3JpcHRpb24gLSBEdWJsaW4iLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjYwODg0Mzg2LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjo2ODU0MzE4OCwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MiwibWFjcm9JZCI6ImJkZWVmZTQ0LTI1ZmUtNDc4Yy1hMGZiLTIxYWVlM2FhZjc0ZCIsInByZXZpZXdOYW1lIjoiQUFJIHJ1bnRpbWUgYXJjaGl0ZWN0dXJlLnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiI4MjEiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE1NTIxMzM3NzcwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
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 REST API Documentation on readthedocs.io
- AAI GUI: AAI Graphical User Interface