Error "Unrecognized VM option 'MetaSpaceSize=256m'" and services do not start on RSA Authentication Manager 8.3
2 years ago
Originally Published: 2019-08-02
Article Number
000040991
Applies To
RSA Product Set: SecurID
RSA Product/Service Type: Authentication Manager 
RSA Version/Condition: 8.3
Issue
RSA Authentication Manager 8.3 services fail to start. The /opt/rsa/am/server/wrapper/logs/AdminServerWrapper.log shows the following error:
STATUS | wrapper  | main    | 2019/08/02 20:11:48 | <-- Wrapper Stopped
STATUS | wrapper  | main    | 2019/08/02 20:17:48 | --> Wrapper Started as Daemon
STATUS | wrapper  | main    | 2019/08/02 20:17:49 | Launching a JVM...
ERROR  | wrapper  | main    | 2019/08/02 20:17:49 | JVM exited while loading the application.
INFO   | jvm 1    | main    | 2019/08/02 20:17:49 | Unrecognized VM option 'MetaSpaceSize=256m'
INFO   | jvm 1    | main    | 2019/08/02 20:17:49 | Error: Could not create the Java Virtual Machine.
INFO   | jvm 1    | main    | 2019/08/02 20:17:49 | Error: A fatal exception has occurred. Program will exit.
Cause
MetaSpaceSize is not a correct option for the WebLogic version installed on Authentication Manager 8.3. It should be PermSize instead. 
Resolution
To solve this issue:
  1. Launch an SSH client, such as PuTTY.
  2. 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.

  1. Navigate to /opt/rsa/am/server/wrapper:
cd /opt/rsa/am/server/wrapper
  1. List the directory contents to see the four configuration files:
rsaadmin@am83:/opt/rsa/am/server/wrapper> ll
total 36
-r-------- 1 rsaadmin rsaadmin 7777 Aug  2 20:16 AdminServerWrapper.conf
-r-------- 1 rsaadmin rsaadmin 7571 Aug  2 20:17 BiztierServerWrapper.conf
-r-------- 1 rsaadmin rsaadmin 7569 Aug  2 20:17 ConsoleServerWrapper.conf
-r-------- 1 rsaadmin rsaadmin 7132 Aug  2 19:55 RadiusOCServerWrapper.conf
  1. Open the files one by one using a text editor such as vi.
  2. In each file look for:
wrapper.java.additional.50=-XX:MetaSpaceSize=256m
  1. Press to enter Insert mode.
  2. Change MetaSpaceSize to PermSize:
wrapper.java.additional.50=-XX:PermSize=256m
  1. Press ESC to exit Insert mode.
  2. Type :wq! and Enter to save and exit.
  3. Repeat steps 5 - 10 on all four configuration files. 
  4. Type the following command to start the services:
/opt/rsa/am/server/rsaserv restart all