IBM BPM 8.5.x BPMConfig command line utility overview

Follow

BPMConfig command line utility allows you to perform a set of tasks -

  • create profiles
  • create DB scripts
  • create deployment environments
  • validate the configuration settings in an existing configuration properties file
  • start and stop the deployment environment

BPMConfig can be used instead of manageprofiles utility, profile management tool and deployment environment wizard.

Default location of BPMConfig utility is: WAS_HOME/bin/BPMConfig.bat (.sh)

BPMConfig syntax:

BPMConfig <action> <type> <propertiesFile>

<action>: -create, -validate, -start

<type>: -profile, -de, -sqlfiles

<propertiesFile>: properties file representing DE config

-create create the profiles and DE configuration for profiles that match installPath and hostName with the current machine.

-validate validates the that the specified properties file matches the existing DE configuration.

-start starts the DE within a given Deployment manager profile.

IMPORTANT NOTE: keep in mind that BPMConfig has to be executed on all servers that will participate in the deployment environment with the same property file and same syntax of BPMConfig command. Execute it on deployment manager server first and then on each server that has a managed node.

Properties files:

You may find sample properties file under: WAS_HOME\samples\config

You will find properties files separated by the name of the BPM edition (standard, advanced, express, etc). Files inside each folders are separated by: environment type (PC, PS, singlecluster, threecluster), and DB type.

Troubleshooting and understanding properties file better:

Log files can be found under:

install_root/logs/config/BPMConfig_time_stamp.log

How to examine properties file:

a) check those values first that are not supposed to be changed:

bpm.de.roleMapping.1.name=DeAdmin

bpm.cell.roleMapping.1.name=CellAdmin

bpm.de.db.1.roleMapping.1.name=DbUser

bpm.de.db.1.roleMapping.2.name=DbUserXAR

b) check values for properties with predefined values:

bpm.de.type Express, Standard, Advanced or AdvancedOnly
bpm.de.deferSchemaCreation true or false
bpm.de.environment Process Center or Process Server
bpm.de.cluster.[n].capabilities

Application, Support, Messaging

If this is a single cluster environment, specify all three:Application, Support and Messaging.

bpm.de.db.[n].type DB2, DB2zOS, Oracle or SQLServer
bpm.de.db.[n].dbCapabilities

For Advanced only configurations the options are: Messaging, BusinessSpace, CommonDB, BPC and CellScopedDB.
For Standard and Express configurations, the options are: Messaging, BusinessSpace, ProcessServer, EmbeddedECM and PDW.

 

c) some properties depend on other properties

Example:

Let's say you have defined an AppCluster and specified "values" for properties to indicate which databases this cluster will be using:

##########################################
# Cluster properties: BPM_TST.AppCluster #
##########################################
bpm.de.cluster.1.name=BPM_TST.AppCluster
bpm.de.cluster.1.capabilities=Application

...

bpm.de.cluster.1.db=ProcessServerDB,CommonDb,BSpaceDb,BPCDb

...

Now if you check rest of records in properties file you will see that each of the above databases/"values" is defined, for example:

#################################
# Database properties: BPCDb #
#################################
bpm.de.db.6.name=BPCDb
bpm.de.db.6.dbCapabilities=BPC
bpm.de.db.6.type=DB2
bpm.de.db.6.hostname=myhost.domain.com
bpm.de.db.6.portNumber=50000
bpm.de.db.6.databaseName=CMNDB
bpm.de.db.6.schema=bpcdb
bpm.de.db.6.sqlServerWinAuth=

So, this way you should be able to verify that the "values" represented in cluster properties are inline with values in database properties as we can see in above example.

d) It's always a good idea to visualize on a screen how you want your BPM environment to look like after you run BPMConfig. You may want to draw a picture of the cell, label all the host names and node names and cell name, decide on all the db names, and decide on all the users/pw before filling out a properties file.   You can also reverse-engineer a picture based on a filled out properties file. 

High-level example:

 

Additional tips:

When you migrate from BPM 8.0.x to BPM 8.5.x version you would have to run BPMConfig. Deployment Environment wizard cannot be used because you have to take care of 8.0.1 databases/schemas to 8.5.0.1 databases capabilities mapping (see more here). What you can do though to simplify the task of generating a properties file is to use DE wizard and run it through the final step and on final step say - generate properties file, save it on the filesystem and then click on Cancel button to cancel DE wizard set up. This way you would have a properties file that you can start with for your environment and make necessary changes based on the migration considerations.

Have more questions? Submit a request

Comments

Powered by Zendesk