...
| Drawio | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The CLAMP functional entity provides the capability to manage runtime control loopsAAI (Available and active inventory function provides real-time views of the resrouces and services in managed by and their relationships. It provides the capability to
- Create control loop from DCAE blueprint sent by SDC
- Create configuration policy from the policy Tosca sent by SDC
- Configure DCAE applications of the control loop
- Associate µService configuration policies to the DCAE application
- Configure the operations to be taken by the control loop (by creating/updating/deleting operational policies)
- Deploy/un-deploy control loop flow (blueprints) to DCAE
- Control loop visualization.
CLAMP relies on Policy to communicate to App-C/VF-C/SDN-C/SO in runtime, hence these are not part of CLAMP
2. API definitions
CLAMP 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 | |||
|---|---|---|---|---|---|
| CLAMPEAAIE-1 | Control Loop Lifecycle Management Inventary Service Interface. | A user interface for:
| CLAMPE-2 | Control loop dashboard. User interface to show the overall status of the control loop through DMAAP events | Display and update: Events received and actions taken on the control loop. 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 |
Note: xxxI interface is a Component internal interface. xxxxE interface is a component external interface
The current API documents can be found at:
The provided UI interfaces are found at: CLAMP latest user guide
- CLAMP internal APIs can be found: clamp swagger pdf
CLAMP
AAI consumes the following Interfaces:
| Interface Name | Purpose Reason For Use | ||
|---|---|---|---|
| SDCE-6 | To receive the Control Loop Blueprint from SDCTo receive | PolicyE-2 | To create and configure the closed Loop Operational Policies and Configuration policies(DCAE Aps. Config.) |
| DCAEE-x | Retrieve DCAE appplication status | ||
| DCAEE-y | Deploy/remove DCAE application. |
3. Component Description:
...
4. known system limitations
Runtime: None
Clamp data redundancy is dependent on Kubernetes and the persistent volume.
...
- 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
Clamp uses the following models:
- Service model (received from SDC)
- VNF model (received from SDC)
- Policy Model.Invetary Model
6. System Deployment Architecture
Clamp consists AAI consists of 5 X containers:
- CLAMP container
- MariaDB container
- Kibana container
- E_Search container
- LogStash container
Drawio border true viewerToolbar true fitWindow false diagramName AAI runtime architecture simpleViewer false width diagramWidth 821 revision 12
7. New Capabilities in this Release
This release, CLAMP AAI adds the following Capabilities:
- Introduction of the model driven approach for Control Loops
- add policy-model to the SDC distribution
- automatic rendering of configuration policy UI based on the distributed policy model
- better rending of the display of the control loop flow based on the distributed blueprint
- enhanced internal model to better support model driven approach. Extended PNF support
8. References
- CLAMP Overview & User Guide AAI read the docs: https://docs.onap.readthedocs.ioorg/en/latestcasablanca/submodules/aai/clampaai-common.git/docs/index.html?highlight=AAI CLAMP internal interfaces: https://onap.readthedocs.io/en/latest/_downloads/d3c9f924c6586fe411d40a05ad9b1bb7/swagger.pdf
- AAI REST API Documentation - Dublin
- AAI GUI: AAI Graphical User Interface