mPower Server: Tomcat Platform

Describes platform configuration and software installation for the mPower server on Tomcat.

This document assumes you have a working knowledge of Tomcat. Contact your NetSol representative for more information.

Tomcat Installation and Configuration

Beginning with LeasePak 6.2a, mPower is no longer backwards compatible with versions of JDK prior to 1.6 or versions of Tomcat prior to 6

Download Tomcat 4 (version ) from the Apache Tomcat (Apache Jakarta Project) site (jakarta.apache.org/tomcat) and follow the instructions for installing the software.

tomcat4.conf

If you have a tomcat4.conf (or tomcat.conf) file in your CATALINA_HOME/conf directory (CATALINA_HOME represents the root directory of the Tomcat installation on your machine), you may need to edit it for the following environment variables:

	JAVA_HOME="java_root_dir"
	JAVA_OPTS="-Xmx768M"
	CATALINA_HOME="tomcat_root_dir"
	JASPER_HOME="tomcat_root_dir"
	CATALINA_TMPDIR="tomcat_tmpdir"
	TOMCAT_USER="tomcat_user"
	SHUTDOWN_WAIT=30
	CATALINA_PID=tomcat_pid_file
	

where java_root_dir is the root directory of the Java installation on your machine (for example, /usr/java/j2sdkmp_java).

JAVA_OPTS is set to a percentage of the total system memory. In this example, where the server is exclusively an mPower server, JAVA_OPTS is set to 75% of total system memory. System memory is 1 GB, so the variable is set to 768 MB. If you are installing LeasePak and mPower on the same server, adjust the amount accordingly. Contact your NetSol representative for assistance if needed.

The variable tomcat_root_dir is the root directory of the Tomcat installation on your machine (for example, /var/tomcat4), tomcat_tmpdir is the temp file directory under the Tomcat root directory (for example, /var/tomcat4/temp), tomcat_user is the name of the Tomcat user, SHUTDOWN_WAIT is set to 30 seconds (the default), and tomcat_pid_file is the file where the system stores the Tomcat process ID (PID) after Tomcat starts (for example, /var/run/tomcat4.pid.

If the tomcat4.conf file does not exist, you may need to instead edit the Tomcat startup script in /etc/init.d (file will be either tomcat4 or tomcat) to set values for JAVA_HOME and JAVA_OPTS.

Startup and Shutdown Scripts

If you install Tomcat directly (for example, using tar instead of the RPM or package installer), you may just have the script files startup.sh and shutdown.sh in your tomcat_home_dir/bin directory (where tomcat_root_dir is the root directory of Tomcat on your machine--for example, /var/tomcat4). In this case, you will need to use export or setenv to set values for JAVA_HOME and JAVA_OPTS before using these scripts. Contact your NetSol representative for assistance if needed.