1 '\" te

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

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

     4 .SH NAME

     5 tomcat \- Apache Tomcat Version 6 overview

     6 .SH DESCRIPTION

     7 .sp

     8 .LP

     9 Apache Tomcat Version 6 (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:tomcat6

    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/tomcat6/\fR\fR

    43 .ad

    44 .sp .6

    45 .RS 4n

    46 Symbolic link to directory containing Tomcat 6 configuration files (/var/tomcat6/conf).

    47 .RE

    48 

    49 .sp

    50 .ne 2

    51 .mk

    52 .na

    53 \fB\fB/usr/tomcat6/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/tomcat6/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/tomvat6/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/tomcat6/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/tomcat6/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/tomcat6/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/tomcat6/logs/pid\fR\fR

   114 .ad

   115 .sp .6

   116 .RS 4n

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

   118 .RE

   119 

   120 .sp

   121 .ne 2

   122 .mk

   123 .na

   124 \fB\fB/var/tomcat6/temp/\fR\fR

   125 .ad

   126 .sp .6

   127 .RS 4n

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

   129 .RE

   130 

   131 .sp

   132 .ne 2

   133 .mk

   134 .na

   135 \fB\fB/var/tomcat6/webapps/\fR\fR

   136 .ad

   137 .sp .6

   138 .RS 4n

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

   140 .RE

   141 

   142 .sp

   143 .ne 2

   144 .mk

   145 .na

   146 \fB\fB/var/tomcat6/webapps/ROOT/\fR\fR

   147 .ad

   148 .sp .6

   149 .RS 4n

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

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

   152 Tomcat packages installation this directory is intentionally left empty

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

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

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

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

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

   158 application while maintain upgrade ability via packaging system (without

   159 loosing data).

   160 .RE

   161 

   162 .sp

   163 .ne 2

   164 .mk

   165 .na

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

   167 .ad

   168 .sp .6

   169 .RS 4n

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

   171 .RE

   172 

   173 .sp

   174 .ne 2

   175 .mk

   176 .na

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

   178 .ad

   179 .sp .6

   180 .RS 4n

   181 This directory contains web application with various ServLets and JSP

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

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

   184 application).

   185 .RE

   186 

   187 .sp

   188 .ne 2

   189 .mk

   190 .na

   191 \fB\fB/var/tomcat6/work/\fR\fR

   192 .ad

   193 .sp .6

   194 .RS 4n

   195 Directory where Tomcat places for web applications intermediate files

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

   197 .RE

   198 

   199 .SH SEE ALSO

   200 .sp

   201 .LP

   202 http://tomcat.apache.org/tomcat-6.0-doc