IBM Bob
Premium packagesIBM Bob Premium Package for Java Modernization

Troubleshooting

Find solutions to common issues you might encounter while running a Java Modernization workflow with IBM Bob.

SDKMan or WinGet not detected

Ensure SDKMan is initialized in your shell profile and that you have restarted the terminal session after installation.

  1. Open your shell profile (~/.bashrc or ~/.zshrc).
  2. Verify that the SDKMan initialization block is present at the bottom of the file.
  3. Restart your terminal session.

After installing WinGet, restart VS Code and any open terminals so that the updated PATH is picked up by Bob.

Note:

If auto-installation is blocked by corporate policy, pre-install the target JDK manually and set JAVA_HOME to point to it.

Dependency resolution errors

Run a clean build to force dependency re-download.

 
mvn clean install -U
gradle clean build --refresh-dependencies

Git flow integration problems

Confirm that Git is installed and accessible on the system PATH:

 
git --version

If the command is not found, install Git for your operating system and ensure it is available on the PATH before restarting Bob.

UI Modernization: missing backend or frontend output

Ensure that the back/ and front/ directories exist in the project root before starting the UI Modernization workflow. These directories must be created manually before initiating the workflow.

AMA bundle issues (Liberty replatforming)

Note:

The AMA Migration Bundle must be generated from AMA version 4.6.0 or later.

Check the following if you encounter issues with the AMA bundle:
  • The ZIP must contain server.xml, migration recipes, and dependency analysis at the top level — no extra wrapping folder.
    •
  • If deployment to Liberty fails, verify that:
    • The server.xml feature set matches the installed Liberty version.
    • The liberty-maven-plugin version aligns with your Liberty runtime.
    •
How is this topic?

Getting started

Start a Java Modernization workflow in IBM Bob using the Start Workflow button or a skill command.

Overview

Extend IBM Bob with AI-powered workflows for end-to-end modernization of mainframe applications including COBOL and PL/I.

On this page

SDKMan or WinGet not detectedDependency resolution errorsGit flow integration problemsUI Modernization: missing backend or frontend outputAMA bundle issues (Liberty replatforming)