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:


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:


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:

  1. Start Lombardi Authoring Environment and open the Process Center Console as explained in Start Lombardi Authoring Environment.

  2. Go to Process Apps, select a process application, and then click the History option :

  3. Scroll through the entries to find validation errors resulting from a snapshot installation.

  4. Click the link in an entry to see the listed item or more detail.

Parent topic: Releasing and installing processes

+

Search Tips   |   Advanced Search