Set the RF_CHECKPOINT_FINISHED_TIMEOUT_SECS Parameter in WCI Cluster Search

(Doc ID 942949.1)

Last updated on DECEMBER 02, 2016

Applies to:

Oracle WebCenter Interaction - Version 6.1 and later
Information in this document applies to any platform.

Goal

This note describes the steps you need to take if you wish to control the checkpoint timeout of your search server. The checkpoint timeout default is 5 minutes, and it is likely that this will need to be increased in production environments.

This is controlled by the RF_CHECKPOINT_FINISHED_TIMEOUT_SECS variable.  This should be set to allow enough time for the index files transfer to complete from the node where the checkpoint is being taken to the cluster location.  This can be observed in the <CLUSTER_LOCATION>\cluster\log\cluster.log file by following the log entries like below.  In this snippet the file transfer takes about 10 minutes.  Each case varies on network speed and index size.

<entry timestamp="2010-08-05T13:52:40+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Awaiting MSG_CHECKPOINT_FINISHED"/>
</entry>
<entry timestamp="2010-08-05T13:52:40+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="progress message from node SN01 with 3130775685 bytes"/>
</entry>
......
<entry timestamp="2010-08-05T14:02:55+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="progress message from node SN01 with 3130775685 bytes"/>
</entry>
<entry timestamp="2010-08-05T14:04:09+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Received MSG_CHECKPOINT_FINISHED"/>
</entry>
<entry timestamp="2010-08-05T14:04:09+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Removing out-dated index queues"/>
</entry>
<entry timestamp="2010-08-05T14:06:30+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Removed out-dated index queues"/>
</entry>
<entry timestamp="2010-08-05T14:06:30+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Removing out-dated checkpoints"/>
</entry>
<entry timestamp="2010-08-05T14:06:30+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="running" status="success" message="Removed out-dated checkpoints"/>
</entry>
<entry timestamp="2010-08-05T14:06:30+07:00" node="SN01">
<checkpoint type="create" timestamp="2010-08-05T13:52:39+07:00" state="end" status="success" tid="0_13_1156" message="Successfully created checkpoint"/>


When this value is set to something lower than required, a timeout error is thrown in the cluster.log file. That may look like the following:

.....

<entry timestamp="2010-11-22T22:18:50-02:00" node="SN01">
<checkpoint type="create" timestamp="2010-11-22T21:17:00-02:00" state="running" status="success" message="progress message from node SN01 with 11522964834 bytes"/>
</entry>
<entry timestamp="2010-11-22T22:23:49-02:00" node="SN01">
<checkpoint type="create" timestamp="2010-11-22T21:17:00-02:00" state="running" status="success" message="Removing out-dated checkpoints"/>
</entry>
<entry timestamp="2010-11-22T22:23:51-02:00" node="SN01">
<checkpoint type="create" timestamp="2010-11-22T21:17:00-02:00" state="running" status="success" message="Removed out-dated checkpoints"/>
</entry>
<entry timestamp="2010-11-22T22:23:51-02:00" node="SN01">
<checkpoint type="create" timestamp="2010-11-22T21:17:00-02:00" state="end" status="fail" tid="0_588_1366" message="Message queue timed out or is shutting down"/>

Solution

Sign In with your My Oracle Support account

Don't have a My Oracle Support account? Click to get started

My Oracle Support provides customers with access to over a
Million Knowledge Articles and hundreds of Community platforms