Creating and configuring the test environment profile using BPMConfig

You can use the BPMConfig command to create and configure the profile for the IBM® Process Server test environment using a properties file that contains all of the values required for the profile settings.

Before you begin

You must have installed IBM Integration Designer and the test environment silently using the command line or response file.

Ensure that the DB2 command line environment can be successfully invoked.

To check, run db2cmd from the command prompt. This should open a DB2 command line interface.
To check, run db2 from the terminal. This should identify the DB2 command location.

Regardless of whether you are an administrative or non-administrative user or a root or non-root user, you must be authorized to create and drop databases. To obtain the required authority for creating and dropping databases, perform the following task:

Add the user to the DB2ADMNS group. For more information about how to add a user to the group, see Adding your user ID to the DB2ADMNS and DB2USERS user groups (Windows)
Add the user to the DB2 instance user's primary group. For more information about how to add a user to the group, see Creating group and user IDs for a DB2 database installation (Linux and UNIX)

About this task

When run with the -create -de options, the BPMConfig command performs the following tasks:

Creates a standalone profile for the IBM Process Server test environment
Configures the test environment profile

Procedure

To create and configure the profile for the IBM Process Server test environment, complete the following steps:

On the system where you want to create the test environment profile, locate the sample properties file Advanced-PS-Standalone-DB2.properties at the following path:
extract_directory/launchpad/content/samples/config/iid

extract_directory\launchpad\content\samples\config\iid
Create a copy of the above sample properties file.

Modify your version of the properties file so that the values correspond to your own configuration. To create the test environment profile for IBM Integration Designer, clear out or update the default variable values assigned to the required properties.

Table 1. BPMConfig command properties that must be set.
The following table lists the properties and the values that you must set:
Configuration properties	Values to set
`bpm.de.psProcessCenterHostname bpm.de.psProcessCenterPort`	The Process Server test environment is an offline server configuration. Clear the default values `@PS_PC_HOSTNAME@` and `@PS_PC_PORT@` specified for the host name and port number.
`bpm.de.authenticationAlias.1.name= DeAdminAlias bpm.de.authenticationAlias.1.user bpm.de.authenticationAlias.1.password`	Retain the default value `DeAdminAlias` for authentication alias for the test environment administrator. See IBM Business Process Manager roles for more information about the roles. If you change the value for `bpm.de.authenticationAlias.1.alias` from the default `DeAdminAlias`, you must update it everywhere that references that alias, for example `bpm.de.roleMapping.#.alias` Specify custom user name and password for the authentication alias for the test environment administrator.
`bpm.de.authenticationAlias.2.name= ProcessCenterUserAlias bpm.de.authenticationAlias.2.user bpm.de.authenticationAlias.2.password`	The Process Server test environment is an offline server configuration. Clear the default values specified for the user name and password for the `ProcessCenterUserAlias` authentication alias.
`bpm.de.authenticationAlias.3.name= BPM_DB_ALIAS bpm.de.authenticationAlias.3.user bpm.de.authenticationAlias.3.password`	Retain the default value `BPM_DB_ALIAS` for authentication alias for the database instance. Specify custom user name and password for the authentication alias for the database user.
`bpm.cell.authenticationAlias.1.name= CellAdminAlias bpm.cell.authenticationAlias.1.user bpm.cell.authenticationAlias.1.password`	Retain the default value `CellAdminAlias` for authentication alias for the cell. See IBM Business Process Manager roles for more information about the roles. Specify custom user name and password for the authentication alias for the cell administrator.
`bpm.de.node.1.hostname bpm.de.node.1.installPath bpm.de.node.1.profileName`	Update the default value `@INSTALL_HOSTNAME@` to specify the host name of the computer where the product is installed. Update the default value `@INSTALL_PATH@` to specify the installation path of the test environment. Update the default value `@SERVER_PROFILE_NAME@` for the profile name to `qbpmps`.
`bpm.de.db.1.hostname bpm.de.db.1.portNumber bpm.de.db.1.schema`	Update the default value `@DB_HOSTNAME@` to specify the host name of the database. Update the default value `@DB_PORTNUMBER@` to specify the port number of the DB2 service. Update the default value `@DB_SCHEMA@` to specify the user name for the DB2 database in CAPITAL letters.
`bpm.de.db.1.databaseName bpm.de.db.2.databaseName bpm.de.db.3.databaseName`	Update the default value `@CMN_DB_NAME@` for the Common database to `QCMNDB`. Update the default value `@PS_DB_NAME@` for the Process database to `QBPMDB`. Update the default value `@PDW_DB_NAME@` for the Performance Data Warehouse database to `QPDWDB`.

For more information about the BPMConfig command properties, read the comments in the sample files, or see the sample property file descriptions in Configuration properties for the BPMConfig command.

Add the property bpm.de.createDatabase in the properties file and set its value set to true.

Run the BPMConfig command passing it the name of the properties file you created. For example: For Linux operating system

BPM_home/bin/BPMConfig -create -de my_environment.properties

BPM_home\bin\BPMConfig -create -de my_environment.properties

What to do next

Create a copy of the updated properties file, rename this copied version to Standalone.properties, and place this file at the location <WTE_HOME>/properties/wte. This ensures that the Server Reset feature in Integration Designer functions properly.

After you have created test environment profile, you can start the test profile by running the BPMconfig command with the -start action.