|
Server : Apache/2.4.43 (Win64) OpenSSL/1.1.1g PHP/7.4.6 System : Windows NT USER-PC 6.1 build 7601 (Windows 7 Professional Edition Service Pack 1) AMD64 User : User ( 0) PHP Version : 7.4.6 Disable Function : NONE Directory : C:/xampp/tomcat/webapps/docs/ |
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat 7 (7.0.103) - Introduction</title><meta name="author" content="Robert Slifka"><style type="text/css" media="print">
.noPrint {display: none;}
td#mainBody {width: 100%;}
</style><style type="text/css">
code {background-color:rgb(224,255,255);padding:0 0.1em;}
code.attributeName, code.propertyName {background-color:transparent;}
table {
border-collapse: collapse;
text-align: left;
}
table *:not(table) {
/* Prevent border-collapsing for table child elements like <div> */
border-collapse: separate;
}
th {
text-align: left;
}
div.codeBox pre code, code.attributeName, code.propertyName, code.noHighlight, .noHighlight code {
background-color: transparent;
}
div.codeBox {
overflow: auto;
margin: 1em 0;
}
div.codeBox pre {
margin: 0;
padding: 4px;
border: 1px solid #999;
border-radius: 5px;
background-color: #eff8ff;
display: table; /* To prevent <pre>s from taking the complete available width. */
/*
When it is officially supported, use the following CSS instead of display: table
to prevent big <pre>s from exceeding the browser window:
max-width: available;
width: min-content;
*/
}
div.codeBox pre.wrap {
white-space: pre-wrap;
}
table.defaultTable tr, table.detail-table tr {
border: 1px solid #CCC;
}
table.defaultTable tr:nth-child(even), table.detail-table tr:nth-child(even) {
background-color: #FAFBFF;
}
table.defaultTable tr:nth-child(odd), table.detail-table tr:nth-child(odd) {
background-color: #EEEFFF;
}
table.defaultTable th, table.detail-table th {
background-color: #88b;
color: #fff;
}
table.defaultTable th, table.defaultTable td, table.detail-table th, table.detail-table td {
padding: 5px 8px;
}
p.notice {
border: 1px solid rgb(255, 0, 0);
background-color: rgb(238, 238, 238);
color: rgb(0, 51, 102);
padding: 0.5em;
margin: 1em 2em 1em 1em;
}
</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="https://tomcat.apache.org/"><img src="./images/tomcat.gif" align="right" alt="
The Apache Tomcat Servlet/JSP Container
" border="0"></a></td><td><h1><font face="arial,helvetica,sanserif">Apache Tomcat 7</font></h1><font face="arial,helvetica,sanserif">Version 7.0.103, Mar 16 2020</font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="./images/asf-logo.svg" align="right" alt="Apache Logo" border="0" style="width: 266px;height: 83px;"></a></td></tr></table><table border="0" width="100%" cellspacing="4"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap class="noPrint"><p><strong>Links</strong></p><ul><li><a href="index.html">Docs Home</a></li><li><a href="https://wiki.apache.org/tomcat/FAQ">FAQ</a></li><li><a href="#comments_section">User Comments</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="host-manager-howto.html">6) Host Manager</a></li><li><a href="realm-howto.html">7) Realms and AAA</a></li><li><a href="security-manager-howto.html">8) Security Manager</a></li><li><a href="jndi-resources-howto.html">9) JNDI Resources</a></li><li><a href="jndi-datasource-examples-howto.html">10) JDBC DataSources</a></li><li><a href="class-loader-howto.html">11) Classloading</a></li><li><a href="jasper-howto.html">12) JSPs</a></li><li><a href="ssl-howto.html">13) SSL/TLS</a></li><li><a href="ssi-howto.html">14) SSI</a></li><li><a href="cgi-howto.html">15) CGI</a></li><li><a href="proxy-howto.html">16) Proxy Support</a></li><li><a href="mbeans-descriptors-howto.html">17) MBeans Descriptors</a></li><li><a href="default-servlet.html">18) Default Servlet</a></li><li><a href="cluster-howto.html">19) Clustering</a></li><li><a href="balancer-howto.html">20) Load Balancer</a></li><li><a href="connectors.html">21) Connectors</a></li><li><a href="monitoring.html">22) Monitoring and Management</a></li><li><a href="logging.html">23) Logging</a></li><li><a href="apr.html">24) APR/Native</a></li><li><a href="virtual-hosting-howto.html">25) Virtual Hosting</a></li><li><a href="aio.html">26) Advanced IO</a></li><li><a href="extras.html">27) Additional Components</a></li><li><a href="maven-jars.html">28) Mavenized</a></li><li><a href="security-howto.html">29) Security Considerations</a></li><li><a href="windows-service-howto.html">30) Windows Service</a></li><li><a href="windows-auth-howto.html">31) Windows Authentication</a></li><li><a href="jdbc-pool.html">32) Tomcat's JDBC Pool</a></li><li><a href="web-socket-howto.html">33) WebSocket</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">Tomcat Javadocs</a></li><li><a href="servletapi/index.html">Servlet Javadocs</a></li><li><a href="jspapi/index.html">JSP 2.2 Javadocs</a></li><li><a href="elapi/index.html">EL 2.2 Javadocs</a></li><li><a href="websocketapi/index.html">WebSocket 1.1 Javadocs</a></li><li><a href="annotationapi/index.html">Common Annotations 1.1 Javadocs</a></li><li><a href="https://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="https://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><li><a href="tribes/introduction.html">Tribes</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left" id="mainBody"><h1>Introduction</h1><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>
<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="#CATALINA_HOME_and_CATALINA_BASE">CATALINA_HOME and CATALINA_BASE</a><ol><li><a href="#Why_Use_CATALINA_BASE">Why Use CATALINA_BASE</a></li><li><a href="#Contents_of_CATALINA_BASE">Contents of CATALINA_BASE</a></li><li><a href="#How_to_Use_CATALINA_BASE">How to Use CATALINA_BASE</a></li></ol></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>
</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>
<p>For administrators and web developers alike, there are some important bits
of information you should familiarize yourself with before starting out. This
document serves as a brief introduction to some of the concepts and
terminology behind the Tomcat container. As well, where to go when you need
help.</p>
</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>
<p>In the course of reading these documents, you will run across a number of
terms; some specific to Tomcat, and others defined by the
<a href="https://wiki.apache.org/tomcat/Specifications">Servlet and
JSP specifications</a>.</p>
<ul>
<li><strong>Context</strong> - In a nutshell, a Context is a
web application.</li>
</ul>
<p>That is it. If you find any more terms we need to add to this section, please
do let us know.</p>
</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>
<p>These are some of the key tomcat directories:</p>
<ul>
<li><strong>/bin</strong> - Startup, shutdown, and other scripts. The
<code>*.sh</code> files (for Unix systems) are functional duplicates of
the <code>*.bat</code> files (for Windows systems). Since the Win32
command-line lacks certain functionality, there are some additional
files in here.</li>
<li><strong>/conf</strong> - Configuration files and related DTDs. The most
important file in here is server.xml. It is the main configuration file
for the container.</li>
<li><strong>/logs</strong> - Log files are here by default.</li>
<li><strong>/webapps</strong> - This is where your webapps go.</li>
</ul>
</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="CATALINA_HOME and CATALINA_BASE"><!--()--></a><a name="CATALINA_HOME_and_CATALINA_BASE"><strong>CATALINA_HOME and CATALINA_BASE</strong></a></font></td></tr><tr><td><blockquote>
<p>Throughout the documentation, there are references to the two following
properties:
<ul>
<li>
<strong>CATALINA_HOME</strong>: Represents the root of your Tomcat
installation, for example <code>/home/tomcat/apache-tomcat-9.0.10</code>
or <code>C:\Program Files\apache-tomcat-9.0.10</code>.
</li>
<li>
<strong>CATALINA_BASE</strong>: Represents the root of a runtime
configuration of a specific Tomcat instance. If you want to have
multiple Tomcat instances on one machine, use the <code>CATALINA_BASE</code>
property.
</li>
</ul>
</p>
<p>
If you set the properties to different locations, the CATALINA_HOME location
contains static sources, such as <code>.jar</code> files, or binary files.
The CATALINA_BASE location contains configuration files, log files, deployed
applications, and other runtime requirements.
</p>
<table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Why Use CATALINA_BASE"><!--()--></a><a name="Why_Use_CATALINA_BASE"><strong>Why Use CATALINA_BASE</strong></a></font></td></tr><tr><td><blockquote>
<p>
By default, CATALINA_HOME and CATALINA_BASE point to the same directory.
Set CATALINA_BASE manually when you require running multiple Tomcat
instances on one machine. Doing so provides the following benefits:
</p>
<ul>
<li>
Easier management of upgrading to a newer version of Tomcat. Because all
instances with single CATALINA_HOME location share one set of
<code>.jar</code> files and binary files, you can easily upgrade the files
to newer version and have the change propagated to all Tomcat instances
using the same CATALIA_HOME directory.
</li>
<li>
Avoiding duplication of the same static <code>.jar</code> files.
</li>
<li>
The possibility to share certain settings, for example the <code>setenv</code> shell
or bat script file (depending on your operating system).
</li>
</ul>
</blockquote></td></tr></table>
<table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Contents of CATALINA_BASE"><!--()--></a><a name="Contents_of_CATALINA_BASE"><strong>Contents of CATALINA_BASE</strong></a></font></td></tr><tr><td><blockquote>
<p>
Before you start using CATALINA_BASE, first consider and create the
directory tree used by CATALINA_BASE. Note that if you do not create
all the recommended directories, Tomcat creates the directories
automatically. If it fails to create the necessary directory, for example
due to permission issues, Tomcat will either fail to start, or may not
function correctly.
</p>
<p>
Consider the following list of directories:
<ul>
<li>
<p>
The <code>bin</code> directory with the <code>setenv.sh</code>,
<code>setenv.bat</code>, and <code>tomcat-juli.jar</code> files.
</p>
<p>
<i>Recommended:</i> No.
</p>
<p>
<i>Order of lookup:</i> CATALINA_BASE is checked first; fallback is provided
to CATALINA_HOME.
</p>
</li>
<li>
<p>
The <code>lib</code> directory with further resources to be added on
classpath.
</p>
<p>
<i>Recommended:</i> Yes, if your application depends on external libraries.
</p>
<p>
<i>Order of lookup:</i> CATALINA_BASE is checked first; CATALINA_HOME is
loaded second.
</p>
</li>
<li>
<p>
The <code>logs</code> directory for instance-specific log files.
</p>
<p>
<i>Recommended:</i> Yes.
</p>
</li>
<li>
<p>
The <code>webapps</code> directory for automatically loaded web
applications.
</p>
<p>
<i>Recommended:</i> Yes, if you want to deploy applications.
</p>
<p>
<i>Order of lookup:</i> CATALINA_BASE only.
</p>
</li>
<li>
<p>
The <code>work</code> directory that contains temporary working
directories for the deployed web applications.
</p>
<p>
<i>Recommended:</i> Yes.
</p>
</li>
<li>
<p>
The <code>temp</code> directory used by the JVM for temporary files.
</p>
<p>
<i>Recommended:</i> Yes.
</p>
</li>
</ul>
</p>
<p>
We recommend you not to change the <code>tomcat-juli.jar</code> file.
However, in case you require your own logging implementation, you can
replace the <code>tomcat-juli.jar</code> file in a CATALINA_BASE location
for the specific Tomcat instance.
</p>
<p>
We also recommend you copy all configuration files from the
<code>CATALINA_HOME/conf</code> directory into the
<code>CATALINA_BASE/conf/</code> directory. In case a configuration file
is missing in CATALINA_BASE, there is no fallback to CATALINA_HOME.
Consequently, this may cause failure.
</p>
<p>
At minimum, CATALINA_BASE must contain:
<ul>
<li>conf/server.xml</li>
<li>conf/web.xml</li>
</ul>
That includes the <code>conf</code> directory. Otherwise, Tomcat fails
to start, or fails to function properly.
</p>
<p>
For advanced configuration information, see the
<a href="https://tomcat.apache.org/tomcat-9.0-doc/RUNNING.txt">
RUNNING.txt
</a> file.
</p>
</blockquote></td></tr></table>
<table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="How to Use CATALINA_BASE"><!--()--></a><a name="How_to_Use_CATALINA_BASE"><strong>How to Use CATALINA_BASE</strong></a></font></td></tr><tr><td><blockquote>
<p>
The CATALINA_BASE property is an environment variable. You can set it
before you execute the Tomcat start script, for example:
<ul>
<li>On Unix: <code>CATALINA_BASE=/tmp/tomcat_base1 bin/catalina.sh start</code></li>
<li>On Windows: <code>CATALINA_BASE=C:\tomcat_base1 bin/catalina.bat start</code></li>
</ul>
</p>
</blockquote></td></tr></table>
</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>
<p>This section will acquaint you with the basic information used during
the configuration of the container.</p>
<p>All of the information in the configuration files is read at startup,
meaning that any change to the files necessitates a restart of the container.
</p>
</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>
<p>While we've done our best to ensure that these documents are clearly
written and easy to understand, we may have missed something. Provided
below are various web sites and mailing lists in case you get stuck.</p>
<p>As Tomcat 7 is a new release of Tomcat, keep in mind that some of the
issues and solutions vary between the major versions of Tomcat (6.x versus
7.x). As you search around the web, there will be some documentation that
is not relevant to Tomcat 7, but 6.x, 5.x or earlier versions. Doing 3.x
or 4.x things to 7 will probably not work in most cases as the server.xml
files are very different.</p>
<ul>
<li>Current document - most documents will list potential hangups. Be sure
to fully read the relevant documentation as it will save you much time
and effort. There's nothing like scouring the web only to find out that
the answer was right in front of you all along!</li>
<li><a href="https://wiki.apache.org/tomcat/FAQ">Tomcat FAQ</a></li>
<li><a href="https://wiki.apache.org/tomcat/">Tomcat WIKI</a></li>
<li>Tomcat FAQ at <a href="http://www.jguru.com/faq/home.jsp?topic=Tomcat">jGuru</a></li>
<li>Tomcat mailing list archives - numerous sites archive the Tomcat mailing
lists. Since the links change over time, clicking here will search
<a href="https://www.google.com/search?q=tomcat+mailing+list+archives">Google</a>.
</li>
<li>The TOMCAT-USER mailing list, which you can subscribe to
<a href="https://tomcat.apache.org/lists.html">here</a>. If you don't
get a reply, then there's a good chance that your question was probably
answered in the list archives or one of the FAQs. Although questions
about web application development in general are sometimes asked and
answered, please focus your questions on Tomcat-specific issues.</li>
<li>The TOMCAT-DEV mailing list, which you can subscribe to
<a href="https://tomcat.apache.org/lists.html">here</a>. This list is
<strong>reserved</strong> for discussions about the development of Tomcat
itself. Questions about Tomcat configuration, and the problems you run
into while developing and running applications, will normally be more
appropriate on the TOMCAT-USER list instead.</li>
</ul>
<p>And, if you think something should be in the docs, by all means let us know
on the TOMCAT-DEV list.</p>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2020, Apache Software Foundation
</em></font></div></td></tr></table></body></html>