Eliminating profile creation OutOfMemoryErrors on Solaris (deprecated)

When you are creating or augmenting an IBM® Business Monitor profile on Solaris (deprecated), an out of memory error (java.lang.OutOfMemoryError: PermGen space) might occur and cause the profile creation to hang. To avoid or resolve this error, you might need to set or update the value for the MaxPermSize Java Virtual Machine (JVM) parameter in one or more of the IBM Business Monitor files.

The error message is recorded in the app_server_root/logs/manageprofiles/wsadminListener.log file, and typically takes the following form:
  • Error encountered running wsadmin: PermGen space java.lang.OutOfMemoryError: PermGen space
Tip: Although tests have shown that a value of 256M is sufficient for the profile creation or augmentation to complete successfully, your system resources and requirements might require you to set different MaxPermSize values. In the following procedure, a value of 256M is used as an example.

Procedure

  1. In the app_server_root/profileTemplates/wbmonitor/actions directory, open the addNodeMetadata.ant file, locate the <condition> element, and then set the MaxPermSize parameter to an appropriate value:
    <condition property="wsadmin.jvmargs" value="-XX:MaxPermSize=256m" else="-Dwbm.var1.needed=TRUE">
  2. Optional: Update the MaxPermSize parameter in the following .sh files:
    1. In the app_server_root/bin directory, open the launchWsadminListener.sh file and modify the PERF_JVM_OPTIONS value as follows:
      PERF_JVM_OPTIONS="-Xms256m -Xmx256m -XX:PermSize=256m -XX:MaxPermSize=256m" ;;
    2. In the app_server_root/bin directory, open the WASPostUpgrade.sh file and modify the PERF_JVM_OPTIONS value as follows:
      PERF_JVM_OPTIONS="-Xms512m -Xmx768m -XX:PermSize=128m -XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass -XX:MaxPermSize=256m" ;;
    3. In the app_server_root/bin directory, open the wsadmin.sh file and modify the PERF_JVM_OPTIONS value as follows:
      PERF_JVM_OPTIONS="-Xms256m -Xmx256m -XX:MaxPermSize=256m" ;;