...
| Drawio | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Provides management of external Systems. 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. The capability to register exernal systems
The capability to test the health of external systems
Update AAI of the status of external systems
Provide GUI to manage external systems
2. API definitions
AAI ESR provides the following interfaces:
| Interface Name | Interface Definition | Interface Capabilities | |||
|---|---|---|---|---|---|
| AAIEESRE-1 | Inventary Service System Register Interface. | An interface to create, update, retrieve, query, delete the service, resources and relationship inventary information for:
AAI also provides Inventory History information | AAIE-2 | AAI Graphical User Interfaces | Provides the capability to view the inventory An manage the registration of external systems:
|
| ESRE-2 | ESR Graphical User Interfaces | Provides a GUI interface to manage the external system register information |
Note: xxxI interface is a Component internal interface. xxxxE interface is a component external interface
The current API documents can be found at:
...
- ESR offered API: https://docs.onap.org/en/casablanca/submodules/aai/esr-server.git/docs/platform/offeredapis.html
ESR consumes the following Interfaces:
| Interface Name | Purpose Reason For Use |
|---|---|
| SDCE-6 | To receive the service and resource artifacts from SDC. |
| AAIE-1 (Inventary service) | To store and retrieve external system register information in the inventory. |
| MCE-5 (Infra Provider Registery) interface | To inform MC of the registration of a new VIM |
3. Component Description:
...
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 ESR uses the following models:
- Inventary Model-
6. System Deployment Architecture
AAI consists of X ESR consists of 1 containers:
- ?????ESR server container
Drawio border true viewerToolbar true fitWindow false diagramDisplayName ESR Deployment View lbox true revision 2 diagramName ESR runtime architecture simpleViewer false width linksdiagramWidth auto tbstyle 821top revisiondiagramWidth 1201
7. New Capabilities in this Release
This release, AAI ESR adds the following Capabilities:
...
- The ability to register and delete the cloud region via the ESR GUI
- Ability to read the status of the multicloud multicloud registration/deregistration process
- The ability to register multiple tennants for a cloud region
- Enhance ESR to support kubernetes based cloud regions
8. References
- AAI read the docs ESR Desciption: https://docs.onap.org/en/casablanca/submodules/aai/aaiesr-commonserver.git/docs/platform/indexarchitecture.html?highlight=AAI
- AAI REST API Documentation - Dublin
- AAI GUI: AAI Graphical User Interface