X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=README.md;h=02f43bcb9fa2876471485043092305e155684868;hb=HEAD;hp=ce1339bbad9a45323a12f95cf1cdc6dc0774cd4d;hpb=347f178c656d82aa0c6d4ab56eb0846a94d7af40;p=nonrtric%2Fplt%2Frappmanager.git diff --git a/README.md b/README.md index ce1339b..02f43bc 100755 --- a/README.md +++ b/README.md @@ -1,10 +1,82 @@ -# Rapp Manager (This is a prototype) -Rapp manager is an application which lifecycle manages the Rapp. +# rApp Manager (This is a prototype) +rApp manager is an application which lifecycle manages the rApp. -**Rapp packaging model used here is purely a prototype** +**rApp packaging model used here is purely a prototype** -# Integration of ONAP ACM +## Architecture -ONAP ACM is used here as a backend of Rapp manager to lifecycle manage the deployment items as part of Rapp. +![Image](docs/images/architecture.png "rApp Manager Architecture") + +### rApp Package (**It is a prototype**) + +![Image](docs/images/rApp-package-1.png "rApp package") +![Image](docs/images/rApp-package-2.png "rApp package") + +### rApp States + +![Image](docs/images/rApp-states.png "rApp States") + +### rApp Instance States + +![Image](docs/images/rApp-instance-states.png "rApp Instance States") + +### Events responsible for rApp Instance State Transition + +![Image](docs/images/rApp-state-events.png "rApp Manager State Events") + +### rApp Entity Relationship + +![Image](docs/images/rApp-entity-relationship.png "rApp Entity Relationship") + +## Integrations + +### ONAP ACM + +ONAP ACM is used here as a backend of rApp manager to lifecycle manage the deployment items as part of rApp. ONAP ACM related details can be found [here](https://docs.onap.org/projects/onap-policy-parent/en/london/clamp/clamp.html). + + +### Integration of SME (Service Manager) + +This integration is based on the Service Manager function developed as part of O-RAN SC. It is available [here](https://github.com/o-ran-sc/nonrtric-plt-sme/blob/master/servicemanager/README.md) + +### Integration of DME (ICS) + +This integration is based on the ICS as part of O-RAN SC NONRTRIC. It is available [here](https://docs.o-ran-sc.org/projects/o-ran-sc-nonrtric/en/latest/overview.html#information-coordination-service) + +## Flow Diagrams + +### Application Lifecycle + +![Image](docs/images/application-lifecycle.png "rApp Manager Application Lifecycle") + +### rApp Flow + +![Image](docs/images/rApp-flow.png "rApp Flow") + +### rApp Instance Flow + +![Image](docs/images/rApp-instance-flow.png "rApp Instance Flow") + + +## Maven Build + +This build supports Linux and Windows environments. + +In case of below error during the build in Windows environment: + +``` +[INFO] --- exec-maven-plugin:3.1.0:exec (git submodule update) @ rapp-manager-sme --- +C:/Program Files/Git/mingw64/libexec/git-core\git-submodule: line 7: basename: command not found +C:/Program Files/Git/mingw64/libexec/git-core\git-submodule: line 7: sed: command not found +C:/Program Files/Git/mingw64/libexec/git-core\git-submodule: line 22: .: git-sh-setup: file not found +``` + +It is necessary to append additional paths listed below to the System environment variable +named "PATH". These paths can vary based on the git installation location. + +``` +C:\Program Files\Git\usr\bin +C:\Program Files\Git\mingw64\libexec\git-core +```