Migration Xpress Source Environment Save Failure

Products

• CA Identity Manager

Issue/Introduction

When attempting to save Source and Target Environment information in the Migration Xpress UI, clicking Done results in the following error message:

"You have some uncompleted steps, redirecting back to previous steps"

Checking the log file located at <Migration_Xpress_download_directory>/bin/log/app.log reveals the following error:

ERROR ... UT005023: Exception handling request to /analyzer/envxml/load org.springframework.web.util.NestedServletException: ... java.lang.Exception: Failed to load the RolesDef XML: ... (No such file or directory)

 

Environment

• Product: CA Identity Manager
• Component: Migration Xpress
• Release: 14.4
• OS: Windows / Linux

Cause

This error occurs because the mx_ui script was executed directly from the bin subdirectory rather than the root directory of the Migration Xpress installation. Running the script from the wrong directory causes the application to fail when attempting to write relative paths (such as data/RoleDefinitions-cache-SOURCE.xml) to the local disk.

Resolution

To resolve this issue, the migration UI script must be executed from the Migration Xpress root directory to ensure the application correctly resolves relative file paths.

1. Open a command prompt or terminal window.

2. Navigate to the root directory of your Migration Xpress installation: cd <Migration_Xpress_download_directory>

3. Run the startup script relative to the root directory:

   For Windows: bin\mx_ui.cmd

   For Linux: ./bin/mx_ui.sh

Additional Information

For detailed deployment workflows and requirements, refer to the official documentation: Deploying Migration Xpress