Contents


Creating a stand-alone Process Center profile in IBM BPM, Part 2

Configure a profile for IBM Business Process Manager V8.5.7 on Linux platforms

Comments

Content series:

This content is part # of # in the series: Creating a stand-alone Process Center profile in IBM BPM, Part 2

Stay tuned for additional content in this series.

This content is part of the series:Creating a stand-alone Process Center profile in IBM BPM, Part 2

Stay tuned for additional content in this series.

If you want to simplify your IBM BPM environment, making it easier to use and maintain during your project's development, you might want to reduce the number of profiles that are installed and running and avoid installing Process Center in a network deployment environment. Follow the steps in this tutorial to configure a stand-alone Process Center for IBM BPM, which you can use for unit testing for process applications that are based on both Business Process Model and Notation (BPMN) and Business Process Model and Notation (BPEL), including process governance and artifact sharing.

Prior to version 8.5, IBM BPM supported a stand-alone Process Center profile, and it was provided as part of the typical installation option. In IBM BPM V8.5 Standard and Advanced, a typical installation now creates a single cluster network deployment Process Center profile. The stand-alone profile is now only provided with the IBM Integration Designer unit test environment installation and with IBM BPM Express.

All other installations create a network deployment environment. A network deployment environment is the only supported option for production environments, because it provides additional features such as capacity, availability, scalability, and failover support.

If there are developers on your team working remotely with memory-restricted laptops as their only resources, the number of Java™ processes running can be a problem. One way to overcome remote developer resource limitations, is to use one stand-alone profile that functions as both the Process Center server and Process Server unit test environment server for testing both BPMN and BPEL business process logic elements. It can store all business process artifacts and assets. One unified runtime environment can support both IBM Process Designer and IBM Integration Designer authoring tools. This configuration facilitates product evaluation and supported functionality validation. Also, it supports an isolated single user development environment.

This tutorial, Part 2 in a series, describes how to create and use a stand-alone Process Center and Process Server profile for IBM BPM Advanced, running on Linux V7.2 distributions. If are using a Windows operating system see Part 1.

Note: A stand-alone unified Process Center and Process Server profile, although is fully functional, is not officially supported.

What are the advantages of a stand-alone Process Center profile?

To review the advantages of a stand-alone Process Server profile in IBM BPM, see Part 1.

Additionally, creating a stand-alone Process Center profile for IBM BPM on Linux platforms (like Redhat and CentOS), with a running kernel release level of 3.10.0-327.10.1.el7.x86_64 on 64-bit platforms, has the following benefits and advantages:

  • Many enterprises are standardized on Redhat Linux for production workloads. These organizations typically use CentOS or Ubuntu or Scientific Linux distributions and Open Stack for pilot or prototype activities.
  • Linux skills are less costly and increasingly adopted.
  • You have lower costs of licenses and total cost of ownership.
  • You can capitalize on the latest capabilities of the Linux platform, such as virtualization (a kernel-based virtual machine), containerization (Linux and Docker), and lean cloud operating systems (Atomic, CoreOS).

Installation steps for creating a stand-alone Process Center profile

This tutorial describes how to enable the stand-alone Process Center profile for IBM BPM Advanced. This means there is a single stand-alone Process Center Profile to which Integration Designer can connect to deploy, test, and debug code.

Before you can create a stand-alone Process Center profile in IBM BPM, you must complete installation steps, including verifying your Linux installation and installing IBM BPM V8.5.7.

Verify your Linux installation

