web server apache tomcat11-01-官方文档入门介绍

媒介

整理这个官方翻译的系列，缘故原由是网上大部分的 tomcat 版本比力旧，此版本为 v11 最新的版本。
开源项目

同时也为从零手写实现 tomcat 提供一些基础和特性的思绪。

minicat 别称【嗅虎】心有猛虎，轻嗅蔷薇。

系列文章

web server apache tomcat11-01-官方文档入门介绍
web server apache tomcat11-02-setup 启动
web server apache tomcat11-03-deploy 怎样部署
web server apache tomcat11-04-manager 怎样管理？
web server apache tomcat11-06-Host Manager App -- Text Interface
web server apache tomcat11-07-Realm Configuration
web server apache tomcat11-08-JNDI Resources
web server apache tomcat11-09-JNDI Datasource
web server apache tomcat11-10-Class Loader
...
简介

对于管理员和 Web 开辟人员来说，在开始之前，有一些紧张的信息您应该熟悉。本文档作为对 Tomcat 容器背后一些概念和术语的简要介绍，以及在必要帮助时应该去哪里的指南。
术语

在阅读这些文档的过程中，您会遇到许多术语；一些是特定于 Tomcat 的，而另一些是由 Servlet 和 JSP 规范界说的。

• 上下文（Context）- 简而言之，上下文是一个 Web 应用程序。
  

假如您发现必要添加更多术语到此部分，请告诉我们。
目录和文件

以下是一些关键的 Tomcat 目录：

• /bin - 启动、关闭和其他脚本。*.sh 文件（对于 Unix 系统）是 *.bat 文件（对于 Windows 系统）的功能副本。由于 Win32 下令行缺少某些功能，因此这里有一些额外的文件。
  
• /conf - 设置文件和相干的 DTD。这里最紧张的文件是 server.xml。这是容器的主要设置文件。
  
• /logs - 默认情况下存放日记文件。
  
• /webapps - 这是您的 Web 应用程序的位置。
  

CATALINA_HOME 和 CATALINA_BASE

在文档中，有两个属性的引用：

• CATALINA_HOME：代表您的 Tomcat 安装的根目录，例如 /home/tomcat/apache-tomcat-11.0.0 或 C:\Program Files\apache-tomcat-11.0.0。
  
• CATALINA_BASE：代表特定 Tomcat 实例的运行时设置的根目录。假如您想在一台呆板上运行多个 Tomcat 实例，请使用 CATALINA_BASE 属性。
  

假如您将这两个属性设置为差别的位置，那么 CATALINA_HOME 位置包含静态资源，例如 .jar 文件或二进制文件。CATALINA_BASE 位置包含设置文件、日记文件、部署的应用程序以及其他运行时要求。
为什么使用 CATALINA_BASE

默认情况下，CATALINA_HOME 和 CATALINA_BASE 指向同一个目录。当您必要在一台呆板上运行多个 Tomcat 实例时，手动设置 CATALINA_BASE。这样做有以下利益：

• 更容易管理升级到较新版本的 Tomcat。因为所有具有单个 CATALINA_HOME 位置的实例共享一组 .jar 文件和二进制文件，您可以轻松地将文件升级到较新版本，并将更改流传到使用雷同 CATALIA_HOME 目录的所有 Tomcat 实例。
  
• 避免重复使用雷同的静态 .jar 文件。
  
• 可以共享某些设置，例如 setenv shell 或 bat 脚本文件（取决于您的操作系统）。
  

CATALINA_BASE 的内容

在开始使用 CATALINA_BASE 之前，请先思量并创建 CATALINA_BASE 使用的目录树。请注意，假如您没有创建所有推荐的目录，Tomcat 将自动创建这些目录。假如它无法创建所需的目录，例如由于权限问题，Tomcat 将无法启动，或者大概无法正常工作。
思量以下目录列表：

