Migrating IBM Integration Designer artifacts

You can migrate artifacts from previous versions of Integration Designer or WebSphere® Integration Developer to IBM® Integration Designer V8.5.7. Migrating to IBM Integration Designer V8.5.7 preserves the basic structure of your existing applications with minimal required reconfiguration.

About this task

If you migrate the target runtime environment to IBM Business Process Manager V8.5.7, you can run the applications that you previously deployed, even if you do not migrate Integration Designer or WebSphere Integration Developer. However, if you want to edit the applications, you must also migrate Integration Designer or WebSphere Integration Developer to a compatible version so the major versions of the two products match.

Instead of migrating the source artifacts individually, you can import your existing workspace by selecting the directory where your workspace is located when IBM Integration Designer is launched. See Considerations for the IBM Integration Designer migration process before you import your existing workspace.

The WebSphere InterChange Migration wizard and the WebSphere Business Integration Server Foundation Migration wizard were removed from IBM Integration Designer V8.5.7. If you have applications that you created that use IBM WebSphere Adapters, you cannot migrate the applications directly to V8.5.7. You must migrate them using another version of Integration Designer V8.5.x and then upgrade to V8.5.7.

  • Migrating source artifacts
    IBM Integration Designer source artifact migration refers to the process of importing a project interchange (PI) created in an older version of IBM Integration Designer or WebSphere Integration Developer into a newer version of IBM Integration Designer.
  • Migrating XML maps
    The underlying structure of XML maps was changed between releases of WebSphere Integration Developer. Use the migration wizard or the quick fix feature to migrate your maps to the current version.
  • Migrating generated Java EE staging projects
    When you import a project interchange file that contains modules from a previous version of Integration Designer or WebSphere Integration Developer, a migration wizard is automatically launched in IBM Integration Designer V8.5.7. If the project interchange file contains any generated Java Platform, Enterprise Edition staging projects (such as EJB, Web, or App projects), the migration wizard contains a page to help you migrate the projects.
  • Migrating server runtime targets
    When you import a project interchange file that contains modules from a previous version of Integration Designer or WebSphere Integration Developer, a migration wizard is automatically launched in IBM Integration Designer V8.5.7. If the project interchange file contains any projects that target a previous version of the server runtime, the migration wizard contains a wizard page that enables you to automatically update the projects to target the current server runtime of Integration Designer.
  • Considerations for the IBM Integration Designer migration process
    When you migrate from a previous version of Integration Designer or WebSphere Integration Developer to IBM Integration Designer V8.5.7, most of the migration is done automatically. However, there are a number of considerations to be aware of that might require additional manual configuration.
Parent topic: Migrating artifacts from IBM BPM Advanced V8.0.x or V7.5.x
Previous topic: Migrating Process Center artifacts