Services do not start with error "Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper" in RSA Authentication Manager 8.x

[#1]

Article Number

000037802

Applies To

RSA Product Set: SecurID
RSA Product/Service Type:  Authentication Manager 
RSA Version/Condition: 8.x

Issue

Authentication Manager services fail to start. When checking /opt/rsa/am/server/logs/AdminServerWrapper.log, the following error is reported

STATUS | wrapper  | main    | 2019/08/02 20:59:21 | <-- Wrapper Stopped
STATUS | wrapper  | main    | 2019/08/02 21:00:06 | --> Wrapper Started as Daemon
STATUS | wrapper  | main    | 2019/08/02 21:00:07 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 21:00:07 | JVM exited while loading the application.
INFO   | jvm 1    | main    | 2019/08/02 21:00:07 | Error: Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper
STATUS | wrapper  | main    | 2019/08/02 21:00:11 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 21:00:11 | JVM exited while loading the application.
INFO   | jvm 2    | main    | 2019/08/02 21:00:11 | Error: Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper
STATUS | wrapper  | main    | 2019/08/02 21:00:15 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 21:00:15 | JVM exited while loading the application.
INFO   | jvm 3    | main    | 2019/08/02 21:00:15 | Error: Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper
STATUS | wrapper  | main    | 2019/08/02 21:00:20 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 21:00:20 | JVM exited while loading the application.
INFO   | jvm 4    | main    | 2019/08/02 21:00:20 | Error: Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper
STATUS | wrapper  | main    | 2019/08/02 21:00:24 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 21:00:24 | JVM exited while loading the application.
INFO   | jvm 5    | main    | 2019/08/02 21:00:24 | Error: Could not find or load main class com.rsa.installfwrk.serverController.WeblogicServiceWrapper
FATAL  | wrapper  | main    | 2019/08/02 21:00:24 | There were 5 failed launches in a row, each lasting less than 300 seconds.  Giving up.
FATAL  | wrapper  | main    | 2019/08/02 21:00:24 |   There may be a configuration problem: please check the logs.
STATUS | wrapper  | main    | 2019/08/02 21:00:24 | <-- Wrapper Stopped

Cause

The framework-serverController-<version>.jar file is missing from the server, causing WebLogic to fail to initialize the services. This file should be located in /opt/rsa/am/config/lib.

Resolution

To solve this issue:

1. Copy the missing framework-serverController-<version>.jar file from another Authentication Manager deployment of the same version. 
2. Launch an SSH client, such as PuTTY.
3. Login to the primary Authentication Manager server as rsaadmin and enter the operating system password.

Note that during Quick Setup another user name may have been selected. Use that user name to login.

4. Place the framework-serverController-<version>.jar into /opt/rsa/am/config/lib.
5. Make sure that the file has the correct owner and permissions:

rsaadmin@am83:/opt/rsa/am/config/lib> ls -l
total 16
-rw-r--r-- 1 rsaadmin rsaadmin 9750 Aug  2 19:55 framework-serverController-8.3.0.0.0.jar

6. Start the services using the following command

/opt/rsa/am/server/rsaserv restart all