Sunday, 22 March 2015

Getting to grips with the IBM BPM Configuration Editor

The IBM BPM Configuration editor is a browser-based interface for configuring your new deployment environment. You can graphically edit the configuration properties file that was exported from your source environment by the BPMConfig -migrate command. After you modify the properties file in the editor, you can use the BPMConfig -create command to create a new deployment environment that is based on the modified file.

I used this as source: -


The tool is pre-packaged with BPM 8.5.5 and 8.5.6 ( I'm actually using 8.5.6 ), so it's a simple thing to configure: -

Create a directory into which to place the Editor

mkdir BPMConfigurationEditor

Change to that directory

cd BPMConfigurationEditor

Extract the bundled Editor

unzip /opt/IBM/WebSphere/AppServer/BPM/config/ui/BPMConfigurationEditor.zip

Edit the configuration file

vi configEditor.ini

Add/amend the JAVA_HOME variable

JAVA_HOME=/opt/IBM/WebSphere/AppServer/java

Set the executable bit on the script

chmod +x configEditor.sh

Export the current BPM Deployment Environment

/opt/IBM/WebSphere/AppServer/bin/BPMConfig.sh -export -profile Dmgr01 -de De1 -outputDir /tmp

This results in a number of files: -

-rw-r--r--   1 wasadmin wasadmins  1610 Mar 22 19:38 ltpa.jceks
-rw-r--r--   1 wasadmin wasadmins  1639 Mar 22 19:38 fileRegistry.xml
-rw-r--r--   1 wasadmin wasadmins 13782 Mar 22 19:38 resources-bpc.xml
-rw-r--r--   1 wasadmin wasadmins  7540 Mar 22 19:38 Application-config-bpc.xml
-rw-r--r--   1 wasadmin wasadmins  2621 Mar 22 19:38 ProcessServer_100SourceCustomMerged.xml
-rw-r--r--   1 wasadmin wasadmins  1356 Mar 22 19:38 PDW_100SourceCustomMerged.xml
-rw-r--r--   1 wasadmin wasadmins 84515 Mar 22 19:38 De1.properties


The one in which we are interesting is De1.properties.

Start the editor

Note that this only works against localhost, so one either needs to ensure that a GUI is available on the target server, or pul the De1.properties file back to a client workstation

./configEditor.sh

This returns: -

The configuration editor allows only local access. Specify http://localhost:<port_number>/ibm/bpm/configEditor on the computer where the configuration editor is installed.

and also auto-starts a browser on the target host: -


From here, one can import the required De1.properties file, and then click Open Editor




This gives one the ability to see and, if needed, modify the configuration.

I assume that the updated configuration file could then be saved, and imported back into BPM, perhaps using BPMConfig.sh -update but that's something for another day ....

No comments: