How to modify Yellowfin startup settings

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:
[code]# -----------------------------------------------------------------------------
# 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"

# -----------------------------------------------------------------------------[/code]

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 Yellowfinappserverbin. 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:
[code]rem ---------------------------------------------------------------------------
rem Yellowfin Options

rem set JRE_HOME to value chosen in installer
set JRE_HOME=C:Program FilesJavajre6

rem set CATALINA_HOME to install directory
set CATALINA_HOME=C:Yellowfinappserver

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 ---------------------------------------------------------------------------[/code]

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 tomcat5w.exe or tomcat6w.exe (depending on the version of Tomcat your installation uses).
Open a Command Prompt window and navigate to the Yellowfinappserverbin directory. The run the command:
[code]tomcat5w.exe //ES//Yellowfin[/code]
(If your installation uses Tomcat 6, replace tomcat5w.exe with 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.

[img]Image.i4?ImageId=5544[/img]

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?