Error "NonfatalInstallException" during AutoSys System Agent upgrade

Products

• Autosys Workload Automation
• Workload Automation Agent

Issue/Introduction

When upgrading the AutoSys Workload Automation Agent to a newer version, the installation fails with a path validation error․​​​​‌​‍

ERROR MESSAGE: "NonfatalInstallException The path provided does not point to a valid agent directory․ cybAgent․bin/․exe is missing․"

SYMPTOMS:

• Upgrade process terminates unexpectedly

• The installer log shows security software intercepting the Java process
  Example:
  sun.boot.class.path:
      /tmp/install.dir.314988/Linux/resource/jre/lib/resources.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/rt.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/sunrsasign.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/jsse.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/jce.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/charsets.jar
      /tmp/install.dir.314988/Linux/resource/jre/lib/jfr.jar
      /tmp/install.dir.314988/Linux/resource/jre/classes
      /opt/dynatrace/oneagent/agent/bin/1.299.73.20250109-153420/any/java/oneagentjava.8.jar
      /opt/dynatrace/oneagent/agent/bin/1.299.73.20250109-153420/any/java/oneagentjava.jar
      /opt/dynatrace/oneagent/agent/bin/1.299.73.20250109-153420/any/java/oneagentjava.rmi.jar
      /opt/dynatrace/oneagent/agent/bin/1.299.73.20250109-153420/any/java/oneagentjava.sql.jar
  

• Agent directory validation fails even when the path is correct

   

CONTEXT:
Occurs during the agent upgrade execution when third-party security software is active․

IMPACT:
Administrators cannot complete the agent upgrade process․

Environment

 

• OS: Linux

• Product: AutoSys WA Agent 12․0․00․00 upgrading to 12․1․01․00

• Third-Party Tool: Dynatrace OneAgent

 

Cause

Third-party security software inserts itself into the AutoSys installer Java process․
This interference prevents the installer from correctly validating the agent installation path and locating the existing binaries․

Resolution

STEPS:

Step 1: IDENTIFY SECURITY SOFTWARE INTERFERENCE

Path: /tmp/install․dir․[id]/Linux/resource/jre/

EXPECTED: Review the installer log to verify if third-party security software injects Java libraries into the installer process․
NOTE: Check for lines referencing oneagentjava․jar or similar security tools․

 

Step 2: DISABLE OR UNINSTALL SECURITY SOFTWARE

Command: Temporarily disable or uninstall the interfering security software tool․

EXPECTED: The security software no longer monitors or blocks the installer Java process․

 

Step 3: EXECUTE THE AGENT UPGRADE

Command: Run the AutoSys agent upgrade installer again as root․

EXPECTED:
The upgrade completes successfully without path validation errors․

NOTE: Ensure the correct agent path is provided (e․g․, /apps/autosys/SystemAgent/[agent-name])․

 

Step 4: RESTORE SECURITY SOFTWARE

Command: Re-enable or reinstall the security software․

EXPECTED: The system returns to its standard protected state․

 

VERIFY SUCCESS:

• The cybAgent process starts normally

• The AutoSys agent successfully upgrades to the target version