Installing interactively on an existing installation of WebSphere Application Server

Using the custom installation option, you can install IBM® Business Process Manager on an existing installation of WebSphere® Application Server.

Before you begin

If you are installing from downloaded images from Passport Advantage, ensure that you downloaded all three required images for Windows. If you are installing from the DVD images, obtain the compressed files from the DVDs. In both cases, extract all of the files from the compressed files to the same location on your hard disk.

When you install the product, also install any available cumulative fixes or fix packs. If you are using the launchpad to install and you have Internet access, you can include available fixes from the live repository during installation. Otherwise, you must install the upgrades from a local directory as described in Step 2 in the steps that follow. For example, you could add fixpack.BPM_CF=local_repository_path to the bpm_updates.properties file to include a cumulative fix.

About this task

Only one IBM Installation Manager is required to install multiple instances of IBM Business Process Manager.

Procedure

Go to the directory into which you extracted the images and enter the following command to start the launchpad:
```
extract_directory/launchpad64.exe
```
To install or run IBM Business Process Manager Advanced - Process Server on Windows, you must elevate your Microsoft Windows user account privileges. Whether you are an administrative user or a non-administrative user, right-click launchpad64.exe and select Run as administrator.
You can run only one launchpad at a time.
Optional: If you are prompted to update the launchpad, click Update. The updates are installed and your launchpad is restarted automatically.
If you do not have access to the Internet and want updates to the launchpad to be installed from a local directory, you can modify a properties file to direct Installation Manager to the updates. Create the following file:
- C:/HOMEPATH/bpm_updates.properties
where:
- The HOMEPATH environment variable points to C:/Users/user_name
Note: Ensure that you have read/write access to the folders that are specified in the bpm_updates.properties file.
The file uses a launchpad prefix, followed by a period. The name after the prefix and the period can be anything you want, which enables you to point to multiple locations for launchpad upgrades. The locations can be either local directories or URLs. The following code is an example of the prefixes and names in the properties file:
```
launchpad.1=C:/launchpad_updates
```
On the Welcome page, click Custom installation.
Click Installation on an existing WebSphere Application Server.
Select Install as administrative user to install the product as an administrative user. If you are in the Administrators group, you can perform the product installation as an administrative user. If you are not an administrative user, or if you want to install to your own user name without administrative privileges, clear this option.
Click Update to update WebSphere Application Server Network Deployment. When Installation Manager opens, click Update to install available updates. On the Update Packages page, select Show all to display available updates.
Note: WebSphere Application Server Network Deployment must be updated only if it is not already at the fix pack level that IBM Business Process Manager Advanced - Process Server requires. IBM Business Process Manager can be installed only on top of the supported version of WebSphere Application Server Network Deployment. See system requirements for more information
Click Install.
On the Install Packages page, WebSphere Application Server Network Deployment, IBM WebSphere SDK Java Technology Edition (Optional) (Java™ 7), IBM Business Process Manager Advanced - Process Server, and IBM DB2 Express are selected by default. Clear the WebSphere Application Server Network Deployment and IBM DB2 Express options.
Note: For the existing WebSphere Application Server, the Java version used is Java 6 by default, except on Linux on Power LE, where Java 7.1 is used (and the other options are not available). If you clear the Java 7 package option, Java 6 will be used. If you install Java 7 but find that you still need to use Java 6, you can switch before you create profiles by using the managesdk command. For more information, see Switching the edition of Java used in IBM BPM.
You can also optionally install IBM WebSphere SDK Java Technology Edition 7.1 (Java 7.1) to use instead of Java 6 or Java 7.
Click Next to continue. You are prompted to provide your IBMid and password to connect to the IBM service repositories.
Note: If you are using a local properties file, you do not need to provide your IBMid and password.

A connection to the service repositories is required to download and install fix packs and required interim fixes from the Internet, including fixes for WebSphere Application Server and IBM Business Process Manager. You can obtain an IBMid and password by registering at http://www.ibm.com.

To continue installing without downloading the required fixes, click Cancel or clear the Use your support account to include updates with the installation option on the Installation summary page.

After successfully installing the product, you can use Installation Manager to install the required fixes.
On the Licenses page, read the license agreement. If you agree to the terms of the license agreement, click I accept the terms in the license agreements, and then click Next.
On the Location page, the Use the existing package group is selected by default. Make sure that the path points to the installation directory where WebSphere Application Server is installed, and then click Next.
On the Features page, expand the plus symbol to select the package features that you want to install. Installation Manager automatically enforces dependencies with other features and shows the updated download size and disk space requirements for the installation.
1. Select the translations to install. Under Translations Supported by All Packages, English is selected by default for the English version. To install other language versions, select the appropriate language under Translations Supported by Only Some Packages.
2. Optional: To see the dependency relationships between features, select Show Dependencies.
3. Optional: Click a feature to view its brief description under Details.
4. Select one of the following features to install.
  - IBM Process Center License
  - IBM Process Server Production License to use the server in production
  - IBM Process Server Non-production License to use the server only for development, test, or staging.
  Your selection is recorded in the product tag for inventory purposes, so select the license feature that matches the license you have purchased and want to use. There are no functional differences.
  Restriction: Do not mix production and non-production servers in the same cell.
When you are finished selecting features, click Next.
On the Summary page, review your choices before installing the IBM Business Process Manager Advanced - Process Server package. When you are satisfied with your installation choices, click Install. A progress indicator shows the percentage of the installation completed.
When the installation process is complete, a message confirms the success of the process.
1. Optional: To open the installation log file for the current session in a new window, click View Log File. To continue, close the Installation Log window.
2. If you plan to use the BPMConfig command-line utility to create your Deployment Environment, select None to complete the installation.
3. Click Finish.

What to do next

After you install IBM BPM, you must configure the product by creating profiles, setting up database tables, and configuring the network deployment environment. To do these configuration tasks in one step, use the BPMConfig command. Alternatively, you can do each configuration step separately using the Profile Management Tool, if it is supported on your operating system, and the Deployment Environment wizard.

Important: If you are migrating business data and applications from a previous version, use the configuration instructions in the Migrating to IBM Business Process Manager section.