AFX Server on Windows fails to stop/start after initial successful start in RSA Governance & Lifecycle
2 years ago
Article Number
000071796
Applies To
  • RSA Governance & Lifecycle 8.0
Issue
After a successful installation of a remote AFX Server on Microsoft Windows Server, the AFX services start fine (right-click StartAFXServer.bat and run as administrator) for the very first time.  However, the AFX server fails to stop (right-click on StopAFXServer.bat and run as administrator) or start (right-click StartAFXServer.bat and run as administrator) on subsequent attempts.

When stopping or starting the AFX service, the command line window quickly disappears and does not properly run. The expected behavior is for a command line window to appear and complete the stop or start process and then prompt the user to press any key to close the window.

When the service fails to stop or start, the following is logged in afx_windows.log:
Mon 11/27/2023 13:05:41.94
Starting task "stop"
Checking for access rights
Access rights available
The syntax of the command is incorrect.

This issue can also result in a failure to auto-upgrade the AFX server from version 8.0 to 8.0.0 P01, when the RSA Governance & Lifecycle Cloud is upgraded from 8.0 to 8.0.0 P01, as the auto-restart (a required step in the upgrade process) of AFX server would fail.
Cause
If the Windows System Variable JAVA_HOME is set to a path ending with a backslash character (\), for example:
C:\Users\Administrator>echo %JAVA_HOME%
C:\Program Files\Eclipse Adoptium\jdk-8.0.362.9-hotspot\
Then the AFX Server stop/start script incorrectly updates the path set in the System Variable JAVA_HOME by replacing the backslash character (\) with a double-quote character ("), hence corrupting the path to the JDK.
Resolution
This issue has been resolved in the following version/patch:
  • RSA Governance & Lifecycle 8.0.0 P02
Workaround
A workaround is to remove the ending backslash character (\), or the ending double-quote character (") that may have replaced the backslash character due to this issue, from the path set in the Windows System Variable JAVA_HOME.

To do so, login as an administrator on the Windows host, right-click Start > System > Advanced System Settings (under Related settings) > Advanced tab > click Environment Variables... > select JAVA_HOME under System variables > click Edit to update the path, then click OK > OK again to save the changes.
Notes
AFX Server installation on Microsoft Windows Server is only supported with RSA Governance & Lifecycle Cloud.