summaryrefslogtreecommitdiffstats
path: root/docs/cps-scheduled-processes.rst
diff options
context:
space:
mode:
authorDylanB95EST <dylan.byrne@est.tech>2022-08-08 15:22:54 +0100
committerDylanB95EST <dylan.byrne@est.tech>2022-08-09 10:56:54 +0100
commitdc65647fc26fc276cafdc94c9561cafe32684842 (patch)
treeef551ee432e2a61382afd9db6ea64af402eb7fb7 /docs/cps-scheduled-processes.rst
parent57ba6b73a739b3c6dbbe7c68c79359f443dfc33d (diff)
Module Sync, Data Sync, Retry Mechanism RTD
- Add Documentation for Module Sync, Data Sync, and Retry Mechanism Proccesses for RTD - Update CPS-Core header on the Index to just CPS - Add Cps-NCMP Customizations for retry mechanism and data sync Issue-ID: CPS-1181 Change-Id: Idb76de380e49e42ca337cabcf2708b940e15f46f Signed-off-by: DylanB95EST <dylan.byrne@est.tech>
Diffstat (limited to 'docs/cps-scheduled-processes.rst')
-rw-r--r--docs/cps-scheduled-processes.rst44
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/cps-scheduled-processes.rst b/docs/cps-scheduled-processes.rst
new file mode 100644
index 000000000..01fe66aae
--- /dev/null
+++ b/docs/cps-scheduled-processes.rst
@@ -0,0 +1,44 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2022 Nordix Foundation
+
+.. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING
+.. cpsScheduledProcesses:
+
+
+CPS Scheduled Processes
+#######################
+
+.. toctree::
+ :maxdepth: 1
+
+Introduction
+============
+
+The following section is a list of the current scheduled processes running within the CPS system.
+
+Module Sync
+-----------
+The module sync is a user :ref:`configurable timed process<additional-cps-ncmp-customizations>`,
+which is set to search for CM-Handles within CPS with an *'ADVISED'* state.
+Once the CM-Handle(s) is processed by the module sync, the CM-Handle state is then set to *'READY'*, if the process completes successfully.
+If for any reason the module sync fails, the CM-Handle state will then be set to *'LOCKED'*,
+and the reason for the lock will also be stored within CPS.
+
+Data Sync
+---------
+The data sync is a user :ref:`configurable timed process<additional-cps-ncmp-customizations>`,
+which is set to search for CM-Handles with a sync state of *'UNSYNCHRONIZED'*.
+Once the CM-Handle(s) with a sync state of *'UNSYNCHRONIZED'* is processed by the data sync,
+the CM-Handle sync state is then set to *'SYNCHRONIZED'*, if the process completes successfully.
+If the data sync fails, the CM-Handle sync state will remain as *'UNSYNCHRONIZED'*, and will be re-attempted.
+
+Retry Mechanism
+---------------
+The retry mechanism is a user :ref:`configurable timed process<additional-cps-ncmp-customizations>`,
+which is used to search for CM-Handles which are currently in a *'LOCKED'* state.
+If the CM-Handle is ready to be retried then, the CM-Handle(s) in a *'LOCKED'* state is processed by the retry mechanism,
+the CM-Handle state is then set to *'ADVISED'*.
+Whether the CM-Handle is ready to be retried is dependent on both the number of attempts to sync the CM-Handle,
+and the last update time of the CM-Handle state.
+With each new attempt to unlock the CM-Handle, the time until the CM-Handle can next be retried is doubled.