CAU fails for Windows Java Agent when installation path contains spaces.

Products

• CA Automic Workload Automation - Automation Engine
• Automic SaaS

Issue/Introduction

When performing a Centralized Agent Upgrade (CAU) for a Windows Java-based Agent, the following symptoms occur:

• The upgrade package (e.g., jre.zip) is successfully sent to the Agent host.
• The Agent service stops as expected.
• The JRE package is not unpacked into the bin/jre directory.
• The Agent fails to restart automatically, as the new binary or JRE components are missing.
• Manual extraction of the jre.zip package allows the Agent to start successfully.

Environment

• Product: CA Automic Workload Automation
• Component: Windows Java-based Agent
• Versions: 21.0.15 through 24.4.4
• OS: Windows

Cause

This behavior is caused by a software defect (DE191267) in the Agent launcher’s handling of PowerShell commands.

The deleteDirectory method in the launcher utilizes a PowerShell command to remove the existing JRE directory before unpacking the new one. However, the directory path is concatenated as a raw string without single quotes. If the Agent's installation path contains spaces (for example, C:\Program Files\Automic\Agent), the PowerShell command fails to parse the path, causing the deletion and the subsequent upgrade process to stall.

Resolution

This issue is scheduled to be resolved in the following versions:

• Automation Engine 24.4.5 - TBA
• Automation Engine 26.1.0 - TBA

To resolve the issue, upgrade the Automation Engine and the CAU target packages to the versions listed above once they are available.

Workaround

If an immediate upgrade to the fixed version is not possible, use one of the following workarounds:

1. Manual Intervention: After the CAU process stops the Agent, manually extract the jre.zip file located in the Agent's bin folder into the bin/jre directory and restart the Agent service.

2. Install to a Path Without Spaces: Reinstall the Windows Agent in a directory path that does not contain spaces (e.g., C:\Automic\Agents\Windows\). The CAU process will function correctly in environments where the path does not require quoting for PowerShell.