summaryrefslogtreecommitdiffstats
path: root/docs/platform/feature_sesspersist.rst
blob: 4bb5ef62c4aef9378188c31279896059d116a2df (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
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