How do I modify the Yellowfin startup settings?

Note: You should not be making changes to any startup files without a full understanding of the effects, or under direct instruction from the support team.

As part of Yellowfin's startup process, certain settings and system parameters are initialised before the system is up and running.
These settings are configured in different places, depending on what Operating System you run Yellowfin on, and what method you use to start Yellowfin.

Linux/OS X

If you are using Linux/OS X then you would be starting Yellowfin via the startup.sh file.
To modify the startup settings, edit the file catalina.sh - located under Yellowfin/appserver/bin/.
There is a section near the top of this file called "Yellowfin Options". You should not make any changes except in this section.

Example of catalina.sh file:

# -----------------------------------------------------------------------------
# Yellowfin Options

# set JAVA_HOME to value chosen in installer
JAVA_HOME="/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home"

# set CATALINA_HOME to install directory
CATALINA_HOME="/Applications/Yellowfin/appserver"

# enable headless mode
CATALINA_OPTS=-Djava.awt.headless=true

# Memory limits.
# Use these options to set the Java memory limits.
# -Xms128m sets the initial Java heap size to 128Mb
# -Xmx512m sets the maximum Java heap size to 512Mb
JAVA_OPTS="$JAVA_OPTS -Xms128m -Xmx512m"

# To set the thread stack size uncomment the following line:
# JAVA_OPTS="$JAVA_OPTS -Xss2048k"

# If you are experiencing "java.lang.OutOfMemoryError: PermGen space"
# errors, uncomment the following line:
# JAVA_OPTS="$JAVA_OPTS -XX:PermSize=64m -XX:MaxPermSize=128m"

# Fixes for JPivot compatibility with Axis and Java 1.6
JAVA_OPTS="$JAVA_OPTS -Djavax.xml.soap.MessageFactory=org.apache.axis.soap.MessageFactoryImpl"
JAVA_OPTS="$JAVA_OPTS -Djavax.xml.soap.SOAPConnectionFactory=org.apache.axis.soap.SOAPConnectionFactoryImpl"
JAVA_OPTS="$JAVA_OPTS -Djavax.xml.soap.SOAPFactory=org.apache.axis.soap.SOAPFactoryImpl"
# JAVA_OPTS="$JAVA_OPTS -Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl"

# -----------------------------------------------------------------------------

Microsoft Windows - startup.bat
If you are using Windows and you start Yellowfin either by the Start Menu links, or manually by running startup.bat, the startup settings are located in the file catalina.bat - located under Yellowfin\appserver\bin\. Edit this file.
There is a section near the top of this file called "Yellowfin Options". You should not make any changes except in this section.

Example of catalina.bat file:

rem ---------------------------------------------------------------------------
rem Yellowfin Options

rem set JRE_HOME to value chosen in installer
set JRE_HOME=C:\Program Files\Java\jre6

rem set CATALINA_HOME to install directory
set CATALINA_HOME=C:\Yellowfin\appserver

rem Memory limits.
rem Use these options to set the Java memory limits.
rem -Xms128m sets the initial Java heap size to 128Mb
rem -Xmx512m sets the maximum Java heap size to 512Mb
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m

rem To set the thread stack size uncomment the following line:
rem JAVA_OPTS="$JAVA_OPTS -Xss2048k"

rem If you are experiencing "java.lang.OutOfMemoryError: PermGen space"
rem errors, uncomment the following line:
rem set JAVA_OPTS=%JAVA_OPTS% -XX:PermSize=64m -XX:MaxPermSize=128m

rem Fixes for JPivot compatibility with Axis and Java 1.6
set JAVA_OPTS=%JAVA_OPTS% -Djavax.xml.soap.MessageFactory=org.apache.axis.soap.MessageFactoryImpl
set JAVA_OPTS=%JAVA_OPTS% -Djavax.xml.soap.SOAPConnectionFactory=org.apache.axis.soap.SOAPConnectionFactoryImpl
set JAVA_OPTS=%JAVA_OPTS% -Djavax.xml.soap.SOAPFactory=org.apache.axis.soap.SOAPFactoryImpl
rem set JAVA_OPTS=%JAVA_OPTS% -Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl

rem ---------------------------------------------------------------------------

Microsoft Windows - system service
If you are using Windows and you start Yellowfin using a system service, the startup settings can be modified by running tomcat5X.exe.
Where X put in Tomcat version number. E.g. Tomcat8.exe
Open a Command Prompt window and navigate to the Yellowfin\appserver\bin\ directory. The run the command:

tomcatXw.exe //ES//Yellowfin

If your installation uses Tomcat 8 use tomcat8w.exe, if Tomcat 6, tomcat6w.exe
This command will bring up the service properties window. On the "Java" tab, you can modify the startup Java Options and memory limit settings.

Related Posts:
JVM Max Memory Settings
How to Increase PermGen space - OutOfMemoryError
How to see real cache size of Yellowfin on Process monitor
MySQL database behind SSL - How do I connect?

Is this article helpful?
2 0 1