Installing and configuring Process Server with a DB2 database server

Process Server provides a single BPM runtime environment that can support a range of business processes for development, test, staging, or production.

Before you begin

You can create the Process database, Performance Data Warehouse database, and Common database either before or during a typical installation of IBM® Business Process Manager Standard. The databases must be created with at least a 32K page size. To create the databases during a typical installation, you must be running an existing DB2 server that is local. Otherwise, you must create the databases before installation and they must be empty when you begin the installation process.

Be prepared to specify the following information during installation:
  • The user name and password for database authentication
  • The database server host name and port
  • The name of the Process database.
  • The name of the Performance Data Warehouse database.
  • The name of the Common database.
If you are installing from images downloaded from Passport Advantage, ensure that you have downloaded all required images (three disk images for Linux systems on Intel; two disk images for other Linux systems), and extracted them to the same directory.
Restriction: Extract the installation files to a directory that does not contain spaces or special characters. The launchpad cannot be started from a directory path that contains spaces or special characters.

About this task

Using the product launchpad, the typical installation installs the software, configures the deployment manager and managed-node profiles, and configures a single cluster deployment environment that consists of a single node and single server.

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 upgrades your product to the latest fix pack or refresh pack level and recommended interim fixes automatically. If you want these upgrades to be installed from a local directory instead, or if you want to specify the fix level, you can use a properties file to tell the Installation Manager where to find the upgrades and which upgrades to install.
    Create the following file:
    • /user_home_directory/bpm_updates.properties
    Note: Ensure that you have read/write access to the folders specified in the bpm_updates.properties file.
    The file uses three prefixes: ifix, fixpack, and launchpad. Each prefix must be followed by a dot. The part of the name after the prefix and the dot can be anything you want, which enables you to point to multiple locations for ifixes, fix packs, and launchpad upgrades. The locations can be either local directories or URLs. For example:
    ifix.1=/bpmUpdates
    fixpack.2=http://test/rep
    launchpad.1=/launchpad_updates
    fixpack.WAS_REP=/WAS_updates
    fixpack.BPM_REP=/BPM_updates
  2. Access the media in one of the following ways, depending on whether you are installing from the product DVD or from images downloaded from Passport Advantage®. You can run only one launchpad at a time.
    • If you are installing from the product DVD, insert the product disk labeled IBM Business Process Manager Standard into the disk drive. Mount the disk drive if necessary. Enter the following command to start the launchpad manually:
      • mount_point/launchpad.sh
    • If you are installing from images downloaded from Passport Advantage, perform the following steps:
      1. Go to the directory into which you extracted the images.
      2. Enter the following command to start the launchpad:
        • extract_directory/launchpad.sh
  3. Optional: If you see a message that prompts you to update the launchpad, click Update to receive the latest updates. 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 use a properties file with the appropriate launchpad prefix as described in step 1 to tell the Installation Manager where to find the upgrades and which upgrades to install.
  4. After starting the launchpad, click Typical installation on the Welcome page.
  5. Select Install Process Server and click Next.
  6. Specify Process Server information:
    • Hostname: This field shows the name of your machine.
    • Location: Enter the installation location for Process Server 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).
    • Environment Type: Select how the Process Server is used:
      • Select Development if the server is to be used in a development capacity.
      • Select Production if the server is to be used in a production capacity.
      • Select Stage if the server is to be used as a temporary location to host changes before putting them into production.
      • Select Test if the server is to be used as a testing environment, for example, for load testing.
    • Name: Specify the name for the Process Server environment. This name is used to connect from a Process Center to this Process Server.
      Restriction: Do not mix production and non-production servers in the same cell.
    • Specify the Username and Password for the cell administrative account. The cell administrator is the primary WebSphere® Application Server administrator. A user assigned to this role can assign other administrator roles, and is responsible for the administration of the cell and topology. A user assigned to this role is not responsible for the administration of the IBM Business Process Manager 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. This role also enables administration of Process Servers, Performance Data Warehouses, and internal users and groups. You must be a user assigned to this role to deploy Process Applications on the Process Center server.
    • Specify the Username and Password for the deployment environment account. The deployment environment administrator is the primary IBM Business Process Manager administrator. A user assigned to this role has administrative access to Process Center and Process Admin Console. 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. This account also enables administration of Process Servers, Performance Data Warehouses, and internal users and groups.
    Select Use this server offline if this Process Server will not be connected to a Process Center. Offline servers can still be used when deploying snapshots of process applications, but the method for deploying process applications to an offline Process Server differs from the method for deploying process applications to an online Process Server.
    If you did not select Use this server offline, provide the following information for the Process Center that this server is to connect to:
    • Hostname: Enter the host or virtual host that this Process Server will use to communicate with Process Center. Use a fully qualified host name. In an environment with a load balancer or proxy server between the Process Server and the Process Center services, make sure that what you designate here matches the URL for accessing the Process Center.
    • Port: Enter the port number of the Process Center. In an environment with a load balancer or proxy server between the Process Server and the Process Center, make sure that what you designate here matches the URL for accessing the Process Center.
    • User name: Enter the name of a Process Center user. Process Server will connect to Process Center as this user.
    • Password: Enter the password for the Process Center user.
    You can click Test Connection to check the connection to the Process Center.
  7. Click Next.
  8. Select Yes to use an existing database.
  9. Specify the required database information.
    Table 1. Required database configuration fields for DB2
    Field Action needed
    Username Enter the user name to authenticate with the database.
    Restriction: User names must not contain National Language Strings (NLS).
    Password Enter a password to authenticate with the database.
    Hostname Accept the default value of localhost or enter the correct database server host name. For example, the IP address.
    Port Accept the default value of 50000 or enter the correct server port number.
    Common database name Accept the default value of CMNDB, or enter the name for the Common database.
    Process database name Accept the default value of BPMDB, or enter the name for the Process database.
    Performance Data Warehouse database name Accept the default value of PDWDB, or enter the name for the Performance Data Warehouse database.

    Click Test Database Connection to verify that you can connect to the BPM databases that are created. Only if the connections to the databases are successful, you can click Next to proceed.

  10. Select Create and initialize these databases during installation to create databases as a part of the typical installation.

    This option is available only for DB2 databases. In order to use this option, the Hostname must be set to localhost. You must be authorized to create databases. If you are an administrative or root user, this option creates the databases. If you are a nonadministrative or nonroot user, this option adds the rights so that it can create the databases.

  11. 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.

    The connection to the service repositories is required to download and install any fix packs and required interim fixes from the Internet, including fixes for WebSphere Application Server and IBM Business Process Manager. An IBM ID and password can be obtained by registering at http://www.ibm.com.

    Click Cancel to continue installing without downloading the required fixes from the Internet 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.

  12. On the Installation summary page, verify 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.
  13. Click Install Software.

Results

After a successful installation, the Quick Start console will start automatically.

What to do next

To learn about security for the environment and applications, see Securing IBM Business Process Manager and applications.