components/web/tomcat-8/Solaris/tomcat.1m

   1 '\" te
   2 .\" Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.
   3 .TH tomcat8 1M "May 2015" "SunOS 5.11" "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