'\" te

.\" Copyright (c) 2009, Sun Microsystems Inc.

.\" All Rights Reserved.

.TH tomcat 1M "October 2009" "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/logs/pid\fR\fR

.ad

.sp .6

.RS 4n

File where Tomcat which is started via SMF saves its PID number.

.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/webapps/ROOT/\fR\fR

.ad

.sp .6

.RS 4n

Directory with default (ROOT) web application which is served when URL

is requested without further path specifier (http://hostname/). After

Tomcat packages installation this directory is intentionally left empty

with just index.jsp and index.htm files. The HTML file redirects

requester to Tomcat home page which is in ROOT.example/ directory (this

installed. This shall allow better deployment of custom ROOT web

application while maintain upgrade ability via packaging system (without

loosing data).

.RE

.sp

.ne 2

.mk

.na

\fB\fB/var/tomcat6/webapps/ROOT.example/\fR\fR

.ad

.sp .6

.RS 4n

.RE

.sp

.ne 2

.mk

.na

\fB\fB/var/tomcat6/webapps/examples/\fR\fR

.ad

.sp .6

.RS 4n

This directory contains web application with various ServLets and JSP

be removed if it's required (to permanently disable this web

application).

.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

_

_

_

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\&.