Migrating a Project

You can migrate an adapter project created in TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO ActiveMatrix BusinessWorks 6.x by using the migration tool in TIBCO Business Studio.

You can migrate a TIBCO ActiveMatrix BusinessWorks 5.x project to a TIBCO ActiveMatrix BusinessWorks 6.x project, but not in reverse. TIBCO Business Studio does not support importing .dat files from TIBCO Designer. To migrate a project stored in a .dat file, you can import the file in TIBCO Designer and save it as a multi-file project.

Note: The name of a project migrated to TIBCO Business Studio cannot contain any special characters such as: (space) ! $ % & + . / @ \ ~

Prerequisites

Before migrating a project to TIBCO ActiveMatrix BusinessWorks 6, complete the following steps:
  1. Migrating the project to the latest version of the runtime adapter.
  2. Validating the project in TIBCO Designer.
    For more information, see "Validating Projects" in TIBCO Designer User's Guide.
    Note: Before preparing a project for migration, ensure that no error occurs when validating it in TIBCO Designer.

Procedure

  1. In TIBCO Business Studio, click Project > Migrate BW Projects to open the migration tool.
    Note: Alternatively, you can migrate the projects by clicking File > Import from the main menu. In the Import dialog, click Migrate BW Projects, and then click Next.
  2. In the BW Migration Tool wizard, specify the relevant information in the following fields.
    1. In the BusinessWorks 5 Projects Folder field, click Browse and provide the location of the ActiveMatrix BusinessWorks 5.x project that you want to migrate.

      The tool scans the ActiveMatrix BusinessWorks 5.x projects in the specified folder location and displays a list of projects.

    2. In the Migrated Project Folder field, click Browse and provide the location where you want to migrate the project.
  3. In the BusinessWorks 5 Projects panel, select the projects you want to migrate and click Migrate.
    The migration progress is displayed in the Migration Output panel.
  4. Click Close after the migration is completed.

What to do next

Depending on the configuration of the project to migrate, you have to complete some tasks after migration. For the postmigration tasks, see Configuring a Migrated Project.