summaryrefslogtreecommitdiffstats
path: root/docs/drools/feature_sesspersist.rst
diff options
context:
space:
mode:
authorSaryu Shah <ss3917@att.com>2019-06-03 16:23:04 +0000
committerSaryu Shah <ss3917@att.com>2019-06-03 16:27:51 +0000
commitf96ef833d3b00f84639b712579d6e2824e6063b4 (patch)
tree7bd13b47fb88e8b4859e55ad5c8629cebd7eadcd /docs/drools/feature_sesspersist.rst
parent1000b605908e4ff18e5a077026d5eadbc0ae46d8 (diff)
Create Drools PDP documentation - features
Create Drools PDP documentation in parent - features Change-Id: Ie710842a7921fd46ffdef4628d50637093111cc8 Issue-ID: POLICY-1678 Signed-off-by: Saryu Shah <ss3917@att.com>
Diffstat (limited to 'docs/drools/feature_sesspersist.rst')
-rw-r--r--docs/drools/feature_sesspersist.rst49
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/drools/feature_sesspersist.rst b/docs/drools/feature_sesspersist.rst
new file mode 100644
index 00000000..4bb5ef62
--- /dev/null
+++ b/docs/drools/feature_sesspersist.rst
@@ -0,0 +1,49 @@
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+************************************
+Feature: Session Persistence
+************************************
+
+The session persistence feature allows drools kie sessions to be persisted in a database surviving pdp-d restarts.
+
+ .. code-block:: bash
+ :caption: Enable session persistence
+ :linenos:
+
+ policy stop
+ features enable session-persistence
+
+The configuration is located at:
+
+ - *$POLICY_HOME/config/feature-session-persistence.properties*
+
+Each controller that wants to be started with persistence should contain the following line in its *<controller-name>-controller.properties*
+
+ - *persistence.type=auto*
+
+ .. code-block:: bash
+ :caption: Start the PDP-D using session-persistence
+ :linenos:
+
+ db-migrator -o upgrade -s ALL
+ policy start
+
+Facts will survive PDP-D restart using the native drools capabilities and introduce a performance overhead.
+
+ .. code-block:: bash
+ :caption: Disable the session-persistence feature
+ :linenos:
+
+ policy stop
+ features disable session-persistence
+ sed -i "/persistence.type=auto/d" <controller-name>-controller.properties
+ db-migrator -o erase -s sessionpersistence # delete all its database data (optional)
+ policy start
+
+End of Document
+
+.. SSNote: Wiki page ref. https://wiki.onap.org/display/DW/Feature+Session+Persistence
+
+