Migrating integrations

To migrate your integration flows, export them from IBM® App Connect Enterprise, then import them to IBM App Connect Enterprise as a Service.

Before you begin

  • To migrate flows from IBM Integration Bus to App Connect Enterprise as a Service, you must first migrate your resources to App Connect Enterprise. For more information, see Migrating to App Connect Enterprise 13.0 in the IBM App Connect Enterprise documentation.
  • Before you import a BAR file, check that App Connect Enterprise as a Service supports all the resources in that BAR file. For more information, see Supported resources in imported BAR files.

About this task

You can migrate your IBM App Connect Enterprise Toolkit integrations to run in App Connect Enterprise as a Service. You export Toolkit integrations with their associated resources in BAR files, which you import into App Connect Enterprise as a Service.

Restriction: BAR files that you import into App Connect Enterprise as a Service must be a maximum of 100 MB.

After you import an integration into App Connect Enterprise as a Service, you might need to apply one or more configurations to your integration. Configurations provide environment-specific settings, secrets, or data that your flows need when they run. By separating flows from configuration files, you avoid the need to edit a flow before you deploy it to different environments such as development and production.

Procedure

To migrate flows from App Connect Enterprise 13.0, complete the following steps.

  1. In the IBM App Connect Enterprise Toolkit, click File > Export.
  2. Expand General, select File System, then click Next.
  3. Select the BAR files that you want to export, specify the directory on your local file system that you want to export them to, then click Finish.
    Note: You can import BAR files of up to 100 MB.
  4. In App Connect Enterprise as a Service, go to the Manage tab Icon that represents the Manage tab, click BAR files, then click Import BAR file.
  5. On the BAR files tab of the Manage page, open the menu Icon that represents the options menu for the BAR file for the imported BAR file and click Deploy.

    If you're on the VPC hours plan, select or create a runtime, add or create configurations, then deploy. For more information, see Deploying integrations on the VPC plan.

    If you're on the flow runs plan, add or create configurations, then deploy. For more information, see Deploying integrations on the flow runs plan.