1 '\" te

     2 .\" Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.

     3 .TH tomcat8 1M "May 2015" "SunOS 5.12" "System Administration Commands"

     4 .SH NAME

     5 tomcat \- Apache Tomcat Version 8 overview

     6 .SH DESCRIPTION

     7 .sp

     8 .LP

     9 Apache Tomcat Version 8 (Tomcat) is implementation of

    10 the Java Servlet and JavaServer Pages technologies.

    11 .sp

    12 Tomcat can be enabled by authorized user within the service

    13 management facility (SMF), using the following fault management

    14 resource identifier (FMRI):

    15 .sp

    16 .in +2

    17 .nf

    18 svc:/network/http:tomcat8

    19 .fi

    20 .in -2

    21 .sp

    22 Tomcat enabled via SMF is executed for better security with "webserv"

    23 user credentials and with added "net_privaddr" privilege so it can be

    24 configured to listen on privileged TCP ports (e.g. 80). With default

    25 configuration Tomcat listens on TCP port 8080.

    26 .sp

    27 Unauthorized user can start Tomcat with his or her credentials using

    28 ordinary startup scripts and by setting CATALINA_BASE environment

    29 variable to path with his or her conf/, webapp/ and logs/ subdirectories

    30 (see Tomcat directory structure bellow).

    31 .sp

    32 Similarly it's possible to run multiple SMF Tomcat instances by setting

    33 CATALINA_BASE for both start and stop methods for newly created Tomcat

    34 FMRI.

    35 .sp

    36 .LP

    37 .SH FILES

    38 .sp

    39 .LP

    40 The following files specify the installation locations for Tomcat 6:

    41 .LP

    42 \fB\fB/etc/tomcat8/\fR\fR

    43 .ad

    44 .sp .6

    45 .RS 4n

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

    47 .RE

    48 

    49 .sp

    50 .ne 2

    51 .mk

    52 .na

    53 \fB\fB/usr/tomcat8/bin/\fR\fR

    54 .ad

    55 .sp .6

    56 .RS 4n

    57 Contains Tomcat startup scripts.

    58 .RE

    59 

    60 .sp

    61 .ne 2

    62 .mk

    63 .na

    64 \fB\fB/usr/tomcat8/lib/\fR\fR

    65 .ad

    66 .sp .6

    67 .RS 4n

    68 Contains Tomcat private libraries.

    69 .RE

    70 

    71 .sp

    72 .ne 2

    73 .mk

    74 .na

    75 \fB\fB/usr/tomvat8/docs/\fR\fR

    76 .ad

    77 .sp .6

    78 .RS 4n

    79 Contains Tomcat documentation in HTML format. The directory has classical

    80 WEBAPP structure and it's symbolically linked as /var/tomcat8/webapps/docs

    81 (the link is part of web/java-servlet/tomcat/tomcat-examples packages).

    82 .RE

    83 

    84 .sp

    85 .ne 2

    86 .mk

    87 .na

    88 \fB\fB/var/tomcat8/conf/\fR\fR

    89 .ad

    90 .sp .6

    91 .RS 4n

    92 Contains Tomcat configuration files. A newly-installed Tomcat

    93 contains a default \fBserver.xml\fR file. This is the main configuration file.

    94 For setting Tomcat environment variables it's possible to create here

    95 \fBsetenv.sh\fR file which is sourced during start by catalina.sh.

    96 .RE

    97 

    98 .sp

    99 .ne 2

   100 .mk

   101 .na

   102 \fB\fB/var/tomcat8/logs/\fR\fR

   103 .ad

   104 .sp .6

   105 .RS 4n

   106 Contains Tomcat log and output files.

   107 .RE

   108 

   109 .sp

   110 .ne 2

   111 .mk

   112 .na

   113 \fB\fB/var/tomcat8/temp/\fR\fR

   114 .ad

   115 .sp .6

   116 .RS 4n

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

   118 .RE

   119 

   120 .sp

   121 .ne 2

   122 .mk

   123 .na

   124 \fB\fB/var/tomcat8/webapps/\fR\fR

   125 .ad

   126 .sp .6

   127 .RS 4n

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

   129 .RE

   130 

   131 .sp

   132 .ne 2

   133 .mk

   134 .na

   135 \fB\fB/var/tomcat8/webapps/ROOT/\fR\fR

   136 .ad

   137 .sp .6

   138 .RS 4n

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

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

   141 Tomcat packages installation this directory is intentionally left empty

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

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

   144 file is part of web/java-servlet/tomcat/tomcat-examples package). The JSP file is default home 

   145 page which is shown when web/java-servlet/tomcat/tomcat-examples (and thus HTML file) is not

   146 installed. This shall allow better deployment of custom ROOT web

   147 application while maintain upgrade ability via packaging system (without

   148 loosing data).

   149 .RE

   150 

   151 .sp

   152 .ne 2

   153 .mk

   154 .na

   155 \fB\fB/var/tomcat8/webapps/ROOT.example/\fR\fR

   156 .ad

   157 .sp .6

   158 .RS 4n

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

   160 .RE

   161 

   162 .sp

   163 .ne 2

   164 .mk

   165 .na

   166 \fB\fB/var/tomcat8/webapps/examples/\fR\fR

   167 .ad

   168 .sp .6

   169 .RS 4n

   170 This directory contains web application with various ServLets and JSP

   171 examples. The directory is part of web/java-servlet/tomcat/tomcat-examples package which can

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

   173 application).

   174 .RE

   175 

   176 .sp

   177 .ne 2

   178 .mk

   179 .na

   180 \fB\fB/var/tomcat8/work/\fR\fR

   181 .ad

   182 .sp .6

   183 .RS 4n

   184 Directory where Tomcat places for web applications intermediate files

   185 (such as compiled JSP files) during its work.

   186 .RE

   187 

   188 .SH SEE ALSO

   189 .sp

   190 .LP

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