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

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. You can export API flows as either YAML files or BAR files.

Restriction: The following size restrictions exist for the files that you import into App Connect Enterprise as a Service.
  • YAML files that you import must be a maximum of 800 KB.
  • BAR files that you import must be a maximum of 50 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.

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 exported flow is saved as 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 runtime flow asset.

    If you export the flow as a design-time asset, it is saved in a YAML file. You can import the YAML file into App Connect Enterprise as a Service where you can continue to edit or develop it. If you export the flow as a runtime asset, it is saved as a BAR file, which you can import and deploy to 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.
    YAML file
    To import a YAML file, go to the Designer home page and click Import a flow. Alternatively, go to the Designer dashboard and click Create > Import flow. You can then drag or select the YAML file that you want to import.
    Note: You can import YAML files of up to 800 KB.

    The imported flow opens in the flow editor where you can see any validation errors. Typically, validation errors in imported flows indicate that connectors aren't connected to accounts.

    BAR file
    • If you're on the VPC hours price plan, to import a BAR file, go to the Dashboard instance and click Deploy integrations. Follow the instructions to upload your BAR file, create an integration runtime, and apply appropriate configurations. For more information, see Deploying integrations on the VPC plan.
    • If you're on the flow runs plan, to import a BAR file, go to the Manage tab Icon that represents the Manage tab of your Designer instance and click Deploy, then click Add file. You can then apply one or more configurations to your BAR file and deploy it. For more information, see Deploying integrations on the flow runs plan.
    Note: You can import BAR files of up to 50 MB.

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.
    Note: You can import BAR files of up to 50 MB.
  4. Import the exported BAR file to App Connect Enterprise as a Service.
    • If you're on the VPC hours plan, to import a BAR file, go to the Dashboard instance and click Deploy integrations. Follow the instructions to upload your BAR file, create an integration runtime, and apply appropriate configurations. For more information, see Deploying integrations on the VPC plan.
    • If you're on the flow runs price plan, to import a BAR file, go to the Manage tab Icon that represents the Manage tab of your Designer instance and click Deploy, then click Add file. You can then apply one or more configurations to your BAR file and deploy it. For more information, see Deploying integrations on the flow runs plan.