From dc65647fc26fc276cafdc94c9561cafe32684842 Mon Sep 17 00:00:00 2001 From: DylanB95EST Date: Mon, 8 Aug 2022 15:22:54 +0100 Subject: 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 --- docs/cps-scheduled-processes.rst | 44 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 docs/cps-scheduled-processes.rst (limited to 'docs/cps-scheduled-processes.rst') 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`, +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`, +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`, +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. -- cgit 1.2.3-korg