Preserving existing user projects
Any user projects defined in your existing WebSphere Business
Integration Server Express or Express Plus system are stored locally
with the tools. When you run the installer to upgrade to another
version of WebSphere Business Integration Server Express or Express
Plus, the newly upgraded tools will not automatically recognize
the path to the System Manager workspace in which your existing
user projects reside.
To make all system manager projects (user projects and integration
component libs) available, you can do either of the following:
- Migrate existing user projects by exporting them as solutions
to a temporary location before the upgrade, and then importing them
into your new installation after the upgrade. This is the recommended approach.
- After the upgrade, revise your System Manager workspace path
to point to the location of your original workspace, where your
original user projects reside.
Migrating existing projects
To migrate existing projects, first export them as a solution
to a temporary location, then import them back into your newly upgraded
System Manager.
Exporting user project solutions
To export a user project and the integration components
it references as a solution, perform the following steps:
Note:
Exporting a solution migrates only the integration
components and shortcuts are are included in the user projects that
you select for that solution. If you want to also migrate additional
integration components that have not been included as shortcuts
in any user project, then also follow the procedures for Exporting
components to a package using System Manager in the System Implementation
Guide.
- In the WebSphere Business Integration System Manager view, expand
the User Projects folder, then right-click
the InterChange Server Projects folder and
choose Export Solution from the context menu. System
Manager displays the Export Solution wizard.
- To select the components you want to export, perform one of
these options:
- Enable the check box next to user projects to select all of
the components in the projects.
- Enable the check box next to a component group to select all
of the components in the group.
- Highlight a component group and then enable check boxes next
to individual components in the right-hand pane to select those
components.
- Either type the full path and name of the directory into which
the solution should be exported in the text field at the bottom
of the wizard screen, or click Browse to navigate
to the desired directory.
- Click Finish. The System Manager does
the following to export the solution in the directory specified
in Step 3:
- Creates a User directory that contains the shortcuts in the
user projects selected during the export of the solution.
- Creates a System directory that contains the directories of
the integration component library referenced by the shortcuts in
the user projects selected during the export of the solution.
- When prompted that the export operation completed successfully,
click OK.
Importing user project solutions
With InterChange Server Express running, connect System
Manager to your InterChange Server Express instance and perform
the following steps:
- Expand the User Projects folder, right-click InterChange Server Projects,
and select Import Solution.
- Either type the full path and name of the directory in which
the exported solution exists into the Solution directory name field,
or click Browse to navigate to the desired
directory.
- Click Finish. The System Manager creates
the integration component libraries and user projects defined in
the exported solution in your environment.
