Completing configuration for IBM Business Process Manager

After migration, you must check and possibly change some configuration settings.

Figure 1. Sample environment after the target is started. The source environment is not running. The target can read from the databases.

Perform the following tasks, if applicable to your environment:

1. If you changed properties in certain XML files in the source environment, you must apply the same changes to the same files in the target environment. The following files must be updated manually:
   • 00static.xml
   • 50AppServer.xml
   • 60Database.xml
   • 80EventManager.xml
   • 98Database.xml
   • 99Local.xml
   • 99Sharepoint.xml

   The files are in deployment_manager_profile/config/cell_name/nodes/node_name/servers/server_name/process-center or process-server/config/system.

   Note: Some properties might be missing in the target XML file if they belong to the set that has been moved to the WebSphere® Application Server configuration files. Use the WebSphere command-line administration tool (wsadmin) AdminConfig commands to update the values in the target environment. Refer to Security configuration properties for a list of the properties that have been moved to WebSphere Application Server configuration files.
2. If you customized the search variables in the source environment, you must apply the same customization in the target environment. For instructions, see "Setting the location of the index" in Configuring the Process Portal index.
3. Apply the user-to-role mappings and the RunAs role user assignments for the IBM® Business Process Manager system applications to match the source environment. The following system applications must be analyzed:
   • IBM_BPM_PerformanceDW
   See IBM Business Process Manager roles and Defining RunAs roles user assignments for system applications.
4. Make required changes to your applications.
   1. Some authentication aliases have been removed from IBM BPM V8.5.6. If your applications are using aliases that have been removed, you must re-create them manually in the target environment. See Default users and authentication aliases removed from IBM Business Process Manager V8.5.
   2. As mentioned in the premigration steps, if your applications reply on specific WebSphere Application Server configuration, the applications might fail to start or fail to work correctly in V8.5.6 unless you re-create any required resources in the target environment. These include the following resources:
      • JMS configurations
      • Schedulers
      • Environment variables
      • Shared library configurations
      • Work Manager
5. If you migrated from a version earlier than V8.0, be aware that authorization for actions on processes and tasks now gets enforced correctly in cases where it was not enforced previously. Before V8.0, if you use the Expose to start setting in a business process definition (BPD) to restrict who can start a process, this setting was ignored, and anyone could start a process. If you want to retain this behavior in V8.5.6, you must create a new version of your process, and change the Expose to start setting so that all users can start the process.
6. If you subscribed to Blueworks Live processes in previous releases, the tags on the process in Process Designer are labeled Blueprint. In V8.5.6, Blueworks Live processes that are subscribed to are tagged Blueworks Live. In Process Designer, you can right-click the process and change the tag.
7. If you have customized data sources in the source environment, check the custom properties on the data sources and if necessary apply the same properties to the target environment. The following data sources must be analyzed:
   • jdbc/MEDB or jdbc/messaging_engine_database_name
8. Re-create external data sources. The migration utility does not migrate extra data sources. If your applications depend on data sources that you added in the source environment, you must re-create them in the target environment using the same configuration as the source. For instructions, see Configuring a data source using the administrative console in the WebSphere Application Server Information Center.
9. Restructure disorganized database tables and update database statistics. See the documentation that came with your specific database.
   Tip: For DB2, you can use the reorgchk utility to find disorganized tables and indexes. If the tool suggest a reorganization, run the reorg utility. After the reorganization, run the runstats utility to reflect the reorganized tables and indexes in the optimizer statistics. You can update statistics manually by using the following command: runstats on table schema_table on all columns with distribution and detailed indexes all
10. Using the administrative console, manually update any hard-coded port numbers or IP addresses in your applications according to the new settings. Because the target version recreates the topology, the port numbers and IP addresses might not be the same as in the source version. From the administrative console, click Servers > WebSphere application servers > Server_Name > Communications > Ports > Detail. For additional information, refer to the WebSphere Application Server Information Center.
11. Required: If you are migrating from a deployment environment using LDAP, you must configure LDAP with the same settings in the target environment. See Configuring the user registry.
    Note: If you are using a federated repository and an unencrypted LDAP connection in the source environment, the LDAP settings are migrated automatically and you can skip this step. If you configured any LDAP repository additional properties or LDAP attributes, you must customize them to be the same as before.
12. Expose the My Performance, My Team Performance, My SLA Overview, and Ad-Hoc Reports dashboards. These dashboards are not exposed in V8.5.
    1. To expose the My performance, My Team Performance, and My SLA Overview dashboards, complete the following steps:
       1. Download Process Designer from the V8.5 Process Center and install it.
       2. In Process Designer, open Process Portal in the designer. Click All of Process Portal, and find ScoreBoards.
       3. Enable the My performance, My Team Performance, and My SLA Overview dashboards under ScoreBoards.
    2. To expose the Ad Hoc Reports dashboard, complete the steps in Exposing the Ad Hoc Reports dashboard.
13. Apply the same proxy or HTTP server configurations that were present in your source environment, and also update the virtual host configuration as needed. See the WebSphere Application Server documentation for information about Setting up the proxy server and Configuring virtual hosts.

    If you have any related customization in 100Custom.xml files, such as URL prefixes, they are automatically migrated to the IBM BPM virtual host during migration. See Security configuration properties for more information.

14. If you used the exportWASConfig.py script to export customized WebSphere Application Server configuration, you can use the importWASConfig.py script to import the customized configuration to the target environment.