Gitiles
Code Review Sign In
source.supwisdom.com / UniIdentify / tomcat / 67d615191938bb60e9b73af6701f5339749950ca / . / tomcat-uid / webapps / docs / introduction.html
blob: 361c2faa7e5380dd32e49a9bcc94fcc1b058a744 [file] [log] [blame]
Hongqing Liu71898292014-10-15 13:31:32 +0800[diff] [blame]1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat 6.0 (6.0.41) - Introduction</title><meta name="author" content="Robert Slifka"><style type="text/css" media="print">
Hongqing Liufd5ee812014-05-10 16:32:51 +0800[diff] [blame]2 .noPrint {display: none;}
3 td#mainBody {width: 100%;}
4 </style></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img src="./images/tomcat.gif" align="right" alt="
5 The Apache Tomcat Servlet/JSP Container
Hongqing Liu71898292014-10-15 13:31:32 +0800[diff] [blame]6 " border="0"></a></td><td><h1><font face="arial,helvetica,sanserif">Apache Tomcat 6.0</font></h1><font face="arial,helvetica,sanserif">Version 6.0.41, May 19 2014</font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="./images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr></table><table border="0" width="100%" cellspacing="4"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade="noshade" size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="nowrap" class="noPrint"><p><strong>Links</strong></p><ul><li><a href="index.html">Docs Home</a></li><li><a href="http://wiki.apache.org/tomcat/FAQ">FAQ</a></li></ul><p><strong>User Guide</strong></p><ul><li><a href="introduction.html">1) Introduction</a></li><li><a href="setup.html">2) Setup</a></li><li><a href="appdev/index.html">3) First webapp</a></li><li><a href="deployer-howto.html">4) Deployer</a></li><li><a href="manager-howto.html">5) Manager</a></li><li><a href="realm-howto.html">6) Realms and AAA</a></li><li><a href="security-manager-howto.html">7) Security Manager</a></li><li><a href="jndi-resources-howto.html">8) JNDI Resources</a></li><li><a href="jndi-datasource-examples-howto.html">9) JDBC DataSources</a></li><li><a href="class-loader-howto.html">10) Classloading</a></li><li><a href="jasper-howto.html">11) JSPs</a></li><li><a href="ssl-howto.html">12) SSL</a></li><li><a href="ssi-howto.html">13) SSI</a></li><li><a href="cgi-howto.html">14) CGI</a></li><li><a href="proxy-howto.html">15) Proxy Support</a></li><li><a href="mbeans-descriptor-howto.html">16) MBean Descriptor</a></li><li><a href="default-servlet.html">17) Default Servlet</a></li><li><a href="cluster-howto.html">18) Clustering</a></li><li><a href="balancer-howto.html">19) Load Balancer</a></li><li><a href="connectors.html">20) Connectors</a></li><li><a href="monitoring.html">21) Monitoring and Management</a></li><li><a href="logging.html">22) Logging</a></li><li><a href="apr.html">23) APR/Native</a></li><li><a href="virtual-hosting-howto.html">24) Virtual Hosting</a></li><li><a href="aio.html">25) Advanced IO</a></li><li><a href="extras.html">26) Additional Components</a></li><li><a href="maven-jars.html">27) Mavenized</a></li></ul><p><strong>Reference</strong></p><ul><li><a href="RELEASE-NOTES.txt">Release Notes</a></li><li><a href="config/index.html">Configuration</a></li><li><a href="api/index.html">Javadocs</a></li><li><a href="http://tomcat.apache.org/connectors-doc/">JK 1.2 Documentation</a></li></ul><p><strong>Apache Tomcat Development</strong></p><ul><li><a href="building.html">Building</a></li><li><a href="changelog.html">Changelog</a></li><li><a href="http://wiki.apache.org/tomcat/TomcatVersions">Status</a></li><li><a href="developers.html">Developers</a></li><li><a href="architecture/index.html">Architecture</a></li><li><a href="funcspecs/index.html">Functional Specs.</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left" id="mainBody"><h1>Apache Tomcat 6.0</h1><h2>Introduction</h2><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Table of Contents"><!--()--></a><a name="Table_of_Contents"><strong>Table of Contents</strong></a></font></td></tr><tr><td><blockquote>
Hongqing Liufd5ee812014-05-10 16:32:51 +0800[diff] [blame]7<ul><li><a href="#Introduction">Introduction</a></li><li><a href="#Terminology">Terminology</a></li><li><a href="#Directories_and_Files">Directories and Files</a></li><li><a href="#Configuring_Tomcat">Configuring Tomcat</a></li><li><a href="#Where_to_Go_for_Help">Where to Go for Help</a></li></ul>
8</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
9
10<p>For administrators and web developers alike, there are some important bits
11of information you should familiarize yourself with before starting out. This
12document serves as a brief introduction to some of the concepts and
13terminology behind the Tomcat container. As well, where to go when you need
14help.</p>
15
16</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Terminology"><strong>Terminology</strong></a></font></td></tr><tr><td><blockquote>
17
18<p>In the course of reading these documents, you will run across a number of
19terms; some specific to Tomcat, and others defined by the
20<a href="http://wiki.apache.org/tomcat/Specifications">Servlet and
21JSP specifications</a>.</p>
22
23<ul>
24<li><strong>Context</strong> - In a nutshell, a Context is a
25 web application.</li>
26<li><strong>Term2</strong> - This is it.</li>
27<li><strong>Term3</strong> - This is it!</li>
28</ul>
29
30</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Directories and Files"><!--()--></a><a name="Directories_and_Files"><strong>Directories and Files</strong></a></font></td></tr><tr><td><blockquote>
31
32<p>Throughout the docs, you'll notice there are numerous references to
33<strong>$CATALINA_HOME</strong>. This represents the root of your Tomcat
34installation. When we say, "This information can be found in your
35$CATALINA_HOME/README.txt file" we mean to look at the README.txt file at the
36root of your Tomcat install. Optionally, Tomcat may be configured for multiple
37instances by defining <strong>$CATALINA_BASE</strong> for each instance. If
38multiple instances are not configured, <strong>$CATALINA_BASE</strong> is the
39same as <strong>$CATALINA_HOME</strong>.</p>
40
41<p>These are some of the key tomcat directories:</p>
42
43<ul>
44<li><strong>/bin</strong> - Startup, shutdown, and other scripts. The
45 <code>*.sh</code> files (for Unix systems) are functional duplicates of
46 the <code>*.bat</code> files (for Windows systems). Since the Win32
47 command-line lacks certain functionality, there are some additional
48 files in here.</li>
49<li><strong>/conf</strong> - Configuration files and related DTDs. The most
50 important file in here is server.xml. It is the main configuration file
51 for the container.</li>
52<li><strong>/logs</strong> - Log files are here by default.</li>
53<li><strong>/webapps</strong> - This is where your webapps go.</li>
54</ul>
55
56</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Configuring Tomcat"><!--()--></a><a name="Configuring_Tomcat"><strong>Configuring Tomcat</strong></a></font></td></tr><tr><td><blockquote>
57
58<p>This section will acquaint you with the basic information used during
59the configuration of the container.</p>
60
61<p>All of the information in the configuration files is read at startup,
62meaning that any change to the files necessitates a restart of the container.
63</p>
64
65</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Where to Go for Help"><!--()--></a><a name="Where_to_Go_for_Help"><strong>Where to Go for Help</strong></a></font></td></tr><tr><td><blockquote>
66
67<p>While we've done our best to ensure that these documents are clearly
68written and easy to understand, we may have missed something. Provided
69below are various web sites and mailing lists in case you get stuck.</p>
70
71<p>As Tomcat 6 is a new release of Tomcat, keep in mind that some of the
72issues and solutions vary between the major versions of Tomcat (4.x versus
735). As you search around the web, there will be some documentation that
74is not relevant to Tomcat 6, but 3.x, 4.x and 5.x. Doing 3.x or 4.x things to 6
75will probably not work in most cases as the server.xml files are very
76different.</p>
77
78<ul>
79<li>Current document - most documents will list potential hangups. Be sure
80 to fully read the relevant documentation as it will save you much time
81 and effort. There's nothing like scouring the web only to find out that
82 the answer was right in front of you all along!</li>
83<li><a href="http://wiki.apache.org/tomcat/FAQ">Tomcat FAQ</a> as maintained by the developers.</li>
84<li><a href="http://wiki.apache.org/tomcat/">Tomcat WIKI</a></li>
85<li>Tomcat FAQ at <a href="http://www.jguru.com/faq/home.jsp?topic=Tomcat">jGuru</a></li>
86<li>Tomcat mailing list archives - numerous sites archive the Tomcat mailing
87 lists. Since the links change over time, clicking here will search
88 <a href="http://www.google.com/search?q=tomcat+mailing+list+archives">Google</a>.
89 </li>
90<li>The TOMCAT-USER mailing list, which you can subscribe to
91 <a href="http://tomcat.apache.org/lists.html">here</a>. If you don't
92 get a reply, then there's a good chance that your question was probably
93 answered in the list archives or one of the FAQs. Although questions
94 about web application development in general are sometimes asked and
95 answered, please focus your questions on Tomcat-specific issues.</li>
96<li>The TOMCAT-DEV mailing list, which you can subscribe to
97 <a href="http://tomcat.apache.org/lists.html">here</a>. This list is
98 <strong>reserved</strong> for discussions about the development of Tomcat
99 itself. Questions about Tomcat configuration, and the problems you run
100 into while developing and running applications, will normally be more
101 appropriate on the TOMCAT-USER list instead.</li>
102</ul>
103
104<p>And, if you think something should be in the docs, by all means let us know
105on the TOMCAT-DEV list, or send one of the doc authors email.</p>
106
107</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade="noshade" size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
108 Copyright &copy; 1999-2014, Apache Software Foundation
109 </em></font></div></td></tr></table></body></html>