Tuning Your JVM

Web Engagement 8.1.2 allows you to tune your JVM parameters, which is especially important with respect to the virtual memory allocated to the JVM. You can modify your JVM parameters in the setenv.bat or setenv.sh file that is located at Web Engagement installation directory\servers\frontend and Web Engagement installation directory\servers\backend.

Tuning Your Memory Allocation

Out of the box, the setenv.bat and setenv.sh files have the following memory settings:

-Xms512m -Xmx1024m -XX:MaxPermSize=250m

If you want to change these settings, update the appropriate values and restart the related Web Engagement Server (Frontend or Backend).

Enabling the JMX Port

You can monitor the JVM where your Web Engagement Server (Frontend or Backend) is running by using some of the standard Java tools distributed with the JDK, such as JConsole or Visual VM. Since these tools work through the JMX port, the Web Engagement Server (Frontend or Backend) needs to open this port on startup.

Out of the box, the setenv.bat and setenv.sh files contain all of the settings you need to turn on JMX access. Here's what setenv.bat looks like:

:: Uncomment to enable JMX Remote
:: set JMX_PORT=7199
:: set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote ^
:: -Dcom.sun.management.jmxremote.port=%JMX_PORT% ^
:: -Dcom.sun.management.jmxremote.ssl=false ^
:: -Dcom.sun.management.jmxremote.authenticate=false

As you can see, the JMX parameters are turned off by default. To enable JMX access, you need to uncomment these settings.

Note: Opening the JMX port without adequate security can be risky. See the JMX monitoring and management documentation for information about how to tune your security settings when using JMX to monitor your JVM.

Applying Parameters to Your Windows Service

It is important to understand that any changes you make to the setenv.bat file will not be applied to the Windows service that starts Web Engagement Server (Frontend or Backend). Here's how to apply the parameters from setenv.bat to your Windows service:

1. Make all necessary changes to setenv.bat.
2. Ensure that your Web Engagement Server can be started successfully from the command line.
3. Execute the server.bat remove command to remove your existing Windows service.
4. Execute the server.bat install command to install a new Windows service.

After you finish these steps, your Windows service will be synchronized with server.bat.