Migrating development resources to IBM App Connect Enterprise 13.0

You cannot migrate the IBM® Integration Toolkit from previous versions, but you can install IBM App Connect Enterprise 13.0 to coexist with a previous version. You can then migrate the development resources to the IBM Integration Toolkit Version 13.0 by using a project interchange file.

Before you begin

Be aware of the following restrictions that apply after you migrate resources to IBM App Connect Enterprise Toolkit Version 13.0.
  • You cannot share the development resources with previous versions of the IBM Integration Toolkit. When you create a new project in IBM App Connect Enterprise Toolkit Version 13.0, it is created in a format that cannot be used in previous versions of the IBM Integration Toolkit. You can take the following steps to manage development with different versions of the IBM Integration Toolkit.
    • If you are using a version control system, create a new stream for use with the new version of your project.
    • If you expect to continue development of a project for an integration node at a version before Version 13.0, you must retain an IBM Integration Toolkit at the previous version.
    • If you need to continue development of the same project for integration nodes on both Version 13.0 and a previous version, ensure that you use the IBM Integration Toolkit from the previous version for development.
  • You cannot deploy resources from IBM App Connect Enterprise Toolkit Version 13.0 to integration nodes at a previous version to Version 13.0.
  • You can use the IBM Integration Explorer view of the IBM App Connect Enterprise Toolkit to add connections for integration servers and integration nodes. IBM App Connect Enterprise Toolkit Version 13.0 supports Version 13.0 integration servers and integration nodes only. Connections to integration servers and integration nodes that are running on previous releases are not supported.
  • If any of the following actions cause an error in the project, the IBM App Connect Enterprise Toolkit marks the error, and you can use a Quick Fix to rectify the error.
    • Creating the metadata information for the user-defined node project
    • Correcting the plug-in identifier if it does not match the project name
    • Ensuring all the user-defined nodes are in the same category
    For more information, see Applying a Quick Fix to a task list error. However, if you have different user-defined nodes that depend on different resources that have identical names, the BAR file compiler produces an error that indicates a naming conflict in the dependent resources.

About this task

You can continue to use resources from a previous version of IBM Integration Bus by importing them into an IBM App Connect Enterprise Toolkit Version 13.0 workspace. After you import resources, you can no longer use them in a previous version of the IBM Integration Toolkit.

Procedure

  1. In the previous version of the Toolkit, export the resources that you want to use in IBM App Connect Enterprise Toolkit Version 13.0.
    1. Click File > Export.
      The Export wizard opens.
    2. Expand Other, click Project Interchange, then click Next.
    3. Select the projects that you want to export, and specify the location for the compressed file that is created. You can save the file to a folder on your file system, or to a disk drive.
    4. Click Finish.
      The project interchange file is created in the specified location.
  2. Create an IBM App Connect Enterprise Toolkit Version 13.0 workspace, or open an existing one.
  3. Import the project interchange file into the Version 13.0 workspace.
    1. Click File > Import.
      The Import wizard opens.
    2. Expand IBM Integration, click Project Interchange, then click Next.
    3. Specify the location of the project interchange file that you created in step 1.
    4. Specify the location of the open Version 13.0 workspace.
    5. Select the projects that you want to import into your Version 13.0 workspace, then click Finish.