The Remote AveksaAgent fails to start as a service on Windows in RSA Governance and Lifecycle
Article Number
Applies To
- RSA Governance & Lifecycle 8.0.0 P09
- SecurID Governance & Lifecycle 7.5.2 P04, P05, P06
Issue
The Remote AveksaAgent fails to start as a service on Windows machines:
The following exception is shown in the wrapper.log:
INFO | jvm 1 | 2023/05/28 10:20:06 | WrapperSimpleApp: Unable to locate the class com.aveksa.client.datacollector.startup.Bootstrap: java.lang.NoClassDefFoundError: org/apache/log4j/Logger
Cause
Java classpath in the wrapper.conf file is pointing to a different log4j.jar file, hence remote agent was failing to start as a service.
Resolution
This issue is resolved in the following versions/patches:
- RSA Governance & Lifecycle 8.0.0 P10
- SecurID Governance & Lifecycle 7.5.2 P07
Workaround
WORKAROUND for RSA Governance & Lifecycle 8.0.0 P09:
Follow the below steps as a workaround on RSA Governance & Lifecycle 8.0.0 P09 to run the remote agent as a service on a Windows machine:
- Stop RemoteAgent if running already.
- Uninstall Remote Agent by running "UninstallAvAgent-NT.bat" as Administrator in AveksaAgent/bin folder.
- Download Remote Agent zip from UI and re-deploy the agent on windows box (this includes removing the old AveksaAgent folder and unzipping the new agent zip into a new folder).
- Locate the below lines in wrapper.conf file present under AveksaAgent/conf folder:
- wrapper.java.classpath.3=../common/lib/log4j-1.2-api-2.17.2.jar
- wrapper.java.classpath.4=../common/lib/log4j-api-2.17.2.jar
- wrapper.java.classpath.5=../common/lib/log4j-core-2.17.2.jar
- Update the above lines as follows in the same file & save the changes:
- wrapper.java.classpath.3=../common/lib/log4j-1.2-api-2.21.0.jar
- wrapper.java.classpath.4=../common/lib/log4j-api-2.21.0.jar
- wrapper.java.classpath.5=../common/lib/log4j-core-2.21.0.jar
- Go to Remote agent bin folder & install agent by running "InstallAvAgent-NT.bat" file as Administrator.
- Go to Services window and start AveksaAgent service.
WORKAROUND for SecurID Governance & Lifecycle 7.5.2 P04-P06:
Follow the below steps as a workaround on SecurID Governance & Lifecycle 7.5.2 P04 through P06 to run the remote agent as a service on a Windows machine:
- Stop RemoteAgent if running already.
- Uninstall Remote Agent by running "UninstallAvAgent-NT.bat" as Administrator in AveksaAgent/bin folder.
- Download Remote agent zip from UI and re-deploy the agent on windows box (this includes removing the old AveksaAgent folder and unzipping the new agent zip into a new folder).
- Remove the below lines in wrapper.conf file present under AveksaAgent/conf folder:
- wrapper.java.classpath.3=../common/lib/log4j-1.2.17-1.0-rsa-1.jar
- wrapper.java.classpath.4=../conf
- Add below lines in the same file & save the changes:
- wrapper.java.classpath.3=../common/lib/log4j-1.2-api-2.17.2.jar
- wrapper.java.classpath.4=../common/lib/log4j-api-2.17.2.jar
- wrapper.java.classpath.5=../common/lib/log4j-core-2.17.2.jar
- wrapper.java.classpath.6=../conf
- Go to Remote agent bin folder & install agent by running "InstallAvAgent-NT.bat" file as Administrator.
- Go to Services window and start AveksaAgent service.
Related Articles
AFX Server on Windows fails to stop/start after initial successful start in RSA Governance & Lifecycle 150Number of Views Syntax errors appear Oracle database creation fails when running the setup.bat file to create the database schema when ru… 7Number of Views RSA Authention Manager Prime fails with the error "Files was unexpected at this time" while attempting to execute edtool.bat 36Number of Views Batch Jobs 31Number of Views Installing the RSA Authentication Manager 8.x Web Tier on a Windows server fails with permission errors 228Number of Views
Trending Articles
Passwordless Authentication in Windows MFA Agent for Active Directory – Quick Setup Guide RSA Authentication Manager 8.9 Release Notes (January 2026) RSA Authentication Manager Upgrade Process RSA Authentication Manager 8.7 SP2 Setup and Configuration Guide An example of SSO using SAML and ADFS with RSA Identity Management and Governance 6.9.x
Don't see what you're looking for?