Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

Here are the recommended hardware and memory requirements for your in-

...

house  server.

Hardware Requirements

The minimum recommended hardware configuration for your Live Forms server is:

  • 2 gigahertz (GHz) 64-bit (x64) processor with 4 cores
  • 5 gigabyte (GB) of system memory
  • 100 GB hard drive

However you must size your hardware platform to your specific form usage characteristics. As the number of concurrent users and forms/flows increases so must the system memory. For a medium use production server consider increasing the JVM RAM allocation to 6 or 8 gigabytes. Refer to the memory configuration topic below.

Column
width240px

On This Page:

Table of Contents
maxLevel2

Memory Configuration

The  Tomcat bundle comes pre-configured with default memory usage settings. While the defaults are sufficient for initial usage, as your forms, business logic and submissions grow, so will the memory needs of the   server.

...

You'll see something like this in setenv.[bat,sh]:

Code Block
languagebash

set JAVA_OPTS=-Xms128m -Xmx512mXms256m -Xmx1024m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -Dfile.encoding=UTF-8 -Djava.awt.headless=true -Dfrevvo.users.path="%CATALINA_HOME%\..\data\users"Dspring.config.location="file:///%CATALINA_BASE%/conf/,file:///%CATALINA_BASE%/conf/frevvo-config.properties" -Dderby.stream.error.file="%CATALINA_BASE%/logs/derby.log"

Live Forms as a windows service

If you are running  as a Windows service, you will have to edit frevvo/tomcat/bin/service.bat line to increase the Java Heap and Permgen spaces. Here is an example of the line you need to edit in that file:

Code Block
languagebash
"%EXECUTABLE%" //US//%SERVICE_NAME% ++JvmOptions "-XX:+UseConcMarkSweepGC;-XX:+CMSClassUnloadingEnabled;-Djava.io.tmpdir=%CATALINA_BASE%\temp;-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager;-Djava.util.logging.config.file=%CATALINA_BASE%\conf\logging.properties;-Dfile.encoding=UTF-8;-Djava.awt.headless=true;-Dspring.config.location=file:///%CATALINA_BASE%/conf/,file:///%CATALINA_BASE%/conf/frevvo-config.properties;-Dderby.stream.error.file=%CATALINA_BASE%/logs/derby.log" --JvmMs 256 --JvmMx 1024

See the documentation on Tomcat Windows Service for more details.

After making these modifications to the service.bat file, you must Remove/Reinstall Live Forms as a Windows service for the changes to take effect.

Insight Server Memory Settings

By default, the <frevvo-home>\solr-5.4.1\bin\solr script,sets the maximum Java heap size to 512M (-Xmx512m). This may not be sufficient especially when reporting on/indexing a large number of submissions. It may cause "out of memory" exceptions in the  <frevvo-home>solr-5.4.1\server\logs\solr.log file. The JVM heap size can be increased to resolve this. Make sure that the machine where the Insight Server is installed has enough memory to accommodate your changes.

Follow these steps:

  1. Stop the Insight Server.
  2. Uncomment

...

  1. the set SOLR_JAVA_MEM

...

  1.  statement in the OS specific solr.in.* file (cmd for windows, sh for linux).
  2. Change the

...

  1. values.
    For example, to increase the max heap size to 1G use: -Xms512m –Xmx1g.

...

  1. For *nix OS, make sure SOLR_HEAP

...

  1.  is commented out.
  2. Restart the Insight Server.
     
Code Block
#REM Increase Java Min/Max Heap as needed to support your indexing / query needs
#SOLR_HEAP="512m"

# Expert: If you want finer control over memory options, specify them directly
# Comment out SOLR_HEAP if you are using this though, that takes precedence
set SOLR_JAVA_MEM="-Xms512m -Xmx1g"Xmx512m

Troubleshooting

Solutions for memory errors are discussed below. 

...

To solve this edit setenv.[bat,sh] - (or service.bat if you are running  as a Windows service) to increase the minimum and maximum heap size via the parameters: -Xmx and -Xms.

For example: -Xms512m to -Xmx1g. Make sure also that the machine where  is installed has enough memory installed. If you change -Xmx to 1g your machine will need more then 1g ram.

OutOfMemoryError: PermGen space

MemoryError: PermGen space
java.lang.OutOfMemoryError: PermGen space

Java has a fixed space allocated for classes and other statics that is usually enough in normal cases, but could be quickly filled up if there is on the fly code generation, significant business logic in your forms or if and the Insight server are running on the same machine.

To solve this edit setenv.[bat,sh] increase the maximum perm size via the paramenter: -XX:MaxPermSize

For example: -XX:MaxPermSize=1024mAfter making these modifications to the service.bat file, you must Remove/Reinstall Live Forms as a Windows service for the changes to take effect

Out of Memory Errors in the Insight Server log:

...