You can change the location where the index is stored by modifying an environment variable. To change the index update interval, include completed tasks in the index, or turn off the task indexing, you must edit the 100Custom.xml configuration file.
The task index allows process participants in IBM® Process Portal to search for tasks that contain particular metadata or instance data.
The location of the task index is determined by the value of the environment variable BPM_SEARCH_TASK_INDEX. This variable has cell scope on a stand-alone server, and cluster scope on a cluster.
To reduce the additional task indexing being incurred by all cluster members, cluster members can share the index across nodes. Only one cluster member is responsible for maintaining the task index at a time. This is enforced by a locking strategy on the index. To set up the task index, use a shared network storage solution for your task index and change the value of the cell scoped BPM_SEARCH_TASK_INDEX_ROOT variable to point to the common location.
If you want particular cluster members to have their own index you can change the value of the cell scoped BPM_SEARCH_TASK_INDEX_ROOT variable to point to a different location.
To locate the environments variables in the administrative console, click
.To change the task index location, in the administrative console, click
. If the BPM_SEARCH_TASK_INDEX variable does not exist, define it with cell scope then set the value to the wanted location.<search-index>
<task-index-enabled>true</task-index-enabled>
<task-index-update-interval>10</task-index-update-interval>
<task-index-update-completed-tasks>false</task-index-update-completed-tasks>
<task-index-store-fields>false</task-index-store-fields>
</search-index>
XML tag | Configuration setting description |
---|---|
<task-index-enabled> | To enable task indexing, set this Boolean value to true; if the task index does not exist, it will be created. To turn off task indexing, use the value false; if the index does not exist it is not created. When this setting is set to the value false, the search field in the Process Portal user interface is hidden. |
<task-index-update-interval> | This integer value specifies the time interval
between task index updates in seconds. The specified interval determines
when the state of the instance variables is captured for tasks that
completed since the last index update. Only those tasks that are completed
during the current interval are searchable using the latest instance
data. The default value for the update interval is 10 seconds. The minimum value is one second. |
<task-index-update-completed-tasks> | This Boolean value controls whether the task index is updated for completed tasks. The default value is false, which means that only information about open tasks is updated. If you change the value to true, instance-level updates, such as business data that is updated later in the process, is propagated to completed tasks. |
<task-index-store-fields> | This Boolean value controls whether the actual field values are stored as separate fields. The default value is false, which means that the actual field values are not stored as separate fields. You might want to change the value to true for debugging purposes because it improves the readability for humans, or because it allows queries by other search tools. |