Installing the IBM Application Modernization Accelerator Developer Tools plug-in for the Eclipse IDE

Compatibility

The plug-in is compatible with:

• Eclipse IDE for Java™ Developers or Eclipse IDE for Enterprise Java and Web Developers
• Version 2024-06 and later. For the current supported versions, check the Eclipse Marketplace.
• On Windows, the plug-in requires the Microsoft Edge WebView2 runtime. In newer versions of Windows this runtime might already be installed.

Installing from the Eclipse Marketplace

To install from the Eclipse Marketplace:

1. Open your Eclipse IDE.

2. Open the Eclipse marketplace.

3. Search for IBM Application Modernization Accelerator Developer Tools.

4. Click and drag the Install button into the workspace in your Eclipse IDE.

5. On the Confirm features page, review the items, then click Confirm.

6. On the Review licenses page, read the license, click to agree, then click Finish.

7. On the Software updates page, click Restart Now to apply the software updates.

Installing the plug-in from the Eclipse IDE

To install from your Eclipse IDE:

1. In your Eclipse IDE, click the Help menu, then choose Eclipse Marketplace.

2. Search for IBM Application Modernization Accelerator Developer Tools.

3. Click the Install button for the plug-in you need.

4. On the Confirm Features page, review the items, then click Confirm.

5. On the Review Licenses page, read the license, click to agree, then click Finish.

6. On the Trust Authorities page, click the checkbox, then click Trust Selected.

7. On the Software Updates page, click Restart Now to apply the software updates.

Setting up your enterprise Java environment

If you want to work with enterprise Java applications, you need to set up your environment. For more information, see Setting up your enterprise Java environment.

Applying a license key for IBM Application Modernization Accelerator Developer Tools in Eclipse

Before you can use IBM Application Modernization Accelerator Developer Tools in Eclipse, you must establish your entitlement, either by uploading a valid migration plan, or by applying a license key file.

Uploading a valid migration plan

You can establish your entitlement by uploading a migration plan. This option requires a valid migration plan from IBM Application Modernization Accelerator.

1. Open the Modernize to Liberty view.

   1. In the Explorer view, right-click an application that you want to modernize and select Modernize Java Applications > Modernize to Liberty.

   2. If you do not have entitlement for IBM Application Modernization Accelerator, a warning message appears at the top of the screen.

2. Upload a migration plan.

   1. Click Upload migration plan.

   2. Select the migration plan in the file picker and click OK.

   3. Respond to the prompts for decisions in the Modernize to Liberty view to complete the process of modernizing the application.

Applying a license key file

You can establish your entitlement by applying a license key file.

1. Open the Manage License Key panel.

   1. To open the Manage License Key panel in the Eclipse IDE, click Window > Preferences > AMA Dev Tools > Manage License Key.

      If you do not have entitlement for IBM Application Modernization Accelerator, a warning message appears at the top of the screen.

   2. If you already have a license key file saved on your machine, click the Manage License Key link.

      If you do not have a license key file, click IBM Passport Advantage to download one based on your entitlement. For more information, see Obtaining a valid license key in the IBM Application Modernization Accelerator documentation. Save the license key file to your local computer; it should have a .lic file extension.

2. Apply a license key file.

   1. In the Manage License Key panel, click Browse to locate your license key file (for example, AMA_License_Key.lic).

   2. Select the license key file in the file picker and click OK.

      The License key successfully processed message appears at the top of the Manage License Key page.

   3. Click OK.

Securing your setup

IBM Application Modernization Accelerator Developer Tools doesn't provide additional security controls. Use these steps to properly secure your setup.

Your Eclipse environment

Apply all Eclipse updates to help ensure that you have the latest security and bug fixes.

The IBM Application Modernization Accelerator Developer Tools plug-in work area is located under /.metadata/.plugins/com.ibm.ama.dt/.amadt. This work area might contain files that are not encrypted, other than the encryption that your file system provides. Safeguard the data against improper access.

Using the Console view to see activity details

You can use the Console view of the Eclipse IDE to see details about what the plug-in is doing and logging, and check for any errors.

To open the Output view:

1. In Eclipse, click Window, select Show View, then click Console.

2. In the Console view, click the Display Selected Console icon to select IBM Application Modernization Accelerator Developer Tools. It provides more details about what the plug-in is doing.

To adjust the Console view and logging for the Eclipse plug-in:

1. Open the settings for the Eclipse IDE.

2. Click the IBM AMA Dev Tools entry.

3. In Log level, switch from the default of INFO to another setting such as WARN.

Uninstalling the plug-in

If you need to uninstall IBM Application Modernization Accelerator Developer Tools, follow these steps:

1. In the Eclipse IDE, click Help, then click Install New Software.

2. Click What is already installed?.

3. On the Installed Software tab, select IBM Application Modernization Accelerator Developer Tools, then click Uninstall.

4. On Uninstall, review the items, then click Finish.

5. Restart Eclipse. On Software Updates, click Restart Now.