WebSphere Lombardi Edition 7.2 > Run and installing processes > Releasing and installing processes
Troubleshooting installations
Lombardi completes the following steps in the order shown when performing an installation of a process application snapshot. Understanding the steps in this process is necessary to appropriately troubleshoot installation issues.
The following steps take place on the target Process Server. For example, if you are installing a process application snapshot in your production environment, the following steps take place on the Process Server in that environment.
The target Process Server... Description 1. Installs the necessary library items and assets for the process application and referenced toolkits. Lombardi installs only those referenced toolkits that are not already installed 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. Sends tracking definitions to the Performance Data Warehouse. The Process Server updates the Performance Data Warehouse with any new or changed tracking definitions. 3. Executes 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. Executes the installation service for the process application. The installation service for the process application is the final installation service executed. 5. Migrates data and process instances (if running instances of the BPDs you are installing are discovered). The Process Server migrates data according to the rules outlined in Data migration rules. The specific actions of this step depend upon the migration option that you choose. The migration options are 6. Sends an installation complete message to the Process Center. (Connected servers only) The user who initiated the installation can see that the installation completed in the Process Center Console. When you experience problems with your snapshot installation, you can check the [Lombardi_home]\process-server\logs\tw-expimp.log file for progress messages and the [Lombardi_home]\process-server\logs\tw-error.log file for errors. These log files should help diagnose the problem.
The following list describes the potential issues that can occur during the installation steps:
- If installation of library items and assets generates an exception (step 1), the installation fails at this point and no other steps are taken.
- Failures to send tracking definitions to the Performance Data Warehouse (step 2), do not cause the installation to fail. You can send definitions when the installation completes
- If an installation service generates an exception (step 3 and 4), the installation fails at this point and no other steps are taken. You should build your installation services to capture exceptions and roll back any changes made before the exception is generated. If your installation services do not handle exceptions, you may need to manually roll back changes before attempting to re-install. For example, if all toolkit installation services complete (step 3) and then the installation service for the process application fails halfway through its execution (step 4), you may need to roll back changes resulting from partial completion of step 4, but the toolkit installations (step 3) will be complete and will not need to be executed again.
- Failures to migrate data or instances (step 5) do not cause the installation to fail. You can view the tw-error.log file and you can view validation errors as explained in View and correcting validation errors to help rectify any issues.
Data migration rules
If running instances of the BPDs that you are installing are discovered on the target Process Server, the target server migrates data.
Regardless of the migration option you choose, the Process Server copies environment variables from the installed snapshot(s). If environment variable values have been changed from the defaults, the values most recently set are the ones used. In the case where an installation service sets the values, those values are considered the most recent and are the values used.
If you choose to migrate running process instances to a new version (snapshot), the Process Server performs the following actions:
Copies exposed process values (EPVs) from the installed snapshot(s). If EPVs have been changed from the defaults, the values most recently set are the values used. In the case where an installation service sets the values, those values are considered the most recent and are the values used.
EPVs in referenced toolkits are copied only if the referenced toolkit is not already installed on the target server.
Copies participant groups that map to a list of users. The Process Server copies users from the snapshot with the most recent date.
Users are copied only if participant groups are empty. This ensures that users added by an installation service prior to migration are not overwritten.
- Moves the Default designation from the snapshot of the running instances to the newly installed snapshot. This action takes place only if the snapshot of the running instances has previously been designated the Default snapshot. (See Configure installed snapshots for more information about the Default designation for snapshots.)
View and correcting validation errors
During migration of data and instances, Lombardi performs validation to check for issues with the following:
When errors are discovered, the Process Server generates a message. If you are installing to a connected Process Server, you can view these messages in the Process Center Console as follows:
- Start Lombardi Authoring Environment and open the Process Center Console as explained in Start Lombardi Authoring Environment.
Go to Process Apps, select a process application, and then click the History option :
- Scroll through the entries to find validation errors resulting from a snapshot installation.
Click the link in an entry to see the listed item or more detail.
Parent topic: Releasing and installing processes