Example: migration.properties values for an IBM Business Process Manager for z/OS V8.0.1.1 to V8.5 migration

Before you run any of the migration commands in the source or target environment, you must edit the supplied migration.properties file. The following example shows the completed values for a migration.properties file that provides input to the migration scripts that are run against an IBM® Business Process Manager for z/OS® V8.0.1.1 installation in the source environment, and an IBM Business Process Manager for z/OS V8.5 installation in the target environment.

Each deployment environment requires its own migration.properties file, so use unique and meaningful file names for ease of identification; for example, migration.<sourceDEname><version>.properties.

The migration.properties file is formed of name-value pairs and contains comments to help you complete the values of the properties.

Source environment values in migration.properties

When used in the V8.0.1.1 source environment, the properties that relate to the source environment are completed with specific or default values, and the properties that relate to the target environment are left unspecified.

A few notes about the properties:

The bpm.home property points to the WAS_HOME location of the deployment manager profile in the source environment.
The profile.name value is set to default, which is always the name of the z/OS profile.
Because the default topology on z/OS is a single cluster, the source.application.cluster.name, source.support.cluster.name, source.messaging.cluster.name, and source.web.cluster.name properties are all assigned the same cluster name.
The target.config.property.file and source.product.version properties are required for the target environment only, so the values are left blank.

The following example shows a completed migration.properties file for the source environment.

...
admin.username=wsadmin
admin.password=admn4was

bpm.home=/WebSphere/V8T1DM/DeploymentManager
profile.name=default

#Input these properties when you're working on source or target environment
source.application.cluster.name=WCLT1Z1
source.support.cluster.name=WCLT1Z1
source.messaging.cluster.name=WCLT1Z1
source.web.cluster.name=WCLT1Z1
#Input these properties when you're working on target environment
target.config.property.file=
source.product.version=

ltpa.password=WebAS
product.type=BPMAdvanced

skip.steps.list=

Target environment values in migration.properties

When used in the V8.5 target environment, the properties that relate to the target environment are completed with specific or default values.

A few notes about the properties:

The bpm.home property points to the WAS_HOME location of the deployment manager profile in the target environment.
The profile.name value is set to default, which is always the name of the z/OS profile.
The source.application.cluster.name, source.support.cluster.name, source.messaging.cluster.name, and source.web.cluster.name properties are all assigned the same value, which is the name of the single cluster in the source environment.
The target.config.property.file property identifies the full path to the BPMConfig properties file that was used to create the target deployment environment.
The source.product.version property identifies the IBM Business Process Manager for z/OS version in the source environment.

The following example shows a completed migration.properties file for the target environment.

...
admin.username=wsadmin
admin.password=admn4was

bpm.home=/WebSphere/V85T1DM/DeploymentManager
profile.name=default

#Input these properties when you're working on source or target environment
source.application.cluster.name=WCLT1Z1
source.support.cluster.name=WCLT1Z1
source.messaging.cluster.name=WCLT1Z1
source.web.cluster.name=WCLT1Z1
#Input these properties when you're working on target environment
target.config.property.file=/u/working_dir/v85/migration/bpmconfig.T1.properties
source.product.version=8.0.1.1


ltpa.password=WebAS
product.type=BPMAdvanced


skip.steps.list=