================================================== =============================
一个或多个许可给Apache Software Foundation(ASF)的许可
贡献者许可协议。请参阅随发布的NOTICE文件
此项工作可获取有关版权所有权的更多信息。
ASF在Apache许可证2.0版下将此文件许可给您
(以下简称“许可”);除非遵守以下规定,否则您不得使用此文件
许可证。您可以在以下位置获得许可的副本:
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则软件
根据许可分发的内容按“原样”分发,
没有任何明示或暗示的保证或条件。
有关特定语言的管理权限,请参阅许可证。
许可中的限制。
================================================== =============================
================================================== =
运行Apache Tomcat 8.5 Servlet / JSP容器
================================================== =
Apache Tomcat 8.5需要Java Standard Edition运行时
环境(JRE)版本7或更高版本。
============================
使用JRE 7或更高版本运行
============================
(1)下载并安装Java SE运行时环境(JRE)
(1.1)下载Java SE运行时环境(JRE),
从发布版本7或更高版本
http://www.oracle.com/technetwork/java/javase/downloads/index.html
(1.2)根据随附的说明安装JRE
发布。
您还可以使用完整的Java开发工具包(JDK),而不仅仅是
一个JRE。
(2)下载并安装Apache Tomcat
(2.1)从以下位置下载Tomcat的二进制发行版:
https://tomcat.apache.org/
(2.2)解压缩二进制发行版,使其独立存在
目录(通常命名为“ apache-tomcat- [version]”)。
在本文档的其余部分中,名称
“ CATALINA_HOME”用于引用该目录的完整路径名
目录。
注意:作为下载二进制发行版的替代方法,您可以
根据Tomcat源代码创建自己的代码,如
“ BUILDING.txt”。你可以
a)进行完整的“发行”构建,并在
“输出/释放”目录,然后按上述步骤进行解压缩,或者
b)做一个简单的构建,并使用“ output / build”目录作为
“ CATALINA_HOME”。请注意,两者之间存在一些差异
“输出/构建”目录的内容和完整的“发行版”
分配。
(3)配置环境变量
Tomcat是Java应用程序,不直接使用环境变量。
环境变量由Tomcat启动脚本使用。脚本使用
环境变量来准备启动Tomcat的命令。
(3.1)设置CATALINA_HOME(必填)和CATALINA_BASE(可选)
CATALINA_HOME环境变量应设置为
Tomcat“二进制”发行版的根目录。
Tomcat启动脚本具有一些逻辑来设置此变量
如果不存在,则根据启动脚本的位置自动进行
在* nix中和Windows的当前目录中。该逻辑可能不起作用
在所有情况下,建议显式设置变量。
CATALINA_BASE环境变量指定根的位置
Tomcat“活动配置”的目录。它是可选的。它
默认等于CATALINA_HOME。
为CATALINA_HOME和CATALINA_BASE变量使用不同的值是
建议简化进一步的升级和维护。有记录
在下面的“多个Tomcat实例”部分中。
(3.2)设置JRE_HOME或JAVA_HOME(必需)
这些变量用于指定Java运行时的位置
用于启动Tomcat的环境或Java开发工具包的环境。
JRE_HOME变量用于指定JRE的位置。JAVA_HOME
变量用于指定JDK的位置。
使用JAVA_HOME可以访问某些其他启动选项,这些选项
使用JRE_HOME时不允许使用。
如果同时指定了JRE_HOME和JAVA_HOME,则使用JRE_HOME。
建议您指定这些变量的位置是“ setenv”脚本。看到
下面。
(3.3)其他变量(可选)
除上述四个变量外,还存在其他环境变量。
请参阅catalina.bat或catalina.sh脚本顶部的注释,以获取相关信息。
列表和每个描述。
一种常用的变量是CATALINA_OPTS。它允许规范
启动Tomcat的java命令的其他选项。
有关影响Java运行时的选项,请参见Java文档。
环境。
请参阅《 Tomcat配置参考》中的“系统属性”页面。
特定于Tomcat的系统属性。
类似的变量是JAVA_OPTS。它的使用频率较低。它允许
用来启动和停止Tomcat的选项的规范
至于其他命令。
注意:不要使用JAVA_OPTS来指定内存限制。你不需要太多
用于停止Tomcat的小进程的内存。这些设置
属于CATALINA_OPTS。
另一个经常使用的变量是CATALINA_PID(仅在* nix上)。它
指定分叉Tomcat的进程ID的文件位置
将编写Java进程。此设置是可选的。它将启用
具有以下特点:
*更好的保护措施,防止重复尝试
*允许在不响应时强制终止Tomcat进程
标准关机命令。
(3.4)使用“ setenv”脚本(可选,推荐)
除了CATALINA_HOME和CATALINA_BASE外,所有环境变量都可以
在“ setenv”脚本中指定。脚本放置在
CATALINA_BASE / bin或进入CATALINA_HOME / bin目录,并命名为
setenv.bat(在Windows上)或setenv.sh(在* nix上)。该文件必须是
可读的。
默认情况下,不存在setenv脚本文件。如果脚本文件存在
在CATALINA_BASE和CATALINA_HOME中,CATALINA_BASE中的一个是
首选。
例如,要配置JRE_HOME和CATALINA_PID变量,您可以
创建以下脚本文件:
在Windows上,%CATALINA_BASE%\ bin \ setenv.bat:
设置“ JRE_HOME =%ProgramFiles%\ Java \ jre7”
退出/ b 0
在* nix上,$ CATALINA_BASE / bin / setenv.sh:
JRE_HOME = / usr / java /最新
CATALINA_PID =“ $ CATALINA_BASE / tomcat.pid”
无法在以下位置配置CATALINA_HOME和CATALINA_BASE变量
setenv脚本,因为它们用于查找该文件。
这里描述的所有环境变量和“ setenv”脚本都是
仅在使用标准脚本启动Tomcat时使用。例如,如果
您已在Windows(服务包装器)上将Tomcat安装为服务
直接启动Java,并且不使用脚本文件。
(4)启动Tomcat
(4.1)可以通过执行以下命令之一来启动Tomcat:
在Windows上:
%CATALINA_HOME%\ bin \ startup.bat
要么
%CATALINA_HOME%\ bin \ catalina.bat开始
在* nix上:
$ CATALINA_HOME / bin / startup.sh
要么
$ CATALINA_HOME / bin / catalina.sh开始
(4.2)启动后,Tomcat随附的默认Web应用程序将为
可通过以下方式获得:
http:// localhost:8080 /
(4.3)有关配置和运行Tomcat的更多信息,请参见
此处以及Tomcat网站上包含的文档:
https://tomcat.apache.org/
(5)关闭Tomcat
(5.1)可以通过执行以下命令之一来关闭Tomcat:
在Windows上:
%CATALINA_HOME%\ bin \ shutdown.bat
要么
%CATALINA_HOME%\ bin \ catalina.bat停止
在* nix上:
$ CATALINA_HOME / bin / shutdown.sh
要么
$ CATALINA_HOME / bin / catalina.sh停止
==================================================
高级配置-多个Tomcat实例
==================================================
在许多情况下,最好有一个Tomcat的副本
在同一服务器上的多个用户之间共享二进制分发。为了
为此,您可以将CATALINA_BASE环境变量设置为
目录,其中包含“个人” Tomcat实例的文件。
当使用单独的CATALINA_HOME和CATALINA_BASE运行时,文件
和目录的拆分如下:
在CATALINA_BASE中:
* bin-仅以下文件:
* setenv.sh(* nix)或setenv.bat(Windows),
* tomcat-juli.jar
上面描述了setenv脚本。tomcat-juli库
在用户指南的“记录”一章中进行了介绍。
* conf-服务器配置文件(包括server.xml)
* lib-库和类,如下所述
*日志-日志和输出文件
* webapps-自动加载的Web应用程序
* work-Web应用程序的临时工作目录
* temp-JVM用于临时文件的目录(java.io.tmpdir)
在CATALINA_HOME中:
* bin-启动和关闭脚本
以下文件仅在不存在时使用
CATALINA_BASE / bin:
setenv.sh(* nix),setenv.bat(Windows),tomcat-juli.jar
* lib-库和类,如下所述
*认可-覆盖标准“认可标准”的库
JRE提供的库。请参阅类加载文档
有关详细信息,请参见《用户指南》。
仅Java <= 8支持此功能。
默认情况下,此“认可”目录不存在。
在默认配置中,JAR库和类都在
CATALINA_BASE / lib和CATALINA_HOME / lib中将添加到通用
classpath,但将首先添加CATALINA_BASE中的类,因此
首先被搜索。
这个想法是,您可以将标准的Tomcat库保留在
CATALINA_HOME / lib并将其他驱动程序(例如数据库驱动程序)添加到
CATALINA_BASE / lib。
一般而言,建议不要在Web应用程序之间共享库,
但是将它们放入应用程序内的WEB-INF / lib目录中。看到
有关详细信息,请参见用户指南中的类加载文档。
注意,CATALINA_HOME和
可以在已处理的XML配置文件中引用CATALINA_BASE
由Tomcat分别命名为$ {catalina.home}和$ {catalina.base}。
例如,标准管理器Web应用程序可以保存在
CATALINA_HOME / webapps / manager并通过使用将其加载到CATALINA_BASE中
以下技巧:
*复制CATALINA_HOME / webapps / manager / META-INF / context.xml
文件为CATALINA_BASE / conf / Catalina / localhost / manager.xml
*添加docBase属性,如下所示。
该文件将如下所示:
<?xml版本=“ 1.0”编码=“ UTF-8”?>
<Context docBase =“ $ {catalina.home} / webapps / manager”
antiResourceLocking =“ false” privileged =“ true”>
<Valve className =“ org.apache.catalina.valves.RemoteAddrValve”
allow =“ 127 \ .0 \ .0 \ .1” />
</ Context>
请参阅《用户指南》中的“部署程序”一章,以及《
配置参考以获取有关上下文和Web的更多信息
应用程序部署。
================
故障排除
================
独立运行期间实际上只有两件事可能出错
Tomcat安装:
(1)最常见的打is是另一台Web服务器(或该服务器的任何进程)
问题)已声明使用端口8080。这是默认的HTTP端口,
Tomcat在启动时尝试绑定到。要更改此设置,请打开文件:
$ CATALINA_HOME / conf / server.xml
并搜索“ 8080”。将其更改为未使用的端口
大于1024,因为小于或等于1024的端口需要超级用户
在UNIX下访问绑定。
重新启动Tomcat,您就可以开展业务。确保您更换了“ 8080”
在用于访问Tomcat的URL中。例如,如果您更改
端口到1977,则需要在您的网址中请求URL http:// localhost:1977 /
浏览器。
(2)找不到“本地主机”计算机。如果您落后于
代理。如果是这种情况,请确保您的代理配置
浏览器知道您不应该通过代理来访问
“本地主机”。
在Firefox中,这位于“工具/首选项->高级/网络->”下
连接->设置...,在Internet Explorer中是工具->
Internet选项->连接->局域网设置。
====================
可选组件
====================
Apache Tomcat二进制文件可能包含以下可选组件
分配。如果不包括它们,则可以单独安装它们。
1. Apache Tomcat本机库
2. Apache Commons Daemon服务启动器
两者都是用C语言实现的,因此必须进行编译
转换成二进制代码。二进制代码将特定于平台和CPU
架构,并且必须与Java Runtime Environment可执行文件匹配
将用于启动Tomcat。
Windows特定于Windows的Apache Tomcat二进制发行版包括二进制
这些组件的文件。在其他平台上,您必须寻找
二进制版本或自己编译。
如果您是Tomcat的新手,请不要打扰这些组件。
如果您确实使用它们,请不要忘记阅读它们的文档。
Apache Tomcat本机库
-----------------------------
它是一个允许使用HTTP和AJP的“ Apr”变体的库
Apache Tomcat中的协议连接器。它基于OpenSSL和Apache构建
可移植运行时(APR)库。这些库与
Apache HTTPD Server项目。
在过去的Java性能中,此功能特别重要
很穷。如今它已不那么重要了,但仍然得到使用和尊重
很多。有关更多详细信息,请参见Tomcat文档。
进一步阅读:
-Apache Tomcat文档
*《 Tomcat用户指南》中的APR / Native库文档
https://tomcat.apache.org/tomcat-8.5-doc/apr.html
* Tomcat中HTTP和AJP协议连接器的文档
配置参考
https://tomcat.apache.org/tomcat-8.5-doc/config/http.html
https://tomcat.apache.org/tomcat-8.5-doc/config/ajp.html
-Apache Tomcat Native项目主页
https://tomcat.apache.org/native-doc/
- 其他项目
* OpenSSL的
https://www.openssl.org/
* Apache可移植运行时
https://apr.apache.org/
* Apache HTTP服务器
https://httpd.apache.org/
要禁用Apache Tomcat本机库:
-在安装Apache Tomcat本机库时禁用它,或者
-要删除在Tomcat启动时记录的警告,当
库未安装:
编辑“ conf / server.xml”文件,然后从中删除“ AprLifecycleListener”
它。
Apache Tomcat本机库的二进制文件通常命名为
-Windows上的“ tcnative-1.dll”
-* nix系统上的“ libtcnative-1.so”
Apache Commons守护程序
----------------------
Apache Commons Daemon项目提供了可用于
将Apache Tomcat作为服务在Windows上或作为守护程序安装在* nix上
系统。
Windows专有的Apache Commons Daemon的实现称为
“ procrun”。* nix专用的一个称为“ jsvc”。
进一步阅读:
-Apache Commons Daemon项目
https://commons.apache.org/daemon/
-Apache Tomcat文档
*安装Apache Tomcat
https://tomcat.apache.org/tomcat-8.5-doc/setup.html
* Windows服务操作方法
https://tomcat.apache.org/tomcat-8.5-doc/windows-service-howto.html
Apache Tomcat发行版中的Apache Commons守护程序的二进制文件
Windows的名称为:
-“ tomcat8.exe”
-“ tomcat8w.exe”
这些文件被重命名为“ prunsrv.exe”和“ prunmgr.exe”的副本。
Apache Commons Daemon分发。文件名具有含义:
用作服务名称以在Windows中注册服务,以及
密钥名称,用于存储此安装的不同配置
“ procrun”。如果您想安装Tomcat 8.5的多个实例
并行地,您必须使用相同的命名来进一步重命名这些文件
方案。
Tomcat文件配置
最新推荐文章于 2024-03-03 14:25:58 发布