Memory settings for OneClick 8.1.0 on a Windows server causes the SPECTRUM Tomcat Service to stop on Windows (Legacy KB ID CNC TS25286 )

Document ID : KB000051827
Last Modified Date : 14/02/2018
Show Technical Document Details
FOR WINDOWS:     Go to $SPECROOT/Tomcat/bin/OneClickService.conf


You will see something like this:


jvm_opt=-Djava.class.path=c:/win32app/SPECTRUM/tomcat\\bin\\bootstrap.jar;c:/win32app/SPECTRUM/Java\\lib\\tools.jar;c:/win32app/SPECTRUM/Java\\jre\\lib\\heapdebug.jar
jvm_opt=-Xmx512M
jvm_opt=-XX:+HeapDumpOnOutOfMemoryError
jvm_opt=-Djavax.net.ssl.trustStore=c:/win32app/SPECTRUM/Java/jre/lib/security/cacerts
jvm_opt=-Djavax.net.ssl.trustStorePassword=changeit
jvm_opt=-Dcatalina.home=c:/win32app/SPECTRUM/tomcat
jvm_opt=-Djava.awt.headless=true
jvm_opt=-Xbootclasspath/a:c:/win32app/SPECTRUM/Java\\jre\\lib\\heapdebug.jar
jvm_opt=-agentpath:c:/win32app/SPECTRUM/Java\\jre\\bin\\heapdebug.dll=c:/win32app/SPECTRUM/tomcat\\bin\\heap_debug_options


jvm_lib=c:/win32app/SPECTRUM/Java\\jre\\bin\\server\\jvm.dll
start_class=org.apache.catalina.startup.Bootstrap
start_param=start
stop_class=org.apache.catalina.startup.Bootstrap
stop_param=stop
log_file=c:/win32app/SPECTRUM/tomcat\\logs\\stdout.log
service_name=SpectrumTomcat
service_display_name=SpectrumTomcat


 


Edit the line "jvn_opt=-Xmx***M" to a value from 512 to 1024 (This is the maximum value).


Restart/Start the Windows service "Spectrum Tomcat" 


Please note, that 1024 (MB) is the maximum value that can be set for the OneClick memory setting, either on the Webserver or in the OneClickService.conf file.


FOR SOLARIS/LINUX:   Go to the $SPECROOT/Tomcat/bin directory and edit file "catalina.sh"
 

You will see something like this:

# This needs to be done after setclasspath.sh as it sets the JAVA_OPTS as well
JAVA_OPTS="-DOneClick -Xmx512M -XX:+HeapDumpOnOutOfMemoryError -server -Xbootcla
sspath/a:$JAVA_HOME/jre/lib/heapdebug.jar -agentpath:$JAVA_HOME/jre/bin/heapdebu
g.so=$CATALINA_HOME/bin/heap_debug_options -Djava.awt.headless=true"

Edit the -Xmx paramter to "-Xmx***M" to a value from 512 to 1024 (This is the maximum value)


Related Issues/Questions:

Spectrum Tomcat service unable to start



Windows could not start Spectrum Tomcat on the Local computer: Code 100

Problem Environment:
SPECTRUM
SPECTRUM 8.1.0
Solaris 2.9
Solaris 2.10
Microsoft Windows
Tomcat

Causes of this problem:
After changing the memory allocation to more than 1024 (MB) the "Administration" tab, the windows service "Spectrum Tomcat" does not restart and fails with the following error: 

Windows could not start Spectrum Tomcat on the Local computer: Code 100



Additional Information:
Note - for Spectrum 8.0 (and before) the Windows SpectrumTomcat covers the Xmx parameter in the Registry under the service configuation (see HKey_Local_Machine->System->CurrentControlSet->Services->SpectrumTomcat.  For Solaris that is set via the Tomcat startup using script WOtomcat covering parameter -Xmx.


(Legacy KB ID CNC TS25286 )