ADDITIONAL LNF NOTES:
=====================

To start or stop Tomcat manually, use the smf(5) commands:
	svcadm {enable|disable} tomcat55

Per default, tomcat will be started in runlevel 2, before Apache starts.
It runs as user webservd.  Make sure, that the following directories and
files below them are owned by that USER:

	@CLIENT_BASEDIR@/tomcat55/conf
	@CLIENT_BASEDIR@/tomcat55/logs
	@CLIENT_BASEDIR@/tomcat55/webapps
	@CLIENT_BASEDIR@/tomcat55/work
	@CLIENT_BASEDIR@/tomcat55/temp
	/var/log/tomcat55

To speed up the startup/shutdown process and to be sure, that tomcat
uses the JVM you want, it is recommended to set the JAVA_HOME environment
variable explicitly in @CLIENT_BASEDIR@/tomcat55/setenv.sh. Otherwise the
script tries to determine the JAVA_HOME automatically, which might lead
to unwanted or even no results!


Configuration files you should review/adjust:
=============================================
- @CLIENT_BASEDIR@/tomcat55/conf/Catalina/localhost/
	admin.xml , manager.xml:
	------------------------
	(adjust IPs, which have access to tomcats admin/manager interface)

- @CLIENT_BASEDIR@/tomcat55/conf/
	jk2.properties
	--------------
	(adjust porti[/socket]/shm parameters in case you wanna use jk2
	 e.g. with apache in front of tomcat, jni is not recommended)

	server.xml
	----------
	adjust number of server/threds -> memory/cpu consumption
	Server->Service:Catalina->Connector:* 
		minSpareThreads/maxSpareThreads
			for production servers rise them at least to 25/75)
		enableLookups
			for production servers set this to "false"

	tomcat-users.xml
	----------------
	To be able to use tomcat's admin/manager web interface, you need
	to have at least one user with admin and/or manager role. Per
	default this file need to contain those entries. E.g. add:
	<user name="admin" password="secret" roles="admin" />
	<user name="manager" password="develop" roles="manager" />
	and try http://localhost:8080/manager and http://localhost:8080/admin

- @CLIENT_BASEDIR@/tomcat55/bin
	setenv.sh
	---------
	add addtional parameters, which should be used when launching
	tomcat [tools], e.g.
	CATALINA_OPTS="-Djava.awt.headless=true \
		-Dlog4j.configuration=/etc/log4j.lcf"


NOTE:
There is also an package named LNFtomcat55-native, which enables tomcat
to use of native Apache Portable Runtime utilities, which may increase the
performance of the servlet container.

To use it, install the package and set in <Connector> of your conf/server.xml:
	protocol="org.apache.coyote.http11.Http11AprProtocol"
If you have not installed the package in a default JVM location like
/usr/jdk/instances/jdk1.5.0/jre you also need to tell tomcat, where to find
the library: In bin/setenv.sh add the following line:
	JAVA_OPTS="$JAVA_OPTS -server -d64 -Djava.library.path=tclib_location"
and replace tclib_location with the directory, where libtcnative-1.so lives.

For more information see http://tomcat.apache.org/tomcat-5.5-doc/apr.html