Backing up the IBM Integration Toolkit workspace

The IBM® Integration Toolkit workspaces contain your personal settings and data, such as message flow and message set resources. You can have multiple workspaces in different locations, and you can also have references to projects that are in other locations, therefore consider all these locations when you back up your resources.

About this task

The default workspace directory for the IBM Integration Toolkit depends on the platform on which it is running:
  • Windows platformOn Windows, the default workspace directory is created at C:\Users\user_name\IBM\IIBT10\workspace.
  • Linux platformOn Linux®, the default workspace directory is created at $HOME/IBM/IIBT10/workspace.
where user_ID is the user name with which you are logged on. Back up files in these locations, and in all other locations in which you have saved workspace files.

The IBM Integration Toolkit workspace directory contains a directory called .metadata, which contains your personal settings and preferences for the IBM Integration Toolkit. If the .metadata directory gets corrupted, you lose these settings, and the IBM Integration Toolkit reverts to the default layout and preferences. If you have not backed up the .metadata directory, you must manually set all preferences again, and import all projects, such as message flow projects, that were displayed in the Application Development view. To back up the .metadata directory, take a copy of the directory.

The IBM Integration Toolkit workspace also contains a directory for each project (for example, a message flow project) that you have created in the IBM Integration Toolkit. These directories contain your data, which you must back up.

Use one of the following methods to back up the data in your workspace.


  • Export your working projects.
    You can export the projects directly as a compressed file. For further information, see Exporting in the Eclipse Workbench User Guide.
  • Copy the project directories from the workspace directory to another location.
  • Copy all your BAR files to back up their contents.
    Include all the associated source files when you build your BAR files; you can then save all content by saving only the BAR file. To add resources to a BAR file that is ready for deployment, select Include source files, which adds the message flow and message set source files, and the compiled files.

What to do next

If you want to restore the resources, copy the directories back into your workspace directory and import the projects. For instructions, see Importing in the Eclipse Workbench User Guide.