Troubleshooting snapshot installations

Understanding the installation process can help you identify and resolve any errors that occur during snapshot installation.

Steps in the installation process

The following steps happen on the target server during the installation process.

Action taken on the target process server Description
1. Install the necessary library items and assets for the process application and referenced toolkits. The installation process deploys only those referenced toolkits that are not already on the target server. Default values for environment variables and exposed process values (EPVs) are set, and other design-time versioned assets (such as Portal searches) are created.
2. Send tracking definitions to the Performance Data Warehouse. The process server updates the Performance Data Warehouse with any new or changed tracking definitions.
3. Execute the installation service for each toolkit. The installation service for each referenced toolkit must be executed before the installation service for the referring toolkit.
4. Execute the installation service for the process application. The installation service for the process application is the final installation service executed.
5. Migrate data and process instances if there are running business process definition instances. The process server migrates data according to the rules outlined in Data migration rules. The specific actions of this step depend on the migration option that you choose. The migration options are described in Migrating instances .
6. On a connected process server, send a message saying the installation is complete. The user who initiated the installation can see the completion message in the Process Center Console.

Troubleshooting tips

When you experience problems with your snapshot installation, check the SystemOut.log and SystemErr.log files for errors. The following list includes some potential problems and, when appropriate, suggested resolutions.