Installing the migration tools

The migration tools are Eclipse features that you install into an existing Eclipse or Rational integrated development environment (IDE). You can download Eclipse from http://www.eclipse.org. Eclipse IDE for Enterprise Java Developers is required for working with Java/Jakarta EE applications.

Viewing hardware and software requirements

When you plan an installation, review the list of supported operating systems, detailed system requirements, and hardware requirements. To get this information, you can view a software product compatibility report.

Go to the Software Product Compatibility Reports page.
Click Create a report for the type of report you want to create.
For the Full or partial product name field, enter WebSphere Application Server Migration Toolkit and click the Search product icon.
In the search results, select a version in the Version list and click Submit.

Learn the steps to quickly and easily generate custom IBM Software Product Compatibility Reports.

Installing

You can install all features of the migration toolkit directly from Eclipse Marketplace or from the online repository. You can also manually download the repository archive. All options are described in the following steps:

Start the IDE.
Uninstall any previous version of the migration toolkit. In Rational Application Developer, use IBM Installation Manager to uninstall the Code Analysis feature that is typically installed by default.
Verify that the prerequisite plug-ins are installed in your IDE. In Eclipse, all prerequisites are installed by default in the Eclipse IDE for Enterprise Java Developers edition. In Rational Application Developer, all prerequisite plug-ins are typically installed by default. In Rational Software Architect, the plug-ins are not enabled by default. For Rational products, use IBM Installation Manager to verify that the Web Developer Tools feature is installed.
Install the migration tool features that you need.
1. Access the migration tool software.
  You can install the tool directly from our online repository or from Eclipse Marketplace. Alternatively, you can manually download and install the repository archive.
  - To install from the online repository:
    1. In your IDE, go to Help > Install New Software.
    2. Click Add, and in the Add Repository window, enter the following information:
      
      Name: WebSphere Migration Toolkit
      
      Location: https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/updates/wamt/MigrationToolkit/
    3. Click OK.
  - To install the tool from the Eclipse Marketplace:
    1. Go to Help > Eclipse Marketplace.
    2. Search for WebSphere migration.
    3. Under IBM WebSphere Application Server Migration Toolkit, click Install.
    Figure 1. Accessing the migration tool software from Eclipse Marketplace
  - To install from the repository archive:
    1. Download the latest version of the IBM WebSphere Application Server Migration Toolkit from the WebSphere Migration Knowledge Collection Downloads.
    2. In your IDE, go to Help > Install New Software.
    3. Click Add, and in the Add Repository window, enter the following information:
      
      Name: WebSphere Migration Toolkit
      
      Location: Click Archive and browse to the repository archive that you downloaded.
    4. Click OK.
2. Expand IBM WebSphere Application Server Migration Toolkit, and select the migration tools that you need for cloud, version-to-version, or third-party application server migration. Ensure that Contact all update sites during install to find required software is selected, and click Next.
  
  Figure 2. Selecting migration toolkit features
3. In the Install Details window, click Next.
4. In the Review Licenses window, read the terms and accept any license agreements. Click Finish. The Installing Software window shows the installation progress.
5. When the Software Updates window is displayed, click Yes to restart the IDE.