X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fmodeling.rst;h=7ebf6fecd57f3d9d350081ae354400030f051ea7;hb=c78f6d318b394966da7f0c9a27ea69f9a2a61147;hp=863e932631e6f7fc642d4fcbeb394276b5839c47;hpb=915960f4372a433ed2aea792b2a09c3f2831b9d0;p=cps.git diff --git a/docs/modeling.rst b/docs/modeling.rst index 863e93263..7ebf6fecd 100644 --- a/docs/modeling.rst +++ b/docs/modeling.rst @@ -1,6 +1,7 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 .. Copyright (C) 2021 Pantheon.tech +.. Modifications Copyright (C) 2021-2023 Nordix Foundation .. _modeling: .. toctree:: @@ -54,7 +55,24 @@ Data Querying -- **CPS Path** is used to query data nodes. The CPS Path is described in detail in :doc:`cps-path`. +- **CPS Path** is used to query data nodes. + +.. toctree:: + :maxdepth: 1 + + xpath.rst + cps-path.rst + +Additional information on CPS-Core Interfaces +--------------------------------------------- + +.. toctree:: + :maxdepth: 1 + + cps-delta-feature.rst + +.. Below Label is used by documentation for other CPS components to link here, do not remove even if it gives a warning +.. _cps_ncmp_modelling: NCMP Modeling ============= @@ -62,9 +80,11 @@ NCMP Modeling Data Model ---------- -NCMP stores DMI Plugin and CM Handle relations using a data model described as per this Yang module. +NCMP stores DMI-Plugin and CM Handle relations using a data model described as per this Yang module. + +:download:`DMI Yang Module ` -:download:`DMI Yang Module ` +Note: Although additional-properties are present in the model of the dmi-registry, these are considered private metadata and as such are not queryable. Basic Concepts -------------- @@ -73,6 +93,30 @@ Basic Concepts These are stored as Anchors within CPS-Core. + - **CM-Handle States** are used to represent the potential states in which a CM-Handle can transition between. + + The 5 possible CM-Handle states are: ADVISED, READY, LOCKED, DELETING, DELETED + + **ADVISED** indicates that a CM-Handle has been registered successfully, and is waiting for the module synchronization process to sync the CM-Handle. + + **READY** indicates that the CM-Handle has been synced successfully. + + **LOCKED** indicates that the CM-Handle has not synced successfully. A retry mechanism within CPS will set the state back to ADVISED after a set time. + + **DELETING** indicates that the CM-Handle is currently being deleted. + + **DELETED** indicates that the CM-Handle has been deleted successfully. + + - **Data-sync state** is the state of the data synchronization process of the CM-Handle + + There are 3 possibles states: NONE_REQUESTED, UNSYNCHRONIZED, SYNCHRONIZED + + **NONE_REQUESTED** indicates that the data sync is not requested by the user + + **UNSYNCHRONIZED** indicates the cm-handle is waiting for the data sync watchdog operation to carry out the sync process + + **SYNCHRONIZED** indicates the watchdog process has finished the data synchronization successfully + - **Datastores** represent different views of the cm data. Datastores are defined for NCMP to access the CPS running or operational datastores. Currently supported datastores are: @@ -83,4 +127,22 @@ Basic Concepts | Passthrough-operational | config-true, config-false | read-only | +--------------------------------+-------------------------------------+-------------------------+ | Passthrough-running | config-true | read-write | - +--------------------------------+-------------------------------------+-------------------------+ \ No newline at end of file + +--------------------------------+-------------------------------------+-------------------------+ + +Additional information on CPS-NCMP interfaces +--------------------------------------------- + +.. toctree:: + :maxdepth: 1 + + ncmp-cmhandle-querying.rst + ncmp-inventory-querying.rst + ncmp-data-operation.rst + +CPS-NCMP Scheduled Processes +---------------------------- + +.. toctree:: + :maxdepth: 1 + + cps-scheduled-processes.rst