'\" te
.\" Copyright (c) 2008, Sun Microsystems Inc.
.\" All Rights Reserved.
.TH tomcat 1M "November 2008" "SunOS 5.11" "System Administration Commands"
.SH NAME
tomcat \- Apache Tomcat Version 6 overview
.SH DESCRIPTION
.sp
.LP
Apache Tomcat Version 6 (Tomcat) is implementation of
the Java Servlet and JavaServer Pages technologies.
.sp
Tomcat can be enabled by authorized user within the service
management facility (SMF), using the following fault management
resource identifier (FMRI):
.sp
.in +2
.nf
svc:/network/http:tomcat6
.fi
.in -2
.sp
Tomcat enabled via SMF is executed for better security with "webserv"
user credentials and with added "net_privaddr" privilege so it can be
configured to listen on privileged TCP ports (e.g. 80). With default
configuration Tomcat listens on TCP port 8080.
.sp
Unauthorized user can start Tomcat with his or her credentials using
ordinary startup scripts and by setting CATALINA_BASE environment
variable to path with his or her conf/, webapp/ and logs/ subdirectories
(see Tomcat directory structure bellow).
.sp
.LP
.SH FILES
.sp
.LP
The following files specify the installation locations for Tomcat 6:
.LP
\fB\fB/etc/tomcat6/\fR\fR
.ad
.sp .6
.RS 4n
Symbolic link to directory containing Tomcat 6 configuration files (/var/tomcat6/conf).
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/tomcat6/bin/\fR\fR
.ad
.sp .6
.RS 4n
Contains Tomcat startup scripts.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/tomcat6/lib/\fR\fR
.ad
.sp .6
.RS 4n
Contains Tomcat private libraries.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/tomvat6/docs/\fR\fR
.ad
.sp .6
.RS 4n
Contains Tomcat documentation in HTML format. The directory has classical
WEBAPP structure and it's symbolically linked as /var/tomcat6/webapps/docs.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/var/tomcat6/conf/\fR\fR
.ad
.sp .6
.RS 4n
Contains Tomcat configuration files. A newly-installed Tomcat
contains a default \fBserver.xml\fR file. This is the main configuration file.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/var/tomcat6/logs/\fR\fR
.ad
.sp .6
.RS 4n
Contains Tomcat log and output files.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/var/tomcat6/temp/\fR\fR
.ad
.sp .6
.RS 4n
Directory used by the JVM for temporary files (java.io.tmpdir).
.RE

.sp
.ne 2
.mk
.na
\fB\fB/var/tomcat6/webapps/\fR\fR
.ad
.sp .6
.RS 4n
Tomcat Web Application Directory where are WAR files put for deployment.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/var/tomcat6/work/\fR\fR
.ad
.sp .6
.RS 4n
Directory where Tomcat places for web applications intermediate files
(such as compiled JSP files) during its work.
.RE

.SH ATTRIBUTES
.sp
.LP
See attributes(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
AttributeAttribute Value
_
AvailabilitySUNWtcatr
_
SUNWtcatu
_
Interface StabilityUncommitted
.TE

.SH SEE ALSO
.sp
.LP
http://tomcat.apache.org
.SH NOTES
.sp
.LP
Source for Tomcat is available on http://opensolaris.org\&.