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.

Before you begin

Complete the following tasks before you 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 an advanced process application (which is a process application that has been opened in an IBM® Integration Designer workspace or that contains a toolkit that has been opened in the workspace), you can install the snapshot only on an IBM Business Process Manager Advanced offline server. Additional information about server capabilities is in the topic Capabilities of IBM Business Process Manager 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.

About this task

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, perform the following steps.

Procedure

Transfer the installation package to the offline process server using FTP or a similar utility.
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.
Open a command prompt on the offline process server.
Run the installation package using the installProcessAppPackage command utility, which is located in the install_root/BPM/Lombardi/tools/process-installer directory. The required parameters vary depending on whether you have a stand-alone environment or a network deployment environment.
- Stand-alone environment
```
installProcessAppPackage.bat install_package_name user_name user_password
```
- Network deployment environment
```
installProcessAppPackage.bat -host host_name -port port_name -nodeName node_name -serverName server_name install_package_name user_name user_password
```
The command is run against the default profile, although you can use optional parameters to run the command against a different profile. See "The retrieveProcessAppPackage and installProcessAppPackage commands."

What to do next

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.

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