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

Transferring and installing an installation package

After you create and extract an installation package, you need to transfer it to the offline server. Then, use administrative commands on the server to install the package.

Complete the following tasks before install a snapshot on an offline process server.

• Create and extract an installation package.
• Ensure the offline server supports the capabilities in the snapshot.

  If you intend to install a snapshot of a business process application that contains an Advanced Integration Service, you can install the snapshot only on an IBM BPM Advanced offline server. Additional information about server capabilities is in the topic Capabilities of IBM BPM configurations.

• Ensure you have the correct permission to perform the installation.

  If you are not a member of a group that is authorized to install to the specified location, you might see the error User user_name is not authorized to install the snapshot. Ensure that the <offline-install-group> is a valid group and that user_name is a member of the group.

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.

To transfer an installation package and then install that package on an offline server...

Procedure

1. Transfer the installation package to the offline process server using FTP or a similar utility.

2. Optional: Limit the offline installation to specific groups:
   1. Open the 100Custom.xml file.

   2. Create a new element called <offline-install-group> in the <server> element.

      <offline-install-group> $(Install-Group1)</offline-install-group>

   3. Ensure that the user who is performing the offline installation is part of the $(Install-Group1) group.

      If there are multiple users who can perform offline installation and they belong to different groups, then specify these as shown below:

      <offline-install-group> $(Install-Group1)</offline-install-group>
      <offline-install-group> $(Install-Group2)</offline-install-group>

      The following rules apply for the <offline-install-group>:

      • The value of <offline-install-group> element is a group name. The group must exist in a user registry that is configured on the server.

      • If the <offline-install-group> element is not present or is empty, then everyone can install on the offline process server.

      • If there are multiple elements specified and one is empty, then the empty element is ignored and the value from the other elements is used.

3. Run the BPMInstallOfflinePackage command on the offline process server.

Example

The following example illustrates how to install a snapshot of the BillingDispute process application. The snapshot installation package (BillingDispute.zip) was created and extracted on the Process Center Server and is being installed on the offline Process Server ProcessServer01.

In the example, the user establishes a SOAP connection to the Process Center server.

• Jython example

  wsadmin -conntype SOAP -port 4080 -host ProcessCenterServer01.mycompany.com -user admin -password admin -lang jython
  
  AdminTask.BPMInstallOfflinePackage('[-inputFile C:\myProcessApps\BillingDispute.zip]')

• Jacl example

  wsadmin -conntype SOAP -port 4080 -host ProcessCenterServer01.mycompany.com -user admin -password admin
  
  $AdminTask BPMInstallOfflinePackage {-inputFile C:\myProcessApps\BillingDispute.zip}

What to do next

If you log into Business Space, you can navigate to the dashboard for the process application.

If you experience problems with your installation, check the process-installer.log file. See Troubleshooting snapshot installations for more information about where issues can occur.

Installing snapshots on offline process servers

Related tasks:
Extracting an installation package to a file

Related reference:
BPMInstallOfflinePackage command

Related information:
installProcessAppPackage command-line utility
The 99Local.xml and 100Custom.xml configuration files