X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fplatform%2Ffeature_sesspersist.rst;fp=docs%2Fplatform%2Ffeature_sesspersist.rst;h=4bb5ef62c4aef9378188c31279896059d116a2df;hb=ef28b6dd662b9daebf120aef0c9b8d4387260c72;hp=0000000000000000000000000000000000000000;hpb=d18118014319955fcf3402e8231f023dbde4f56a;p=policy%2Fengine.git

diff --git a/docs/platform/feature_sesspersist.rst b/docs/platform/feature_sesspersist.rst
new file mode 100644
index 000000000..4bb5ef62c
--- /dev/null
+++ b/docs/platform/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
+
+