Adding Jackrabbit Janitor Thread Configuration Parameters (Optional)

ActiveMatrix BPM Version 4.3.0 uses a new Jackrabbit janitor thread. If you are upgrading, you can (optionally) add new configuration parameters for this janitor thread to the CONFIG_HOME\bpm\bpm_app_name\appdev\repository.xml file.
Note: If you are installing a new ActiveMatrix BPM installation, these parameters are already present in the repository.xml file, so you do not need to perform this task.

On a distributed ActiveMatrix BPM system, when adding a new node to the system, the operation to add the new node can take a long time to complete if the BPM database contains a large number of Jackrabbit journal entries (in the APA_JL_Journal table).

(The Jackrabbit content repository is used by Application Development. Jackrabbit maintains an internal journal of all changes made to the repository, and replays those journal entries when a new node gets added. If the journal contains a large number of entries, the time taken to replay them can be significant.)

Configuring the Jackrabbit janitor thread can prevent this problem. The thread periodically cleans up the journal entries so that the number of records in the APA_JL_Journal database table does not continually grow.

Procedure

  1. Open the CONFIG_HOME\bpm\bpm_app_name\appdev\repository.xml file in a text editor.
  2. Locate the <Cluster> element and its child <Journal> element: 
    <Cluster id="@NODE_ID@" syncDelay="2000">
  <Journal class="org.apache.jackrabbit.core.journal.MSSqlDatabaseJournal">
      <param name="schemaCheckEnabled" value="false"/>
      .
      .
      .
      <param name="password" value="@DB_PSWD@"/>
  </Journal>
</Cluster>
  3. Add the following parameters to the <Journal> element: 
    <-- Enable clean-up thread -->
<param name="janitorEnabled" value="true"/>

<-- Sleep time in seconds (default = 24 hours) -->
<-- <param name="janitorSleep" value="86400"> -->

<-- Initiate the first run at 1:00 am (default = 3:00 am) -->
<param name="janitorFirstRunHourOfDay" value="1"/>
  4. Change the janitorEnabled, janitorSleep and janitorFirstRunHourOfDay values as required. Do NOT change any other values in the file.
    Note: If you want to change the janitorSleep value, remember to uncomment it as well. For example, to set janitorSleep to 12 hours instead of the default 24 hours, change the value to: 
    <param name="janitorSleep" value="43200"/>
  5. Save your changes.