Resolving problems when you convert WebSphere Enterprise Service Bus resources

Use the advice that is given here to help you resolve common problems that can arise when you convert WebSphere® Enterprise Service Bus resources by using the WebSphere ESB conversion tool.

About this task

The following list describes known problems with a corresponding solution or workaround:

Avoiding the launch of the Workspace Migration wizard

About this task

Scenario 1:

You import a WebSphere Enterprise Service Bus PI file into the IBM Integration Bus workspace. A Workspace Migration wizard opens when you:

  • Import a WebSphere Enterprise Service Bus PI file directly from the file system.
  • Import a WebSphere Enterprise Service Bus PI file by using the IBM Integration Bus Project Interchange import option.
  • Import a WebSphere Enterprise Service Bus PI file:
    • By using the WebSphere ESB Project Interchange import option, and
    • The PI file includes project types for which IBM Integration Bus does not have server runtime support, for example, Web and App projects.
  • Import a WebSphere Enterprise Service Bus PI file that contains a Java™ project.

Scenario 2:

You open an IBM Integration Bus workspace that includes WebSphere Enterprise Service Bus projects. You imported these projects by using the Project Interchange import option. A Workspace Migration wizard opens.

Explanation on the Workspace Migration wizard options:

When you get the first Workspace Migration wizard page, you have two options:
  • Click Next to continue.
  • Click Cancel to exit.
If you click Next:
  1. Continue to click Next until the option Finish is enabled.
  2. If you have project types that are not a WebSphere Enterprise Service Bus library project or a WebSphere Enterprise Service Bus mediation module project, the Undefined Server Runtime page opens. The window displays the following message: 
    No existing server run time supports the selected list of projects.  The migration wizard will not change the target runtime for these projects.
    Click Next to continue. The WebSphere ESB conversion tool does not convert all WebSphere Enterprise Service Bus project types. For more information, see WebSphere ESB conversion tool limitations.
  3. Click Finish. The Migration Validation window opens. The window displays the following message: Migration validation completed successfully. See the Migration Results view for additional information.
  4. Click Ok to finish.

Procedure

Solution:

Complete the following tasks in order:

  1. In IBM Integration Designer, export the WebSphere Enterprise Service Bus projects that you want to convert to IBM Integration Bus projects by selecting the Business Integration export option Integration Modules and Libraries. For more information, see Exporting WebSphere Enterprise Service Bus projects for conversion.
  2. Import WebSphere Enterprise Service Bus resources by using the WebSphere ESB Project Interchange import option. For more information, see Importing WebSphere Enterprise Service Bus resources.
  3. Optional: If your WebSphere Enterprise Service Bus PI file includes a Java project, complete the following steps in order:
    • In the Application Development view, complete the following steps:
      1. Expand Independent resources. Select YourJavaProject, where YourJavaProject is the name of your Java project.
      2. Right-click the YourJavaProject and select Properties.
    • Click Targeted Runtimes. In the list of runtimes, clear any selected entries, for example wps.esb.v75. Click Apply.
    • Click Java Build Path, then click JRE System Library. Click Edit, and choose the option Workspace default JRE. Click Finish.
    • Click Ok.

Correctly displaying the project icon types in the IBM Integration Bus workspace

About this task

Scenario 1:

WebSphere Enterprise Service Bus resources that are imported into IBM Integration Bus workspace display incorrect project icon types and are marked in error.

Projects are represented in IBM Integration Bus with the wrong icon type when you import WebSphere Enterprise Service Bus files directly from the file system or by using the standard Project Interchange import option. Icons display in error.

Procedure

Solution:

Complete the following tasks in order:

  1. Import WebSphere Enterprise Service Bus resources by using the WebSphere ESB Project Interchange import option.
  2. Resolve all unbound classpath container errors that result from importing WebSphere Enterprise Service Bus resources into the IBM Integration Bus workspace. For more information, see Resolving unbound classpath container errors reported in the IBM Integration Bus Problems view.

Resolving unbound classpath container errors reported in the IBM Integration Bus Problems view

About this task

Scenario 1:

When you import WebSphere Enterprise Service Bus resources by using the option Project Interchange, the following errors are reported in the Problems view:

  • Error 1: The project cannot be built until build path errors are resolved.
  • Error 2: Unbound classpath container: JRE System Library [IBM Process Server v8.0 JRE] in project project name. Project name corresponds to the name of the WebSphere Enterprise Service Bus imported project in IBM Integration Bus workspace.

Procedure

Solution:

Complete the following tasks in order:

  1. Right-click the message that describes error 2 in the Problems tab. Select Quick Fix. The window Quick Fix opens.
  2. Select the option Select a system library to use when building project name, where project name is the name of the WebSphere Enterprise Service Bus imported project in IBM Integration Bus workspace.
  3. Click Finish. The window Edit Library opens.
  4. Select the option Workspace default JRE (jdk).
  5. Click Finish.

Correctly displaying WebSphere Enterprise Service Bus resources in your WebSphere ESB conversion session

About this task

Scenario 1:

When you reimport a WebSphere Enterprise Service Bus project into your WebSphere ESB conversion session, the WebSphere Enterprise Service Bus resources included in the WebSphere Enterprise Service Bus project are not refreshed automatically.

Procedure

Solution:

To view your WebSphere Enterprise Service Bus project resources in your WebSphere ESB conversion session, complete the following tasks in order:

  1. Close your WebSphere ESB conversion session.
  2. Open your WebSphere ESB conversion session.
    1. In the Application Development view, select Independent resources > WESB_conversions.
    2. Double-click YourConversionSessionName.

Results

Your WebSphere Enterprise Service Bus resources display correctly.