Installing IBM BPM Standard

To use IBM® Stewardship Center, you must first install and configure IBM Business Process Manager Standard.

Before you begin

  • Review the installation roadmap for IBM Business Process Manager Standard.
  • You must specify the IBM BPM SSL port. To determine your IBM BPM SSL port, open the IBM WebSphere® Application Server administrative console on the computer where you installed IBM Business Process Manager Standard. Click Servers > SingleClusterMember1 > Clusters > WebSphere application server clusters > Single Cluster > Cluster Members > Ports. The IBM BPM SSL port is the WC_defaulthost_secure port number.
    Note: WebSphere Application Server must not be in a cluster topology unless JR54966 is installed.
  • You must have IBM Business Process Manager Standard, Version 8.5.6, IBM WebSphere Application Server Network Deployment, Version 8.5.5.5, and Installation Manager, Version 1.6.2 available for download.
  • If you plan to create your own processes by using the Stewardship Center Application Toolkit, you must install IBM Process Designer, Version 8.5.

Procedure

  1. Install IBM Business Process Manager Standard.
    1. Install IBM Business Process Manager Standard. Remember the credentials that you specify for the cell administrative account and the deployment environment administrative account, as you use these credentials to log in to IBM BPM to verify your installation.
    2. When the installation is complete, start the Process Center, and select Start the Process Center Deployment Environment.
      For example, if you installed IBM BPM in the default directory, you might run the following commands:
      In AIX®, HP-UX, Linux® environments
      cd /opt/ibm/BPM/v8.5/bin
      ./BPMQuickStart.sh ProcessCenter DmgrProfile celladmin BPM123pwd
      Microsoft Windows environment
      cd c:\ibm\bpm\v8.5\bin
      BPMQuickStart.bat ProcessCenter DmgrProfile celladmin BPM123pwd
    3. Close the Quick Start page, and then click Exit to close the IBM BPM Installation page.
    4. Restart your operating system.
    5. If you are installing IBM InfoSphere® Information Server in the same instance of IBM BPM, stop IBM WebSphere Application Server Network Deployment.
  2. Upgrade IBM WebSphere Application Server Network Deployment and IBM Business Process Manager Standard to the supported versions.
    1. To determine which versions of IBM WebSphere Application Server and IBM BPM are installed, run the versionInfo command from the <BPM_install_directory>/bin directory.
      For example:
      In AIX, HP-UX, and Linux environments
      cd /opt/ibm/BPM/v8.5/bin
      versioninfo.sh
      
      In Microsoft Windows environment
      cd c:\ibm\bpm\v8.5\bin
      versioninfo.bat
    2. If you are installing InfoSphere Information Server in the same instance as IBM BPM, rename the version of Installation Manager that was installed.
    3. Download and install IBM Installation Manager.
    4. Download and install WebSphere Application Server V8.5.5.5. Follow the instructions in Installing fix pack on distributed operating systems using local repository.
      Important: If you do not complete this step, then you cannot use Installation Manager, Version 1.6.2 to update IBM WebSphere Application Server Network Deployment and IBM Business Process Manager Standard to the supported versions.
    5. Run Installation Manager to update IBM WebSphere Application Server Network Deployment and IBM Business Process Manager Standard to the supported versions. Clear the Show recommended only check box, and then select the correct versions of IBM Business Process Manager Standard and IBM WebSphere Application Server Network Deployment 64-bit packages.
      Important: More recent versions of IBM Business Process Manager Standard and IBM WebSphere Application Server might be available when you use IBM Installation Manager to update these products. Updating these products to other versions might cause unexpected problems with IBM Stewardship Center.
  3. Start IBM BPM to complete the configuration of IBM Business Process Manager Standard.
    1. Start the Process Center.
    2. Click Start the Process Center Deployment Environment.
    3. Enter the cell credentials that you specified for the cell administrative account when you installed IBM BPM. The default user name is celladmin.
  4. Optional: If you plan to create your own IBM BPM process application with the Stewardship Center Application Toolkit, install IBM Process Designer, Version 8.5.
  5. Update the InfoSphere Information Server trust store with the IBM BPM SSL signer certificate.

    Follow the step that corresponds to your installation of IBM WebSphere Application Server to retrieve a signer certificate from IBM Business Process Manager Standard so that InfoSphere Information Server can notify IBM Business Process Manager Standard of new exceptions.

    IBM WebSphere Application Server Network Deployment
    Retrieve the signer certificate for the IBM WebSphere Application Server client trust store by doing these steps:
    1. Log in to the IBM WebSphere Application Server administrative console on the computer where you installed InfoSphere Information Server.
    2. Go to SSL certificate and key management > key stores and certificates > IISTrustStore > Signer certificates > Retrieve from port pane.
    3. Navigate to SSL certificate and key management > key stores and certificates > NodeDefaultTrustStore > Signer certificates > Retrieve from port pane.
    4. Specify the IBM Business Process Manager Standard host name and SSL port and then save the configuration.

    IBM WebSphere Application Server Liberty Profile
    Retrieve the signer certificate by running the UpdateSignerCerts command from the <IS_install_path>/ASBServer/bin directory on the computer where you installed InfoSphere Information Server.
    UpdateSignerCerts -ss -url https://<BPM_host_server>:<BPM_SSL_port>
    For example:
    In AIX, HP-UX, and Linux environments
    cd /opt/IBM/InformationServer/ASBServer/bin
    UpdateSignerCerts.sh -ss -url https://my_bpm_server:9444 -user isadmin -password my_pa55w0rd
    In Microsoft Windows environment
    cd C:\IBM\InformationServer\ASBServer\bin
    UpdateSignerCerts.bat -ss -url https://my_bpm_server:9444 -user isadmin -password my_pa55w0rd
  6. Update the IBM BPM trust store with the InfoSphere Information Server SSL signer certificate.

    On the computer where you installed IBM Business Process Manager Standard, complete the following steps to retrieve a signer certificate from InfoSphere Information Server so that IBM Business Process Manager Standard can connect to InfoSphere Information Server to retrieve details about exceptions. For more information, see Retrieve from port.

    1. Log in to the IBM WebSphere Application Server Network Deployment administrative console on the computer where you installed IBM Business Process Manager Standard.
    2. Go to SSL certificate and key management > Key stores and certificates > CellDefaultTrustStore > Signer certificates > Retrieve from port pane.
    3. Specify the InfoSphere Information Server host name and SSL port.
    4. Specify an alias to help you identify the signer certificate.
      For example, you might enter the host name of the computer where you installed InfoSphere Information Server.
    5. Save the configuration.
  7. If IBM InfoSphere Information Server and IBM Business Process Manager Standard are running on the same computer, specify a custom LTPA token name for IBM Business Process Manager Standard.

    Complete the following steps to specify a unique LTPA token name for IBM Business Process Manager Standard to prevent unexpected results with single sign-on (SSO) between IBM InfoSphere Information Server and IBM Business Process Manager Standard.

    1. Log in to the IBM WebSphere Application Server Network Deployment administrative console on the computer where you installed IBM Business Process Manager Standard.
    2. Click Security > Global security > Authentication > Web and SIP security > Single sign-on (SSO).
    3. In the LTPA V2 cookie name field, enter a token name other than LtpaToken2. For example, you might enter IISBPMLtpaToken2.
    4. Click OK.
    5. Click Save.
  8. Restart IBM Business Process Manager.
  9. Restart InfoSphere Information Server.