IBM BPM, V8.0.1, All platforms > Installing, deploying, and undeploying applications in the runtime environment > Installing process application snapshots

Troubleshooting snapshot installations

Exceptions, timeouts, and other failures in the installation process can result in the snapshot not being installed on the server, or in an incomplete snapshot installation.

If you have problems when installing a snapshot, always check the SystemOut.log and SystemErr.log files for information. In addition, check the following list to see whether your problem matches the common errors described in this topic.

An exception is generated during the installation of library items and assets

The installation fails. Resolve this exception and try to install again.

The installation process fails to send tracking definitions to the Business Performance Data Warehouse

The installation continues, but you need to manually send the definitions after the installation is complete. See Sending tracking definitions to Performance Data Warehouse.

The installation service generates an exception when installing the toolkit or process application

The installation fails. Consider building your installation service to capture exceptions and roll back any changes made before the exception is generated; refer to Steps in the snapshot installation process if you need more information on the individual steps in the installation process. If your installation services do not handle exceptions, you might need to manually roll back changes before attempting to reinstall.

For example, if all toolkit installation services complete and then the installation service for the process application fails halfway through its execution, you might need to roll back changes resulting from partial completion of this step. The toolkit installation is complete and does not need to be run again.

The wsadmin connection times out while the BPMInstall command is running

If you are using a SOAP connection, the time required for the BPMInstall command to complete often exceeds the default SOAP timeout value. Even though the command continues to run until it completes, you might see the exception...

java.net.SocketTimeoutException: Read timed out

Edit the property....

com.ibm.SOAP.requestTimeout

...in the profile_root/properties/soap.client.props file if you want to increase the timeout value to prevent this exception.

Failures to migrate data or instances do not cause the installation to fail.

Installing process application snapshots

Related reference:
BPMInstall command