Before you create a stand-alone profile on your chosen Linux platform (Redhat or CentOS), you must complete the following basic platform setup:

  1. Verify that the platform meets the pre-requisites for an IBM BPM Advanced server installation, for example, CentOS Linux V7.2 for Intel X86_64 bit platform, as shown in Figure 1.
    Figure 1. Verifying the platform compatibility for an IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the platform                     compatibility for a IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the platform compatibility for a IBM BPM V8.5.7 Advanced installation
  2. Verify that platform resources are properly provisioned and tuned, as shown in Figure 2 and Figure 3.
    Figure 2. Verifying the provisioning of resources for an IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the provisioning of resources for an IBM BPM V8.5.7 Advanced                     installation
    Screen capture of verifying the provisioning of resources for an IBM BPM V8.5.7 Advanced installation
    Figure 3. Verifying the tuning of resources for an IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the tuning of resources for                             an IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the tuning of resources for an IBM BPM V8.5.7 Advanced installation
  3. Verify that the host name and the IP address are properly specified (either dynamically or statically), with full domain name qualification, as shown in Figure 4. The example in this tutorial uses an IPv4 address, but you can use either IPv4 or IPv6 addresses.
    Figure 4. Verifying the fully qualified host name and IP address for an IBM BPM V8.5.7 Advanced installation
    Screen capture of verifying the fully                             qualified host name and IP address for the IBM BPM V8.5.7 Advanced                             installation
    Screen capture of verifying the fully qualified host name and IP address for the IBM BPM V8.5.7 Advanced installation
  4. Verify that the user ID for the administrator account (bpmadmin in the examples in this tutorial) has root privileges, has the capability to set the user and group ownership attributes on files and directories recursively (chown -R), and has the capability to set the permissions attributes on files and directories recursively (chmod –R).

Install IBM BPM Advanced V8.5.7

Run the IBM BPM Advanced V8.5 installer and select the Custom installation option as shown in Figure 5. This option only installs the IBM BPM binary files. It does not create any profiles.

Figure 5. Install IBM BPM Advanced using the custom installation option
Install IBM BPM Advanced using the                     custom                     installation option
Install IBM BPM Advanced using the custom installation option

Step 1: Configure the BPMConfig.properties file

Go to the Download section and download the 857StandalonePC_Linux.zip, extract the files, and modify the 857_StandalonePC_bvperepa_Linux_Apr302016.properties file with changes to each of the properties that are described in the following steps. Change each property's value from "XXXX" to the values that are applicable to your environment. Also, make sure to review the contents of the entire properties file so you understand the specified values and their meaning.

  1. Set the deployment environment administrator user name and password that you want to use:
    bpm.de.authenticationAlias.1.user=XXXX [depladmin]
    bpm.de.authenticationAlias.1.password=XXXX [passw0rd]
  2. Set the user name and password for BPM_DB_ALIAS, as shown in the following example:
    bpm.de.authenticationAlias.3.user=XXXX [db2inst1]
    bpm.de.authenticationAlias.3.password=XXXX [db2passw0rd]

    This is the user name and password that was set when IBM DB2® Express was installed during the IBM BPM installation, or for the DB2 instance that you want to use.
  3. Set all the instances of the authentication alias association to the same user name that you used in the previous step, as shown in the following example:
    bpm.de.db.1.schema=XXXX [db2inst1]
    bpm.de.db.2.schema=XXXX [db2inst1]
    bpm.de.db.3.schema=XXXX [db2inst1]
    bpm.de.db.4.schema=XXXX [db2inst1]
  4. Set the server hostname to the host name of the computer that the server is installed on, as shown in the following example:
    bpm.de.node.1.hostname=XXXX [ibmbpm.ibm.com]

    A good practice is to avoid using localhost for a server host name because if you ever try to connect remotely to it from an Integration Designer installed on another computer, there can be publishing and connectivity problems.
  5. Set the IBM BPM Process Center installation path (for example, the default installation location is C:/IBM/BPM/v8.5), as shown in the following example:
    bpm.de.node.1.installPath=XXXX [/opt/IBM/WebSphere/AppServer]
  6. Optionally, edit the database host name and port numbers if necessary. In most cases, you keep the default localhost, port 50000.
  7. Save and close the properties file.

Step 2: Disable the validation

Locate /opt/IBM/WebSphere/AppServer/profileTemplates/BPM/BpmServer/actionRegistry.xml. Open it and comment out the following line:

<!-- validator path="../BpmDmgr/validators/productTypeValidator.ijc"/ -->

Save and close the actionRegistry.xml file.

Step 3: Create DB2 Express database scripts

