Installing and configuring Process Center with a new DB2 Express database server

Process Center includes a repository for all processes, services, and other assets that were created in the IBM® Business Process Manager authoring environments. You can use the integrated Process Server in Process Center to run processes as you build them. When you are ready, you can install and run those same processes on the Process Server in your runtime environments.

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. Overwrite directories, if prompted.

About this task

Using the typical installation option, you can install DB2 Express and configure the required databases for IBM Business Process Manager. Select typical installation only if you have administrative privileges (are an Administrator user) and do not have an existing DB2 database server on the system. If you are installing DB2 Express as a Windows domain user, the domain user name must exist and be added to the local Administrators group before you start the launchpad.

From the product launchpad, the typical installation process installs the software, configures the deployment manager and managed-node profiles, and configures a single-cluster deployment environment that consists of one node and one server. It also installs IBM WebSphere SDK Java Technology Edition 7 (Java 7) and the profiles use it, except on Linux on Power LE where it installs Java 7.1. On supported operating systems, you can optionally switch the profiles to a different version of Java. For more information, see Switching the edition of Java used in IBM BPM.

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

Procedure

  1. Optional: If you are connected to the Internet, the typical installation process automatically upgrades your product to the latest refresh pack and interim fix level. If you want these upgrades to be installed from a local directory instead, or if you want to specify the fix level, you can modify a properties file to direct Installation Manager to the upgrades to install.
    Create the following file:
    • C:/HOMEPATH/bpm_updates.properties
    where
    • On Windows XP, the HOMEPATH environment variable points to C:/Documents and Settings/user_name
    • On Windows 7, Windows Vista, or Windows Server 2008, 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 three prefixes: ifix, fixpack, and launchpad. Each prefix must be 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 interim fixes, fixpacks, and 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:
    ifix.1=C:/bpmUpdates
    fixpack.2=http://test/rep
    launchpad.1=C:/launchpad_updates
    fixpack.WAS_REP=C:/WAS_updates
    fixpack.BPM_REP=C:/BPM_updates
  2. 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 Standard on Windows 7, Windows Vista, or Windows Server 2008, 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.
  3. 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 the updates to be installed from a local directory, you can modify a properties file with the appropriate launchpad prefix as described in step 1 to direct Installation Manager to the updates to install.
  4. On the Welcome page, click Typical installation.
  5. Select Install Process Center and click Next.
  6. Click Next.
  7. Optional: Change the location information.
    • Host name: This field shows the name of your machine.
      Important: If a value of localhost or 127.0.0.1 is used for the host name, Process Server installations on a remote system will not be able to connect to Process Center.
    • Location: Enter the installation location for Process Center, or click Browse to select the location.
      Note:
      • The installation location must either be an empty directory or a directory that does not exist and is created during installation.
      • Because you are installing DB2 Express, your installation location cannot contain National Language Strings (NLS).
    Restriction: Because you are installing DB2 Express, your installation location cannot contain National Language Strings (NLS).
  8. Specify the User name and Password for the cell administrative account. The cell administrator is the primary WebSphere® Application Server administrator. A user who is assigned to this role can assign other administrator roles, and is responsible for the administration of the cell and topology. A user who is assigned to this role is not responsible for the administration of the IBM Business Process Manager Standard components. This role provides access to all interfaces, enabling users to alter or delete all types of available library items and assets, including process applications and toolkits. The user in this role also administers process servers, Performance Data Warehouses, and internal users and groups. You must be a user assigned to this role to deploy process ppplications on the Process Center server.
  9. Specify the User name and Password for the deployment environment administrative account. The deployment environment administrator is the primary IBM Business Process Manager administrator. A user who is assigned to this role has administrative access to Process Center and Process Admin Console. Having this role provides access to all interfaces, enabling users to alter or delete all types of available library items and assets, including process applications and toolkits. The user in this role also administers process servers, Performance Data Warehouses, and internal users and groups.
  10. Click Next.
  11. Select No. I need one installed for me. to install DB2 Express.
  12. Specify the User name and Password for the DB2 Express database.
    Restriction:
    • If you use a Windows domain user ID, include the at sign (@) and the domain name: userID@example.com. Confirm that the domain user ID already exists and was added to the local Administrators group before the launchpad was started.
    • User names must not contain National Language Strings (NLS)
    • User names must be maximum 30 characters long
  13. Click Next to continue. You are prompted to provide your IBM ID 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 IBM ID 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 IBM ID 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.

  14. On the Installation summary page, verify that the installation options and read the license agreements. If you agree to the terms of the license agreements, click I have read and accepted the license agreement and notices.
  15. Click Install Software.

Results

After a successful installation, the Quick Start console starts automatically.

What to do next

If you used the Windows domain user ID to access existing DB2 Express database and tables, and the profile could not be created, use the following solution:
  1. Follow the steps listed in DB2 log file error: SQL1092N "USERID does not have the authority to perform the requested command or operation.".
  2. Edit the file install_root\logs\config\BPMConfig_timestamp.log. (There should only be one log file with that file name.)
  3. In the log file, search for the line that contains the following string:

    com.ibm.bpm.config.BPMConfig.validateBPMConfigCommand(): ENTRY -create -de

  4. When you have located the string, copy the portion of the string that begins with the -create parameter and paste it to a BPMConfig script invocation in the install_root\bin directory on the Windows command line. For example:

    BPMConfig -create -de C:\Users\jdoe\AppData\Local\Temp\IBM_LaunchPad_BPM_1383510443100\SingleCluster.properties

To learn about security for the environment and applications, see Creating a secure environment.