Migrating integrations

To migrate your integration flows, export them from IBM® App Connect on IBM Cloud or 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 12.0 or Migrating to App Connect Enterprise 11.0 in the IBM App Connect Enterprise documentation.

About this task

You can migrate your existing App Connect on IBM Cloud event-driven flows and API flows, and your IBM App Connect Enterprise Toolkit integrations to run in App Connect Enterprise as a Service. Event-driven flows are exported from App Connect on IBM Cloud as YAML files, which you then import into the App Connect Enterprise as a Service Designer instance. Toolkit integrations are exported with their associated resources in BAR files, which you import into App Connect Enterprise as a Service. BAR files that you import must be a maximum of 50 MB in size. You can choose to export API flows as either YAML files or BAR files.

Migrating your flows from App Connect on IBM Cloud

Procedure

To migrate flows from App Connect on IBM Cloud, complete the following steps.

  1. Log in to App Connect on IBM Cloud and go to the Dashboard, where you can see all your event-driven and API flows.
  2. Stop any flows that are running.
  3. For each event-driven flow that you want to migrate, open the tile menu and click Export.

    The configuration for your exported flow is saved in a YAML file. Depending on your browser, the file might be downloaded automatically to your default download location or you might be prompted to save it.

  4. For each API flow that you want to migrate, open the file menu and click Export and choose whether to export it as a design-time or run-time flow asset.

    If you choose to export the flow as a design-time asset, the configuration is saved in a YAML file. You can import a YAML file into the Designer instance of App Connect Enterprise as a Service. If you choose to export the flow as a run-time asset, it is saved as a BAR file. You can deploy a BAR file to a run-time environment in the Dashboard instance of App Connect Enterprise as a Service.

    Depending on your browser, the exported file might be downloaded automatically to your default download location or you might be prompted to save it.

  5. Log in to App Connect Enterprise as a Service.
  6. Import an exported file in one of the following ways.
    • To import a YAML file, go to the Designer instance and click Import a flow on the home page or in the Designer dashboard, click New > Import flow. You can then drag or select the YAML file that you want to import.
    • To import a BAR file, go to the Dashboard instance, click Deploy integrations and follow the instructions to upload your BAR file and create an integration runtime. For more information, see Creating an integration runtime.

Migrating your flows from App Connect Enterprise 11.0 or 12.0

Procedure

To migrate flows from App Connect Enterprise 11.0 or 12.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.
  4. Import an exported file to App Connect Enterprise as a Service in one of the following ways.
    • To import a YAML file, go to the Designer instance and click Import a flow on the home page, or in the Designer dashboard click New > Import flow. You can then drag or select the YAML file that you want to import.
    • If you're on the VPC-hours price plan, you import a BAR file in the App Connect Dashboard. Go to the Dashboard instance, click Deploy integrations and follow the instructions to upload your BAR file and create an integration runtime. For more information, see Creating an integration runtime.
    • If you're on the flow runs price plan, you import a BAR file on the Manage tab of the App Connect Designer. Go to the Manage tab, click Add file, then select the BAR file from your file system.