Migrating the configuration from the source environment

Migrate the configuration information from your source environment so that you can start with the same configuration when you create your target environment. Later, you will use the IBM BPM Configuration editor to configure the environment that you want.

Figure 1. Sample environment after V8.5.6 is installed on the target and BPMConfig -migrate is run. The output folder is being copied to the target environment. 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.

For each deployment environment in your source environment, complete the following steps:

1. Migrate the configuration information from your source environment and generate the properties file.
   • Network deployment 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:

       install_root_8.5/bin/BPMConfig -migrate -wasHome source_installation_directory -profile profile_name [-de deployment_environment_name] [-useRecommendedSettings] -outputDir path_to_configuration_folder

     • 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 in the source environment on the computer where the deployment manager is deployed:

       remote_migration_utility/bin/BPMConfig -migrate -wasHome source_installation_directory -profile profile_name [-de deployment_environment_name] [-useRecommendedSettings] -outputDir path_to_configuration_folder

   • Stand-alone 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:

       install_root_8.5/bin/BPMConfig -migrate -wasHome source_installation_directory -profile profile_name [-useRecommendedSettings] -outputDir path_to_configuration_folder

     • 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 in the source environment on the computer where the stand-alone server is deployed:

       remote_migration_utility/bin/BPMConfig -migrate -wasHome source_installation_directory -profile profile_name [-useRecommendedSettings] -outputDir path_to_configuration_folder

   where:
   • source_installation_directory is the full path to the previous installation in the source environment.
   • profile_name is the name of the deployment manager or stand-alone profile.
   • deployment_environment_name is an optional parameter for the name of the deployment environment, which you can find in the administrative console. If you cannot find it, omit this parameter. Do not use this parameter if you are migrating from a stand-alone environment. In IBM® BPM 8.5.0.0 or later, you can only use the following characters in a deployment environment name:
     • a - z
     • A - Z
     • 0 - 9
     • ! ( ) - . ? [ ] _ ` ~ \ /
     If you migrate a pre-8.5.0.0 deployment environment to IBM BPM 8.5.0.0 or later, you must ensure that the name of the new deployment environment only uses permitted characters. Although you can export a pre-8.5.0.0 deployment environment that has unpermitted characters in the name, you will need to rename the deployment environment when you use the BPMConfig command to create the new deployment environment. If the new deployment environment name contains unpermitted characters, you may receive an error message that is similar to the following message:

     message:com.ibm.bpm.config.model.ConfigModelFactory validateConfigModel
      CWMCB0368E:  bpm.de.name has an invalid value invalid_value

   • -useRecommendedSettings is an optional parameter to add if you want to use the recommended values for the performance tuning properties after migration, instead of using the values from the source environment. For performance tuning properties, such as the JVM heap size or thread pool configuration, the command compares the source value with the recommended value. If the source value is smaller, the recommended value is added to the properties file instead.
   • path_to_configuration_folder is the full path to the folder where you want to put the configuration files.
     Tip: If you are running this command more than once because you have more than one deployment environment, remember to specify different output folders.
   Note: If you receive an SSL Signer Exchange Prompt message while running this command, click Y to add the signer to the truststore.
   For example:

   BPMConfig.sh -migrate -wasHome /opt/WPS700/ -profile Dmgr01 -de PSDE -outputDir /home/user_name/750configuration

   You are prompted for some information about the target environment you want, such as the topology, whether to use multiple buses, and the number of nodes. After the command finishes successfully, you see information similar to the following information:

   Logging to file path_to_log_file.
   
   Initializing context for export...
   You are using BPMConfig to migrate from product version to IBM BPM 8.5.6.0.
   
   Choose the deployment environment type for the target environment:
   1. AdvancedOnly
   2. Advanced
   Input option number: 2
   
   Choose the topology for the target environment:
   1. Single Cluster
   2. Three Clusters
   Input option number: 2
   
   Input the node number for the target environment: 1
   
   Choose the bus option for the target environment:
   1. Single Bus
   2. Multiple Buses
   Input option number: 2
   
   Exporting security information...
   Exporting data source information...
   Exporting WebSphere Lombardi XML information...
   Exporting performance tuning parameters...
   
   The command completed successfully.

2. Copy the output folder to the target environment. The output folder contains files similar to the following files:

   Table 1. Files for migration

   Sample name	Description
   DE1-AdvancedOnly-ThreeClusters-DB2-MultiBus.properties	The properties file containing the configuration information from your source environment. You will use this file when you configure the target environment. You can see a list of the properties in the Configuration properties for the BPMConfig command topic.
   fileRegistry.xml	If you use a file-based user registry, the user registry file is copied from the source environment to be migrated to the target environment.
   ltpa.jceks	If you use Lightweight Third-Party Authentication (LTPA), the LTPA key file is copied from the source environment to be migrated 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 be migrated to the target environment.
   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 be migrated to 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 be migrated to the target environment.

   Security notes:

   • Some XML security configuration properties are moved to the WebSphere® Application Server configuration files automatically. These properties are exported to the properties file and will be moved to the WebSphere Application Server configuration files when you run BPMConfig -create. Refer to Security configuration properties for a list of the properties that have been moved.
   • The SCA_Auth_Alias will be migrated from the source to the target and will use the primary administrator as the user name by default.