EASA is a Java application, and it uses Tomcat8.
A customer may wish to modify the default settings such as:
The EASA Server service Tomcat8 is installed automatically by the installer.
Tomcat8 is the default name when EASA is installed to run as a Windows service.
To rename the service:
A machine running as an Excel Server requires more desktop heap memory than other EASA machines (see below).
An EASAP with a large spreadsheet may require 300 MB or more per simultaneous User using both Excel and Java related resources.
To be clear, both Excel and Java memory requirements grow with spreadsheet size and complexity for an Excel/EASAP Server.
Set the current Java memory setting for an EASA Server at
'EASA > Administrator > System > Diagnostics > Summary > Maximum allowed memory usage'
Change the Java intial and max heap size (both default to 2200MB) by running <EASAROOT>\tomcat\bin\tomcat8w.exe: Under EASA Tomcat8 Properties > Java set 'Initial memory pool' and 'Maximum memory pool'
An 'OutOfMemoryError' in the server logs indicates this setting needs to be raised.
For EASA run as an application, modify the JAVA_OPTS environment variable:
The default data for this registry value in 'regedit.exe' will look something like the following (all on one line),
%SystemRoot%\system32\csrss.exe ObjectDirectory=\Windows SharedSection=1024,20480,768 Windows=On SubSystemType=Windows ServerDll=basesrv,1 ServerDll=winsrv:UserServerDllInitialization,3 ServerDll=winsrv:ConServerDllInitialization,2 ProfileControl=Off MaxRequestThreads=16
The numeric values following SharedSection= control how desktop heap is allocated (in KB).
Set the non-interactive desktop heap (the third value, '768' above) to '4096' to support up to 40 Excel processes.
The third value (768 above) may be increased up to but not to exceed the second value.
Linux must be manually configured, see Install EASA as a Linux service.
By default, EASA will run as root on a Linux computer. The steps below will configure EASA to run as a different user:
The Linux EASA Server is now configured to run as a user 'easauser'
To change the EASA maximum memory setting on a Linux computer:
The Builder and Compute Server Config Tool are combined in a standalone Java application (historically called the 'EASA Client')
To raise the maximum heap allocation modify <EASA_CLIENT>\client\easaclient5x.vmoptions (below)
# Enter one VM parameter per line # For example, to adjust the maximum memory usage to 512 MB, uncomment the following line: # -Xmx512m # To include another file, uncomment the following line: # -include-options [path to other .vmoption file]
Dependencies calculation for a large EASAP may require up to 4096m.
An 'OutOfMemoryError' in the EASAP Builder logs (eg. C:\Users\<username>\.easa\data\logs ) indicates this setting needs to be raised.
The Java8 max heap size defaults to 25% of the physical system memory.
To find this value heap size and other values: