Updating the Process Portal index

If a problem occurs with the Process Portal index, you might need to run a command to rebuild it. You can also update the index for an instance or task, or remove an instance or task from the index.

Index administration

You can perform the following administrative actions for the task index by running commands from the profile/bin directory:

In a network deployment environment, all cluster members on the same node share the index by default. Run the commands for updating the index on the deployment manager. To specify where the command runs, include the -host host_name parameter of the node and the -port SOAP_port parameter of an application cluster member. Repeat the command for each node in the cluster. The default values for these parameters are -host localhost -port 8880.

Rebuilding the index

If there are problems with the index or searches in Process Portal, you might need to rebuild the index. To rebuild the index, enter one of the following commands on the command line: For Windows operating system

processIndexFullReIndex.bat -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port

processIndexFullReIndex.sh -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port

The command deletes the existing index and creates a new index. While the index is being built, the search facility in Process Portal is unavailable.

Attention: For compatibility with previous releases of Process Portal, the taskIndexFullReIndex command is still available. However, this command produces the same result as the processIndexFullReIndex command.

Freeing up space in the index by removing deleted tasks and instances

When tasks and instances are deleted from the database, they are also automatically deleted from the index. You can, however, manually delete tasks and instances from the index that were previously deleted from the database. To remove the deleted tasks and instances from the index, enter one of the following commands on the command line: For Windows operating system

processIndexRemoveDeleted.bat -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port

processIndexRemoveDeleted.sh -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port

Attention: For compatibility with previous releases of Process Portal, the taskIndexRemoveDeletedTasks command is still available. However, this command produces the same result as the processIndexRemoveDeleted command.

Updating the index for a specific instance or task

If you do not change the default configuration settings in the 100Custom.xml file, the index is updated every 10 seconds. However, you can also trigger updates to the index when a specific instance or task is updated, for example, if you doubt the correctness of the search index record for a specific instance or task.

You can update the index by entering one of the following commands on the command line.

For instances

processIndexUpdateInstance.bat -user DeAdmin_user -password DeAdmin_user  -host host_name -port SOAP_port instanceID

processIndexUpdateInstance.sh -user DeAdmin_user -password DeAdmin_user  -host host_name -port SOAP_port instanceID

For tasks

taskIndexUpdate.bat -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port taskID

taskIndexUpdate.sh -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port taskID

The index is updated for the specified instance or task, regardless of its state. For example, if the specified task is in the completed state and the value for the <task-index-update-completed-tasks> element in the 100Custom.xml file is set to false, the index is still updated for the task.

Deleting a specific instance or task

To delete a specific instance or task from the index, enter one of the following commands on the command line.

For instances

processIndexDeleteInstance.bat -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port instanceID

processIndexDeleteInstance.sh -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port instanceID

For tasks

taskIndexDeleteTask.bat -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port taskID

taskIndexDeleteTask.sh -user DeAdmin_user -password DeAdmin_user -host host_name -port SOAP_port taskID