Migrate Processes Design-Time Metadata into Oracle Integration

As an administrator, you can import your Processes design-time metadata (process applications and decision models) into Oracle Integration. The import tool provides migration flexibility: choose to migrate the entire instance, a selected space, or individual items.

• Import Processes Design-Time Metadata into Oracle Integration
• Import Using the Import Command Line Utility

Import Processes Design-Time Metadata into Oracle Integration

Use the Process import tool to automatically move Process and decision design-time metadata from one instance to another. The tool moves process applications and active decision models from a selected source (an Oracle Integration instance) to a selected Oracle Integration destination, and activates the decision models.

Alternatively, you can import process applications and decision models from the command line instead of the user interface. See Import Using the Import Command Line Utility. Note that using the import tool is highly recommended.

Important:

You can specify an import scope, which allows you to import all Process assets for an instance, for a space, or a specific process application or decision model. Be sure not to import assets more than once, because doing so can lead to unpredictable results. Avoid refreshing or closing the tool during the import.

1. On the Oracle Integration Home page, click Processes in the navigation pane.
2. Click Settings in the navigation pane, then Import from the top options on the Administration page.
3. On the Import Administration page, specify a source for the import.
   1. In the Identify the instance to import from fields, choose an Oracle Integration instance.
   2. In the Host Name field, enter the host, using the format https://host:port.
   3. Enter a user name and password to sign in to the instance as an administrator.
4. Identify a destination for the import.
   • To import to your current instance, skip the Import to the current Oracle Integration instance field.
   • To import to another Oracle Integration instance than your current instance, click Edit and complete the host, user name, and password fields for the instance you want to import to.
   • To select importing to the current instance, click Reset.
5. In the Scope field, identify what you want to import.
   • Choose Entire Instance to import all process applications and decision models from all spaces located on the instance.
   • Choose Space to import a selected source only. Select the space in the Source Space field that displays.
   • Choose Process Application or Decision Model to import a selected application or decision model only. In the additional fields that display, select the source space, process application or decision model to import, and the destination space.
6. Click Import.
7. Review the import log.

   Note:

   You must check the logs and make sure there are no errors before proceeding with post migration steps.

   Click Download Import Log in the import dialog to download a zip file containing the import log. It lists any errors that might have occurred along with a summary of the number of spaces or items (process applications or decision models) imported.

8. In Oracle Integration, change space settings as needed.
   Return to the design-time Administration screen, and share the space(s) you migrated to Oracle Integration and change their permissions.

Import Using the Import Command Line Utility

Optionally, use an import command line to automatically move Process and decision design-time metadata from one instance to another instead of the user interface. (The user interface tool is recommended.)

The utility moves process applications and active decision models from a selected source (an Oracle Integration instance) to a selected Oracle Integration destination, and activates the decision models.

Note:

You can specify an import scope, which allows you to import all Process assets for an instance, for a space, or a specific process application or decision model. Be sure not to import assets more than once, because doing so can lead to unpredictable results.

Note:

The import utility requires Java version 8 or later. In addition, both the source and target instances must return a ping response.

1. On the Oracle Integration Home page, click Processes in the navigation pane.
2. Click Settings in the navigation pane, then Import on the Administration page.
3. Click the Download Utility button and save it to a selected location.
4. Sign in to the Oracle Integration source and target environments.
5. Run the utility from the command line. Use arguments to import an entire instance, one or more of its spaces, or one or more process applications or decision models.
   Format
   $java -jar ImportTool.jar srcType=PCS srcHost=http://host:port srcUser=user oicHost=http://host:port oicUser=user scope=scope
   Example: Import the entire Oracle Integration instance
   $java -jar ImportTool.jar srcType=PCS srcHost=http://abc01xyz.example.com:7001 srcUser=user1 oicHost=http://def02uvw.example.com:7001 oicUser=user1 scope=SPACE srcSpace="123456789"
   Example: Import process applications (delimit items by pipe line)
   $java -jar ImportTool.jar srcType=PCS srcHost=http://abc01xyz.example.com:7001 srcUser=user1 oicHost=http://def02uvw.example.com:7001 oicUser=user1 scope=PROJECT srcSpace="132457689” srcProject="Loan Application|Travel Application" oicSpace=”123456789”
6. When prompted by the utility, enter the source system password, then the target system password.
7. Review the import log.

   Note:

   You must check the logs and make sure there are no errors before proceeding with post migration steps.

   A zip file containing the import log is created in the SRC_TO_OIC folder. It lists any errors that might have occurred along with a summary of the number of spaces or items (process applications or decision models) imported.

8. In Oracle Integration, change space settings as needed.
   Return to the design-time Administration screen, and share the space(s) you migrated to Oracle Integration and change their permissions.