Tomcat upgrade
30 October, 2009
The version of the Tomcat Application Server that ships with Yellowfin 4.1 and earlier includes a bug related to session management. Sometimes Yellowfin sessions would not timeout when they were supposed to. This could be observed on the Session Management page as some sessions having very large session times, and/or negative timeout times:
This is a bug in Tomcat version 5.5.20, which was included in Yellowfin installations. It has been fixed in newer versions of Tomcat. The latest Yellowfin installer now comes with Tomcat 5.5.27, which includes this fix (starting with Yellowfin 4.1 build 20090721). You can check which version of Tomcat your Yellowfin installation is using by checking the info page (http:///info.jsp), or through the System Information link in the Administration section (4.1 only). Look for the "Application Server" entry.
If you are using Tomcat 5.5.20 and would like to upgrade to 5.5.27, please follow these steps:
* Shut down Yellowfin
* Locate your Yellowfin installation directory
* Backup the appserver directory inside the Yellowfin directory
* Download the tomcat update from:
http://www.yellowfinteam.com/downloads/4.1/appserver-5.5.27.zip
* Unzip appserver-5.5.27.zip into the Yellowfin installation directory. Overwrite existing folders if prompted.
* Delete the file Yellowfin/appserver/bin/commons-logging-api.jar
* Delete the file Yellowfin/appserver/server/lib/commons-modeler.jar
* Delete the file Yellowfin/appserver/server/webapps/manager/WEB-INF/lib/commons-fileupload-1.0.jar
* Parse configuration parameters.
In the files:
Yellowfin/appserver/bin/catalina.bat (Windows)
Yellowfin/appserver/bin/catalina.sh (Mac/Linux/Unix)
Replace ${JDKPath} with the Java home directory, and ${INSTALL_PATH} with the Yellowfin installation directory.
In the file:
Yellowfin/appserver/bin/service.bat (Windows)
Replace ${JDKPath} with the Java home directory, and ${installer.winservice.description} with the Yellowfin service description.
In the file:
Yellowfin/appserver/conf/server.xml
Replace ${app-server-port} with the web application server port.
In the file:
Yellowfin/appserver/conf/Catalina/localhost/ROOT.xml
Replace ${INSTALL_PATH} with the Yellowfin installation directory.
You may wish to check what values these parameters are set to before starting the upgrade.
* Restart Yellowfin
This upgrade procedure will work for standard installations of Yellowfin 4.0 or 4.1 that are using Tomcat 5.5.20. If you have a non-standard installation, please contact support for more information on upgrading Tomcat.
This is a bug in Tomcat version 5.5.20, which was included in Yellowfin installations. It has been fixed in newer versions of Tomcat. The latest Yellowfin installer now comes with Tomcat 5.5.27, which includes this fix (starting with Yellowfin 4.1 build 20090721). You can check which version of Tomcat your Yellowfin installation is using by checking the info page (http:///info.jsp), or through the System Information link in the Administration section (4.1 only). Look for the "Application Server" entry.
If you are using Tomcat 5.5.20 and would like to upgrade to 5.5.27, please follow these steps:
* Shut down Yellowfin
* Locate your Yellowfin installation directory
* Backup the appserver directory inside the Yellowfin directory
* Download the tomcat update from:
http://www.yellowfinteam.com/downloads/4.1/appserver-5.5.27.zip
* Unzip appserver-5.5.27.zip into the Yellowfin installation directory. Overwrite existing folders if prompted.
* Delete the file Yellowfin/appserver/bin/commons-logging-api.jar
* Delete the file Yellowfin/appserver/server/lib/commons-modeler.jar
* Delete the file Yellowfin/appserver/server/webapps/manager/WEB-INF/lib/commons-fileupload-1.0.jar
* Parse configuration parameters.
In the files:
Yellowfin/appserver/bin/catalina.bat (Windows)
Yellowfin/appserver/bin/catalina.sh (Mac/Linux/Unix)
Replace ${JDKPath} with the Java home directory, and ${INSTALL_PATH} with the Yellowfin installation directory.
In the file:
Yellowfin/appserver/bin/service.bat (Windows)
Replace ${JDKPath} with the Java home directory, and ${installer.winservice.description} with the Yellowfin service description.
In the file:
Yellowfin/appserver/conf/server.xml
Replace ${app-server-port} with the web application server port.
In the file:
Yellowfin/appserver/conf/Catalina/localhost/ROOT.xml
Replace ${INSTALL_PATH} with the Yellowfin installation directory.
You may wish to check what values these parameters are set to before starting the upgrade.
* Restart Yellowfin
This upgrade procedure will work for standard installations of Yellowfin 4.0 or 4.1 that are using Tomcat 5.5.20. If you have a non-standard installation, please contact support for more information on upgrading Tomcat.