You can export the configuration properties from two different V8.5.6 deployment
environments and compare them, using your own comparison tools, to
understand the difference between two IBM® Business Process Manager systems.
You can also compare against V8.5.5 configurations, but you must take
into account that the more recent version extracts more properties
than the previous version.
About this task
You might perform this task to make sure that your IBM BPM configurations
are consistently configured between systems, or to find the differences.
Export a representation of Process Server configuration data and use
your own tools to compare the exported files.
The following
properties are exported:
- Cell and deployment environment configuration properties
- Deployment manager and managed node configuration properties
- Cluster and cluster member configuration properties
- Database, data source, and JDBC provider configuration properties
- Authentication alias and role mapping configuration properties
- LDAP configuration properties
- Deployment environment and Process Portal context root prefix
(if set in the current deployment environment)
- Business Process Choreographer customization properties
- Additional performance-tuning configuration properties
Procedure
To compare configuration properties between two deployment
environments, complete the following steps:
- Run the BPMConfig –export command
to extract the configuration data from each IBM BPM deployment
environment.
For example:
- BPMConfig.sh -export -profile
DmgrProfile -de DeploymentEnvironment1 -outputDir /home/user_name/DE1ConfigFolder
- BPMConfig.bat -export -profile
DmgrProfile -de DeploymentEnvironment1 -outputDir C:\DE1ConfigFolder
Important: Specify a different output directory for
each deployment environment. In the case where a cell has multiple
deployment environments, a unique output directory is required for
each deployment environment.
Table 1. Configuration files for each deployment
environmentSample name |
Description |
de_name.properties |
This properties file contains the configuration
information from your source environment. You use this file when you
configure the target environment. For more information, see the reference
topic about configuration properties for the BPMConfig command. |
fileRegistry.xml |
If you use a file-based user registry, the user
registry file is copied from the source environment to be added to
the target environment. |
ltpa.jceks |
If you use LTPA, the LTPA key file is copied
from the source environment to be added to the target environment. |
ldap_additional_properties.xml |
If you use a federated repository and an unencrypted LDAP connection in the
source environment, additional properties of the LDAP server are copied from the source environment
to the output directory, where they are later used automatically to create the target
environment. Restriction: If you extend the federated repository to use a custom login
property (such as userPrincipalName) in addition to the default
uid property in the source environment, LDAP is not configured for the target
environment, with the following warning: CWMCB0600W: LDAP could not be configured! You may
configure LDAP separately after BPMConfig has terminated successfully. If you see this
warning, manually configure LDAP with the login properties you want to use after the migration is
complete.
|
Application-config-bpc.xml and resources-bpc.xml |
If you have Business Process Choreographer configured
in the source environment, the configuration files are copied from
the source environment to the output directory, where they are later
used automatically to create the target environment. |
Support-config-bpc.xml |
If you have Business Process Choreographer Archive
Manager configured on the support cluster in the source environment,
the configuration is copied from the source environment to the output
directory, where it is later used automatically to create the target
environment. |
- Use your comparison tools to compare the differences between
the extracted configuration files for each deployment environment.
Tip: Use comparison tools for comparing these files,
because most of them are not intended to be human-readable.
- To compare XML files: If the XML files are very different, you
might first want to sort all XML elements and attributes based on
your needs using a tool, for example, XML Sorter. Then, using a comparison
tool, for example, Pretty Diff, Altova DiffDog, or Stylus Studio XML
Editor, compare the extracted XML files for each deployment environment.
- To compare properties files: Use a comparison tool, for example,
Beyond Compare, Compare Suite, or Compare++, to compare the extracted
configuration files for each deployment environment.
- The ltpa.jceks file is a binary file for
LTPA keys and you cannot compare the contents.
.
What to do next
In addition to the information exported by the
BPMConfig –export command,
you can use the
exportWASConfig.py script to export
other
WebSphere® Application
Server configuration
to refer to when you create a new deployment environment. This script
exports customized
WebSphere Application
Server configuration
such as data sources, authentication aliases, and Secure Sockets Layer
(SSL) settings.