Exporting SIB messages and applications from the source environment

Take a snapshot of your source environment to export the service integration bus (SIB) messages and advanced IBM® BPM applications. You will import the messages and applications to the target environment in a later step. You need one snapshot for each deployment environment in your source cell. You do not need a separate snapshot for each profile in your source cell.

Figure 1. Sample environment after the source is shut down for migration. The source environment can still read from the databases but can no longer write to them. The target is not running but contains a deployment environment.

The details of the diagram are provided in the figure caption.

Before you begin

If the source environment is a network deployment environment, ensure that the deployment manager, node agent, and clusters have been started. If the source environment is a stand-alone environment, ensure that the stand-alone server has been started.

About this task

Run the BPMExtractSourceInformation utility to export the SIB messages and advanced applications from your previous environment so that you can later import them into your new environment.

Important: If you decide to make configuration changes to the source environment based on your configuration in the new installation, remember that you must run the utility again to take a new snapshot.

Procedure

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

Take a snapshot of the source environment to export the SIB messages and IBM Business Process Manager advanced applications
- 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\BPMExtractSourceInformation.bat -backupFolder snapshot_folder -propertiesFile source_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\BPMExtractSourceInformation.bat -backupFolder snapshot_folder -propertiesFile source_migration_properties_file
```
where:
- snapshot_folder is the directory where the exported information is stored.
- source_migration_properties_file is the full path to the migration properties file in which you specified the configuration information for the source environment. Put double quotation marks around the value if there are spaces. For example:
```
BPMExtractSourceInformation.bat -backupFolder c:\snapshot -propertiesFile "C:\bpm 85\util\migration\resources\source_migration.properties"
```
You can follow the progress of the command by reading the output, which includes the following actions:
- Taking a snapshot of the SIB messages
- Taking a snapshot of the applications
- Exporting business level applications (BLAs)
- Querying the deployment configuration for the adapters
After the command has completed successfully, you see a message similar to the following message:
```
CWMCO1002I: All steps of the snapshot completed successfully.
```
The log location is listed in the output. If there are any errors or exceptions, they appear in the log. If you have errors and need to rerun this step, you must remove all contents from the directory you identified with the -backupFolder parameter in the command.
Shut down the source environment before you proceed with the migration. If you have a network deployment environment:
1. Stop the clusters.
2. Stop the nodes.
3. Stop the deployment manager.

Results

Depending on your environment, you might see some of the following folders under your snapshot_folder/cell_name:

Table 1. Contents of snapshot folder
Folder	Contents
Adapters	Adapter configurations at the application level
Applications	WebSphere® Application Server applications and `HTM_PredefinedTask` system applications
BLAs and CompositionUnits	Assets used by business-level applications
Messages	Service integration bus (SIB) messages that have not yet been processed in the source environment