Allocate More Memory to Web Server

The web server is a java application and memory is allocated to the web server application when the web server is started. If insufficient memory is allocated to the web server it will run slowly and could halt. High memory utilization will generate errors in the NexOSS-Errors.log file as shown below.

If error e-mail alerts are enabled, then e-mail alerts will be sent.

From: [] 
Sent: Tuesday, December 09, 2014 7:10 PM
Subject: Error Log Message
2014-12-09 19:10:00|WebUserInterface|ERROR  |High memory utilization - used 5.734G out of 5.857G - 97.9% (presized for 5.857G)

The script is the script that starts the web server. In this script is the JAVA_OPTS parameter that defines the amount of memory allocated to the web server. Two steps are required to increase memory allocated to the web server.

  1. Edit the sh file using a text editor to increase the JAVA_OPTS parameter.

This file is located in the $NexOSS_HOME/unix/run directory. An example of the file is provided in the following text box. The JAVA_OPTS parameter is highlighted in yellow.

Example of the file.

   # This script starts the NexOSS web server which provides the web user
   # interface and other NexOSS web server applications such as route
   # provisioning and reports. 
   # The web server should be stopped using the script.
   # The JAVA_OPTS="-server -mx6000M" line specifies 6000 MB of memory should
   # be allocated to Java for running the NexOSS web server. 
   # TransNexus recommends that the server hosting NexOSS should have a 64-bit
   # operating system with a minimum of 8 GB of physical RAM and the option to
   # expand to at least 32 GB of RAM.  If the NexOSS web interface becomes slow
   # as the routing configuration grows or as the size and number of reports
   # increase, then increasing the amount of RAM allocated to Java in this
   # script may increase the performance of the NexOSS web interface.
   # Note: The script, required for NexOSS command line applications,
   # has a separate memory allocation parameter for Java.  When increasing the
   # Java memory allocation for the web server in this script, also review the
   # Java memory allocation in the script. 
   # Allocating too little or too much memory for Java will impact system
   # performance. Contact for advice on the best Java
   # memory allocation based on available RAM and your VoIP operations.
   # Note: In order for Java to use more than 2500M of RAM, the server hosting
   # NexOSS must be running a 64-bit Operating System and 64-bit version of
   # Java.
   # mail.smtp.connectiontimeout   - Socket connection timeout value in
   # milliseconds. Default is infinite timeout.
   # mail.smtp.timeout     -       Socket I/O timeout value in milliseconds.
   # Default is infinite timeout.
   EXTRA_SMTP_OPTIONS="-Dmail.smtp.connectiontimeout=2000 -Dmail.smtp.timeout=2000"
   JAVA_OPTS="-DNexOSSWebServer $EXTRA_SMTP_OPTIONS -server -mx6000M -d64"
   export JAVA_OPTS
   # Copy JDBC drivers into the WebServer's shared/lib folder
   cp -f $JDBC_DRIVER_ORA   $WEB_SERVER_SHARED_LIB 2>/dev/null
   cp -f $JDBC_DRIVER_MS    $WEB_SERVER_SHARED_LIB 2>/dev/null
   cd ../../WebServer/bin
   cd ../../unix/run
  1. Stop and restart the web server using scripts in the $NexOSS_HOME/unix/run