tomcat
(1m)
Name
tomcat - Apache Tomcat Version 6 overview
Synopsis
Please see following description for synopsis
Description
System Administration Commands tomcat(1M)
NAME
tomcat - Apache Tomcat Version 6 overview
DESCRIPTION
Apache Tomcat Version 6 (Tomcat) is implementation of the
Java Servlet and JavaServer Pages technologies.
Tomcat can be enabled by authorized user within the service
management facility (SMF), using the following fault manage-
ment resource identifier (FMRI):
svc:/network/http:tomcat6
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 lis-
tens on TCP port 8080.
Unauthorized user can start Tomcat with his or her creden-
tials using ordinary startup scripts and by setting
CATALINA_BASE environment variable to path with his or her
conf/, webapp/ and logs/ subdirectories (see Tomcat direc-
tory structure bellow).
Similarly it's possible to run multiple SMF Tomcat instances
by setting CATALINA_BASE for both start and stop methods for
newly created Tomcat FMRI.
FILES
The following files specify the installation locations for
Tomcat 6:
/etc/tomcat6/
Symbolic link to directory containing Tomcat 6 configu-
ration files (/var/tomcat6/conf).
/usr/tomcat6/bin/
Contains Tomcat startup scripts.
/usr/tomcat6/lib/
Contains Tomcat private libraries.
/usr/tomvat6/docs/
SunOS 5.11 Last change: June 2013 1
System Administration Commands tomcat(1M)
Contains Tomcat documentation in HTML format. The direc-
tory has classical WEBAPP structure and it's symboli-
cally linked as /var/tomcat6/webapps/docs (the link is
part of web/java-servlet/tomcat/tomcat-examples pack-
ages).
/var/tomcat6/conf/
Contains Tomcat configuration files. A newly-installed
Tomcat contains a default server.xml file. This is the
main configuration file. For setting Tomcat environment
variables it's possible to create here setenv.sh file
which is sourced during start by catalina.sh.
/var/tomcat6/logs/
Contains Tomcat log and output files.
/var/tomcat6/logs/pid
File where Tomcat which is started via SMF saves its PID
number.
/var/tomcat6/temp/
Directory used by the JVM for temporary files
(java.io.tmpdir).
/var/tomcat6/webapps/
Tomcat Web Application Directory where are WAR files put
for deployment.
/var/tomcat6/webapps/ROOT/
Directory with default (ROOT) web application which is
served when URL is requested without further path speci-
fier (http://hostname/). After Tomcat packages installa-
tion this directory is intentionally left empty with
just index.jsp and index.htm files. The HTML file redi-
rects requester to Tomcat home page which is in
ROOT.example/ directory (this file is part of web/java-
servlet/tomcat/tomcat-examples package). The JSP file is
default home page which is shown when web/java-
servlet/tomcat/tomcat-examples (and thus HTML file) is
not installed. This shall allow better deployment of
SunOS 5.11 Last change: June 2013 2
System Administration Commands tomcat(1M)
custom ROOT web application while maintain upgrade abil-
ity via packaging system (without loosing data).
/var/tomcat6/webapps/ROOT.example/
Tomcat home web application (part of web/java-
servlet/tomcat/tomcat-examples package).
/var/tomcat6/webapps/examples/
This directory contains web application with various
ServLets and JSP examples. The directory is part of
web/java-servlet/tomcat/tomcat-examples package which
can be removed if it's required (to permanently disable
this web application).
/var/tomcat6/work/
Directory where Tomcat places for web applications
intermediate files (such as compiled JSP files) during
its work.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+-------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------------+
|Availability | web/java-servlet/tomcat |
+---------------+-------------------------+
|Stability | Uncommitted |
+---------------+-------------------------+
SEE ALSO
http://tomcat.apache.org/tomcat-6.0-doc
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://www.apache.org/dist/tomcat/tom-
cat-6/v6.0.41/src/apache-tomcat-6.0.41-src.tar.gz
Further information about this software can be found on the
open source community website at http://tomcat.apache.org/.
SunOS 5.11 Last change: June 2013 3