|
1 '\" te |
|
2 .\" Copyright (c) 2009, Sun Microsystems Inc. |
|
3 .\" All Rights Reserved. |
|
4 .TH tomcat 1M "October 2009" "SunOS 5.11" "System Administration Commands" |
|
5 .SH NAME |
|
6 tomcat \- Apache Tomcat Version 6 overview |
|
7 .SH DESCRIPTION |
|
8 .sp |
|
9 .LP |
|
10 Apache Tomcat Version 6 (Tomcat) is implementation of |
|
11 the Java Servlet and JavaServer Pages technologies. |
|
12 .sp |
|
13 Tomcat can be enabled by authorized user within the service |
|
14 management facility (SMF), using the following fault management |
|
15 resource identifier (FMRI): |
|
16 .sp |
|
17 .in +2 |
|
18 .nf |
|
19 svc:/network/http:tomcat6 |
|
20 .fi |
|
21 .in -2 |
|
22 .sp |
|
23 Tomcat enabled via SMF is executed for better security with "webserv" |
|
24 user credentials and with added "net_privaddr" privilege so it can be |
|
25 configured to listen on privileged TCP ports (e.g. 80). With default |
|
26 configuration Tomcat listens on TCP port 8080. |
|
27 .sp |
|
28 Unauthorized user can start Tomcat with his or her credentials using |
|
29 ordinary startup scripts and by setting CATALINA_BASE environment |
|
30 variable to path with his or her conf/, webapp/ and logs/ subdirectories |
|
31 (see Tomcat directory structure bellow). |
|
32 .sp |
|
33 .LP |
|
34 .SH FILES |
|
35 .sp |
|
36 .LP |
|
37 The following files specify the installation locations for Tomcat 6: |
|
38 .LP |
|
39 \fB\fB/etc/tomcat6/\fR\fR |
|
40 .ad |
|
41 .sp .6 |
|
42 .RS 4n |
|
43 Symbolic link to directory containing Tomcat 6 configuration files (/var/tomcat6/conf). |
|
44 .RE |
|
45 |
|
46 .sp |
|
47 .ne 2 |
|
48 .mk |
|
49 .na |
|
50 \fB\fB/usr/tomcat6/bin/\fR\fR |
|
51 .ad |
|
52 .sp .6 |
|
53 .RS 4n |
|
54 Contains Tomcat startup scripts. |
|
55 .RE |
|
56 |
|
57 .sp |
|
58 .ne 2 |
|
59 .mk |
|
60 .na |
|
61 \fB\fB/usr/tomcat6/lib/\fR\fR |
|
62 .ad |
|
63 .sp .6 |
|
64 .RS 4n |
|
65 Contains Tomcat private libraries. |
|
66 .RE |
|
67 |
|
68 .sp |
|
69 .ne 2 |
|
70 .mk |
|
71 .na |
|
72 \fB\fB/usr/tomvat6/docs/\fR\fR |
|
73 .ad |
|
74 .sp .6 |
|
75 .RS 4n |
|
76 Contains Tomcat documentation in HTML format. The directory has classical |
|
77 WEBAPP structure and it's symbolically linked as /var/tomcat6/webapps/docs |
|
78 (the link is part of web/java-servlet/tomcat/tomcat-examples packages). |
|
79 .RE |
|
80 |
|
81 .sp |
|
82 .ne 2 |
|
83 .mk |
|
84 .na |
|
85 \fB\fB/var/tomcat6/conf/\fR\fR |
|
86 .ad |
|
87 .sp .6 |
|
88 .RS 4n |
|
89 Contains Tomcat configuration files. A newly-installed Tomcat |
|
90 contains a default \fBserver.xml\fR file. This is the main configuration file. |
|
91 .RE |
|
92 |
|
93 .sp |
|
94 .ne 2 |
|
95 .mk |
|
96 .na |
|
97 \fB\fB/var/tomcat6/logs/\fR\fR |
|
98 .ad |
|
99 .sp .6 |
|
100 .RS 4n |
|
101 Contains Tomcat log and output files. |
|
102 .RE |
|
103 |
|
104 .sp |
|
105 .ne 2 |
|
106 .mk |
|
107 .na |
|
108 \fB\fB/var/tomcat6/logs/pid\fR\fR |
|
109 .ad |
|
110 .sp .6 |
|
111 .RS 4n |
|
112 File where Tomcat which is started via SMF saves its PID number. |
|
113 .RE |
|
114 |
|
115 .sp |
|
116 .ne 2 |
|
117 .mk |
|
118 .na |
|
119 \fB\fB/var/tomcat6/temp/\fR\fR |
|
120 .ad |
|
121 .sp .6 |
|
122 .RS 4n |
|
123 Directory used by the JVM for temporary files (java.io.tmpdir). |
|
124 .RE |
|
125 |
|
126 .sp |
|
127 .ne 2 |
|
128 .mk |
|
129 .na |
|
130 \fB\fB/var/tomcat6/webapps/\fR\fR |
|
131 .ad |
|
132 .sp .6 |
|
133 .RS 4n |
|
134 Tomcat Web Application Directory where are WAR files put for deployment. |
|
135 .RE |
|
136 |
|
137 .sp |
|
138 .ne 2 |
|
139 .mk |
|
140 .na |
|
141 \fB\fB/var/tomcat6/webapps/ROOT/\fR\fR |
|
142 .ad |
|
143 .sp .6 |
|
144 .RS 4n |
|
145 Directory with default (ROOT) web application which is served when URL |
|
146 is requested without further path specifier (http://hostname/). After |
|
147 Tomcat packages installation this directory is intentionally left empty |
|
148 with just index.jsp and index.htm files. The HTML file redirects |
|
149 requester to Tomcat home page which is in ROOT.example/ directory (this |
|
150 file is part of web/java-servlet/tomcat/tomcat-examples package). The JSP file is default home |
|
151 page which is shown when web/java-servlet/tomcat/tomcat-examples (and thus HTML file) is not |
|
152 installed. This shall allow better deployment of custom ROOT web |
|
153 application while maintain upgrade ability via packaging system (without |
|
154 loosing data). |
|
155 .RE |
|
156 |
|
157 .sp |
|
158 .ne 2 |
|
159 .mk |
|
160 .na |
|
161 \fB\fB/var/tomcat6/webapps/ROOT.example/\fR\fR |
|
162 .ad |
|
163 .sp .6 |
|
164 .RS 4n |
|
165 Tomcat home web application (part of web/java-servlet/tomcat/tomcat-examples package). |
|
166 .RE |
|
167 |
|
168 .sp |
|
169 .ne 2 |
|
170 .mk |
|
171 .na |
|
172 \fB\fB/var/tomcat6/webapps/examples/\fR\fR |
|
173 .ad |
|
174 .sp .6 |
|
175 .RS 4n |
|
176 This directory contains web application with various ServLets and JSP |
|
177 examples. The directory is part of web/java-servlet/tomcat/tomcat-examples package which can |
|
178 be removed if it's required (to permanently disable this web |
|
179 application). |
|
180 .RE |
|
181 |
|
182 .sp |
|
183 .ne 2 |
|
184 .mk |
|
185 .na |
|
186 \fB\fB/var/tomcat6/work/\fR\fR |
|
187 .ad |
|
188 .sp .6 |
|
189 .RS 4n |
|
190 Directory where Tomcat places for web applications intermediate files |
|
191 (such as compiled JSP files) during its work. |
|
192 .RE |
|
193 |
|
194 .SH ATTRIBUTES |
|
195 .sp |
|
196 .LP |
|
197 See attributes(5) for descriptions of the following attributes: |
|
198 .sp |
|
199 |
|
200 .sp |
|
201 .TS |
|
202 tab() box; |
|
203 cw(2.75i) |cw(2.75i) |
|
204 lw(2.75i) |lw(2.75i) |
|
205 . |
|
206 AttributeAttribute Value |
|
207 _ |
|
208 Availabilityweb/java-servlet/tomcat |
|
209 _ |
|
210 web/java-servlet/tomcat/tomcat-examples |
|
211 _ |
|
212 Interface StabilityUncommitted |
|
213 .TE |
|
214 |
|
215 .SH SEE ALSO |
|
216 .sp |
|
217 .LP |
|
218 http://tomcat.apache.org |
|
219 .SH NOTES |
|
220 .sp |
|
221 .LP |
|
222 Source for Tomcat is available on http://opensolaris.org\&. |