Optionally,
extract the data source information from your source environment so
that you can make the same changes in the new version while you create
the deployment environment. Using this information ensures that you
can access the previous databases from your new deployment environment.
Figure 1. Sample environment after V8.5 is installed
on the target. The source environment is running and transferring
data to and from its databases. The target has been created but does
not contain a deployment environment.
Before you begin
If the source
environment is a network deployment environment, ensure that the deployment
manager has been started. If the source environment is a stand-alone
environment, ensure that the stand-alone server has been started.
Important: In V8.5.0, database and security
properties were moved from the
99Local.xml and
100Custom.xml configuration
files to the
WebSphere® Application
Server configuration
files. These properties are no longer configurable using the
99Local.xml and
100Custom.xml configuration
files. If you modified properties in the configuration files in the
source environment, the customized properties are automatically moved
to the
WebSphere Application
Server configuration
files during migration. You can view your customizations in the
100SourceCustomMerged.xml file,
which is located in
snapshot_folder/cell_name/Configurations.
When you run
BPMMigrate, these properties are commented
out in the
100SourceCustomMerged.xml file and
moved to the
WebSphere Application
Server configuration
files. For the details, see
Security
configuration properties.
About this task
Run the BPMExtractDBConfiguration utility
to extract the data source information, such as host name and database
type, from your source environment.
Procedure
For each deployment environment in your
source environment, complete the following steps:
- Update the migration properties file
with the configuration information for the source environment. Check all the properties and edit them
if required, following the instructions in the file.
- If you installed the new version of the product on the same computer
as the source environment, the file is found in BPM_home_8.5\util\migration\resources\migration.properties
- If you installed the new version of the product on a different
computer and copied the migration files to the source environment,
the file is found in remote_migration_utility\util\migration\resources\migration.properties.
- Optional: Update other configuration
files in the BPM_home_8.5\util\migration\resources directory,
following the instructions in the files.
- Update the logging.properties file to specify
where information is logged during the extraction process.
- Update the soap.client.props file to change
the com.ibm.SOAP.requestTimeout property if the SOAP
invocation is timing out at the current setting.
- Update the ssl.client.props file to change
the keystore and truststore.
Do not update any of the other files.
- Extract the database configuration from
the source environment.
- If you installed the new version of the product on the same computer
as the source environment, run the following command in the target
environment:
BPM_home_8.5\bin\BPMExtractDBConfiguration.bat -output output_properties_file -propertiesFile migration_properties_file
- If you installed the new version of the product on a different
computer and copied the migration files to the source environment,
run the following command on the source computer:
remote_migration_utility\bin\BPMExtractDBConfiguration.bat -output output_properties_file -propertiesFile migration_properties_file
where:- output_properties_file is the file name, including
the full path, for the database configuration information. The properties
are extracted into this file as name-value pairs. Make sure that the
file does not already exist.
Tip: If you are running this
command more than once because you have more than one deployment environment,
remember to specify different output file names.
- migration_properties_file is the full path
to the migration properties file in which you specified the configuration
information for the source environment (the file that you updated
in Step 1). Put double quotation marks around the value if there are
spaces. For example:
BPMExtractDBConfiguration.bat -output c:\output_property_file -propertiesFile "C:\bpm 85\util\migration\resources\migration.properties"
Note: If you receive an SSL Signer Exchange Prompt message
while running this command, click Y to add
the signer to the truststore.
If you installed the new version
of the product on the same computer as the source environment, the
log file is in BPM_home_8.5\logs\migration. If
you installed the new version of the product on a different computer
and copied the migration files to the source environment, the file
is in remote_migration_utility\logs\migration.
Results
You can look in the file to see what data source information
is extracted. You will use this information when you configure your IBM Business Process Manager V8.5 target
deployment environment in the next step.