From 27ae3475ae6d9f1676ebe88a0452d3ce9bdb92dc Mon Sep 17 00:00:00 2001 From: jhh Date: Thu, 25 Mar 2021 14:08:45 -0500 Subject: Add drools no-locking feature documentation Issue-ID: POLICY-3142 Signed-off-by: jhh Change-Id: I461da8d2b901c38b9bdb9ef2478c474ca96b6691 Signed-off-by: jhh (cherry picked from commit a61a2fe6f137095cbdde7b8101a10254887c1e19) --- docs/drools/feature_nolocking.rst | 38 ++++++++++++++++++++++++++++++++++++++ docs/drools/pdpdEngine.rst | 1 + 2 files changed, 39 insertions(+) create mode 100644 docs/drools/feature_nolocking.rst diff --git a/docs/drools/feature_nolocking.rst b/docs/drools/feature_nolocking.rst new file mode 100644 index 00000000..5399f8b0 --- /dev/null +++ b/docs/drools/feature_nolocking.rst @@ -0,0 +1,38 @@ + +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +******************* +Feature: no locking +******************* + +.. contents:: + :depth: 3 + +The no-locking feature allows applications to use a Lock Manager that always succeeds. It does not deny +acquiring resource locks. + +To utilize the no-locking feature, first stop policy engine, disable other locking features, and then enable it +using the "*features*" command. + +In an official OOM installation, place a script with a .pre.sh suffix: + + .. code-block:: bash + :caption: features.pre.sh + #!/bin/sh + + sh -c "features disable distributed-locking" + sh -c "features enable no-locking" + + +under the directory: + + .. code-block:: bash + oom/kubernetes/policy/components/policy-drools-pdp/resources/configmaps + + +and rebuild the policy charts. + +At container initialization, the distributed-locking will be disabled, and the no-locking feature will be enabled. + +End of Document diff --git a/docs/drools/pdpdEngine.rst b/docs/drools/pdpdEngine.rst index 360d85eb..d19eac15 100644 --- a/docs/drools/pdpdEngine.rst +++ b/docs/drools/pdpdEngine.rst @@ -783,6 +783,7 @@ unnecessary or have not been thoroughly tested: feature_sesspersist.rst feature_statemgmt.rst feature_testtransaction.rst + feature_nolocking.rst Data Migration ============== -- cgit 1.2.3-korg