Skip to main content

Increase memory for SecureAuth RADIUS Server

If the SecureAuth RADIUS Server stops sending responses or is down, the administrator might see the following message in the log file:

java.lang.OutOfMemoryError : (...)

The possible cause is that the SecureAuth RADIUS Server installer did not assign enough memory to the service. As a solution, check the default value that the Java virtual machine (JVM) provides to SecureAuth RADIUS as the maximum heap size, then increase it.

Note

The directory paths you use depends on your SecureAuth RADIUS server version or the destination folder selected when you installed the SecureAuth RADIUS Server. The following are examples of default paths:

  • C:\idpRADIUS\

  • C:\Program Files (x86)\SecureAuth Corporation\SecureAuth IdP RADIUS Agent\

  • C:\Program Files\SecureAuth Corporation\SecureAuth IdP RADIUS Agent\

Check maximum heap size

  1. Open a Windows command shell as the administrator.

  2. Run a command to change the directory to where you have installed the SecureAuth RADIUS Server.

    For example:

    cd C:\Program Files\SecureAuth Corporation\SecureAuth IdP RADIUS Agent
    
  3. Run the following command to change the directory to the \bin folder.

    cd \bin\serverJre\jre\bin
  4. Run the following command to view the maximum heap size. The value appears in bytes.

    java -XX:+PrintFlagsFinal -version | findstr /i "MaxHeapSize" 

Increase maximum heap size

  1. Open a Windows command shell as the administrator.

  2. Stop the SecureAuth RADIUS service with the following command:

    sc.exe stop secureauthRadius 
  3. Go to the directory where you have installed the SecureAuth RADIUS Server.

  4. Open the installServiceBundledJRE.bat file with a text editor, such as Notepad.

    The file is located in the bin directory. For example,

    SecureAuth-RADIUS_directory\bin\installServiceBundledJRE.bat

  5. Below the line --Startup=auto ^, add the following line, where #size specifies the maximum heap size.

    --JvmOptions=-Xmx#size ^

    Append one of the following to indicate the unit of measurement:

    • k or K to indicate kilobyte (KB)

    • m or M to indicate megabytes (MB)

    • g or G to indicate gigabytes (GB)

    For example, to specify a maximum heap size of 4GB, add the following line:

    --JvmOptions=-Xmx4G ^

    Note

    As a guide for increasing the maximum heap size, set the value to use one-half to three-quarters of the Windows server size.

  6. Save and close the installServiceBundledJRE.bat file.

  7. Go to SecureAuth-RADIUS_directory\lib\.

  8. Copy the names of the two .jar files in the lib directory. For example,

    radius-server-core-release-version.jar

    secureauth-radius-core-version.jar

  9. Open a Windows command shell as the administrator.

  10. Run a command to change the directory to where you have installed the SecureAuth RADIUS Server.

    For example:

    cd C:\Program Files\SecureAuth Corporation\SecureAuth IdP RADIUS Agent
    
  11. Run the following command, substituting the names of the .jar files with the two files copied in Step 8.

    bin\\installServiceBundledJRE.bat file1.jar file2.jar
    

    For example,

    bin\\installServiceBundledJRE.bat secureauth-radius-core-version.jar radius-server-core-release-version.jar
  12. Start the SecureAuth RADIUS service with the following command:

    sc.exe start secureauthRadius