Installing snapshots on offline process servers

If you want to install a snapshot on an IBM® Process Server that is not currently connected to the Process Center server (an offline server), create an installation package, extract it, and transfer it to the offline server. Then, use administrative commands on the server to install the package.

Before you begin

Complete the following tasks before you install a snapshot on an offline process server.
  • Create a snapshot of the process application to be installed.
  • Add an offline server, making sure that its version is identical to the version of your Process Center server.
  • Before you install a snapshot on a Process Server, make sure that the snapshot can be activated successfully on a Process Center. A snapshot that cannot be activated on Process Center will usually fail to activate on a Process Server.
  • Ensure that the target Process Server supports the capability exploited by the snapshot.

    For example, if your process application contains Advanced Integration Services, that is, Service Component Architecture (SCA) modules and dependent libraries, you can install it only on a Process Server that is configured for IBM Business Process Manager Advanced. If you attempt to install the snapshot on a Business Process Manager Standard or Business Process Manager Express® server, you will receive a message or exception that states that the server does not contain sufficient capabilities to run the process application.

About this task

These tasks use the Process Center console and the BPMCreateOfflinePackage, BPMExtractOfflinePackage, and BPMInstallOfflinePackage commands to create an installation package and install it on an offline server. You can also use the retrieveProcessAppPackage and installProcessAppPackage commands, although they have been deprecated.

Installation packages are available on the Process Center server as long as the selected offline server exists. If you remove the offline server, the installation packages for that server are also deleted.

Do not try to install process application snapshots from two Process Centers to the same Process Server environment. Snapshots have names and acronyms that must be unique, but that uniqueness is determined in the Process Center at the time the snapshot is created. If snapshot names and acronyms are not unique, this error is generated during the installation of the snapshot: "java.lang.Exception: java.lang.Exception: The snapshot with name v3 of process application My process application is already present on this server."

If you are developing process applications in multiple Process Centers, ensure that you import the snapshots into a common Process Center before you install them on a Process Server. Installing from one Process Center ensures that duplicate snapshot names and acronyms are detected during import of the snapshot, instead of failing during installation.