te
Copyright (c) 2009, 2016, Oracle and/or its affiliates. All rights reserved.
tomcat8 1M "26 Jul 2016" "SunOS 5.11" "System Administration Commands"
NAME
tomcat - Apache Tomcat Version 8 overview
DESCRIPTION

Apache Tomcat Version 8 (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 management resource identifier (FMRI): 

svc:/network/http:tomcat8
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. 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). 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. Tomcat from version 8.5 starts with more strict umask(1) 0027. If this is not convenient, different umask value can be set by UMASK variable in setenv.sh file.

FILES

The following files specify the installation locations for Tomcat 6:

/etc/tomcat8/

Symbolic link to directory containing Tomcat 8 configuration files (/var/tomcat8/conf).

/usr/tomcat8/bin/

Contains Tomcat startup scripts.

/usr/tomcat8/lib/

Contains Tomcat private libraries.

/usr/tomvat8/docs/

Contains Tomcat documentation in HTML format. The directory has classical WEBAPP structure and it's symbolically linked as /var/tomcat8/webapps/docs (the link is part of web/java-servlet/tomcat/tomcat-examples packages).

/var/tomcat8/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/tomcat8/logs/

Contains Tomcat log and output files.

/var/tomcat8/temp/

Directory used by the JVM for temporary files (java.io.tmpdir).

/var/tomcat8/webapps/

Tomcat Web Application Directory where are WAR files put for deployment.

/var/tomcat8/webapps/ROOT/

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 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 custom ROOT web application while maintain upgrade ability via packaging system (without loosing data).

/var/tomcat8/webapps/ROOT.example/

Tomcat home web application (part of web/java-servlet/tomcat/tomcat-examples package).

/var/tomcat8/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/tomcat8/work/

Directory where Tomcat places for web applications intermediate files (such as compiled JSP files) during its work.

SEE ALSO

http://tomcat.apache.org/tomcat-8.0-doc