Creating DB2 database scripts has the following advantages:

  • You can use the BPMConfig command in IBM BPM V8.5.7 to generate SQL script files. You can use this feature for migrations or new installations with automation.
  • IBM BPM installations require creating profile and deployment environments, which depend on databases and tables for storing persistent information as prerequisites. Databases must be created before tables.
  • The bpm.de.deferSchemaCreation property takes boolean values and controls the automatic creation of tables, if databases are already created.
  • The BPMConfig command, in coordination with the bpm.de.deferSchemaCreation property specification, has the following advantages:
    • Administrators can install IBM BPM in a flexible configuration, with database administration activities separated from middleware administration activities.
    • Migration tasks are easier.
    • You can automate installation and DevOps activities.

To create DB2 Express database scripts, complete the following steps:

  1. Log in to the administrator account, navigate to correct file location, and run the command shown in Figure 6. Then verify that DB2 Express script files are successfully generated.
    Figure 6. Example of running DB2 Express scripts for IBM BPM V8.5.7 Advanced
    Screen capture of running DB2 Express scripts for an IBM BPM V8.5.7 Advanced installation
    Screen capture of running DB2 Express scripts for an IBM BPM V8.5.7 Advanced installation
  2. Specify the correct user ownership, the group ownership attributes, and the file permissions on the generated script files, to prepare for running the files.
  3. Log in to the DB2 Express instance user account (db2inst1) and start the DB2 Express server, as shown in Figure 7.
    Figure 7. Starting the DB2 Express Server for IBM BPM V8.5.7 Advanced
    Screen capture of starting the DB2 Express Server                     for IBM BPM V8.5.7 Advanced
    Screen capture of starting the DB2 Express Server for IBM BPM V8.5.7 Advanced
  4. Run all the required DB2 Express scripts, as shown in Figure 8.
    Figure 8. Running DB2 Express Server scripts for IBM BPM V8.5.7 Advanced
    Screen capture of Running DB2 Express Server scripts for IBM BPM                     V8.5.7 Advanced
    Screen capture of Running DB2 Express Server scripts for IBM BPM V8.5.7 Advanced

Step 4: Create the stand-alone Process Center profile

Run the BPMConfig command, located in the /opt/IBM/WebSphere/AppServer/bin directory:BPMConfig -create –de ./857_StandalonePC_bvperepa_Linux_Apr302016.properties

It should look like the example in Figure 9:

Figure 9. Script to create a profile and deployment environment for an IBM BPM V8.5.7 Advanced installation
Screen capture of a script to create a profile                         and deployment environment for an IBM BPM V8.5.7 Advanced                         installaion
Screen capture of a script to create a profile and deployment environment for an IBM BPM V8.5.7 Advanced installaion

Figure 9 assumes that the properties file is in the install_root/bin directory. If it is not at that location, you can include the full path when you run the BPMConfig command.

To verify that the stand-alone Process Center profile was created, go to the profiles folder and check the IBM BPM server location for the folder named qbpmaps.

To learn how to configure IBM Integration Designer authoring tool to use the newly created stand-alone Process Server profile (which is running on a Process Center instance) follow the steps in Part 1.

Conclusion

You learned how a stand-alone Process Center profile in IBM BPM is useful for situations where memory and disk space are limited. Rather than install the Process Center as a network deployment environment with at least three profiles running, plus an additional profile to support the unit test environment server, you learned how to install a single profile that functions as both a Process Center Server and a unit test environment server.

In this Part 2, you learned steps specifically for a Linux environment. Now you can use what you learned in your own environment.

Acknowledgments

The authors would like to thank Erich Fussi from the IBM Boeblingen Lab development team for providing the technical details, and Brian Petrini from the IBM BPM product management team for his leadership and support. The authors would also like to thank Tom Scott from the Hybrid Cloud Technical Sales Team for his review.


Downloadable resources


Related topics


Comments

Sign in or register to add and subscribe to comments.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Middleware
ArticleID=1033283
ArticleTitle=Creating a stand-alone Process Center profile in IBM BPM, Part 2: Configure a profile for IBM Business Process Manager V8.5.7 on Linux platforms
publish-date=06132016