• 包含 setenv.sh、setenv.bat 和 tomcat-juli.jar 文件的 bin 目录。
  
  
  
  • 推荐：否。
    
  • 查找顺序：首先查抄 CATALINA_BASE；然后回退到 CATALINA_HOME。
    
  
  
• 包含要添加到类路径的其他资源的 lib 目录。
  
  
  
  • 推荐：是，假如您的应用程序依靠于外部库。
    
  • 查找顺序：首先查抄 CATALINA_BASE；其次加载 CATALINA_HOME。
    
  
  
• 用于特定实例日记文件的 logs 目录。
  
  
  
  • 推荐：是。
    
  
  
• 用于自动加载的 Web 应用程序的 webapps 目录。
  
  
  
  • 推荐：是，假如您要部署应用程序。
    
  • 查找顺序：仅查抄 CATALINA_BASE。
    
  
  
• 包含已部署的 Web 应用程序的暂时工作目录的 work 目录。
  
  
  
  • 推荐：是。
    
  
  
• JVM 用于暂时文件的 temp 目录。
  
  
  
  • 推荐：是。
    
  
  

我们发起您不要更改 tomcat-juli.jar 文件。但是，假如您必要自己的日记记录实现，可以将 tomcat-juli.jar 文件替换为特定 Tomcat 实例的 CATALINA_BASE 位置。
我们还发起您将所有设置文件从 CATALINA_HOME/conf 目录复制到 CATALINA_BASE/conf/ 目录。假如在 CATALINA_BASE 中缺少设置文件，将不会回退到 CATALINA_HOME。因此，这大概会导致失败。
至少，CATALINA_BASE 必须包含：

• conf/server.xml
  
• conf/web.xml
  
  
  
  • 包括 conf 目录。否则，Tomcat 将无法启动，或无法正常工作。
    
  
  

有关高级设置信息，请参阅 RUNNING.txt 文件。
怎样使用 CATALINA_BASE

CATALINA_BASE 属性是一个环境变量。您可以在执行 Tomcat 启动脚本之前设置它，例如：

• 在 Unix 上：CATALINA_BASE=/tmp/tomcat_base1 bin/catalina.sh start
  
• 在 Windows 上：CATALINA_BASE=C:\tomcat_base1 bin/catalina.bat start
  

设置 Tomcat

本节将向您介绍在设置容器期间使用的基本信息。
所有设置文件中的信息都在启动时读取，这意味着对文件的任何更改都必要重新启动容器。
寻求帮助

虽然我们已尽力确保这些文档写得清晰易懂，但我们大概会漏
掉一些内容。以下是一些网站和邮件列表，以防您遇到困难。
请注意，一些问题和解决方案在差别版本的 Tomcat 之间大概会有所差别。
在网络上搜索时，会有一些文档与 Tomcat 11 无关，而仅与早期版本有关。

• 当前文档 - 大多数文档将列出潜伏的问题。请务必彻底阅读相干文档，这将节省您大量的时间和精力。没有什么比搜索网络更好的了，只是发现答案不停在您眼前！
  
• Tomcat FAQ
  
• Tomcat Wiki
  
• jGuru 的 Tomcat FAQ
  
• Tomcat 邮件列表档案 - 许多网站存档了 Tomcat 邮件列表。由于链接随时间而变化，请点击此处搜索 Google。
  
• TOMCAT-USER 邮件列表 - 您可以在此订阅。假如您没有收到回复，那么您的问题大概已在列表存档或常见问题解答中得到相识答。只管有时会提出并回答一般的 Web 应用程序开辟问题，但请将您的问题重点放在 Tomcat 特定问题上。
  
• TOMCAT-DEV 邮件列表 - 您可以在此订阅。此列表专用于讨论 Tomcat 本身的开辟。有关 Tomcat 设置以及开辟和运行应用程序时遇到的问题，通常更适合在 TOMCAT-USER 列表上讨论。
  

假如您认为文档中应该包含某些内容，请务必在 TOMCAT-DEV 列表上让我们知道。
参考资料

https://tomcat.apache.org/tomcat-11.0-doc/introduction.html

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。