RA FTP agent fails to start with errors: U2013310 Failed to load RA Agent AND java.lang.NumberForm

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

RA FTP agent fails to start with errors: U2013310 Failed to load RA Agent AND java.lang.NumberForm

Environment

Release: AUTOME99000-2.0-Automic-Oracle Retail MOM-Enterprise Edition
Component:

Resolution

Detailed Description and Symptoms

After an attempt to load a new solution jar file to the Automic DB and restart the RA FTP Agent, these messages are written to the RA Agent log:

U2013310 Failed to load RA Agent.

U0003620 Routine 'UCEX_R' forces trace because of error.

U0003450 The TRACE file was opened with the switches '0000000000000001'.?

Running the agent from the command line with a nohup command might throw an error like: java.lang.NumberFormatException: For input string: "&01".

Investigation

Locate the RA Agent's trace log (RA_TRACE_xx.TXT) and examine for this message in "STACK TRACE" section:

java.lang.NumberFormatException: For input string: "version.txt"

Solution

This was a very unusual issue that does not occur often. The solution is to delete everything under the "cache" directory, the directory is located in the root RA Agent directory. 
 
 Example:
  
  <basedDirectory>/bin
  <baseDirectory>/temp
  <baseDirectory>/cache  <--- Delete everything under this directory, DO NOT delete the directory itself.