一、简介
Apache Tomcat 是一个开源的Servlet容器,用于运行Java Web应用程序,由Apache软件基金会维护。
二、下载与解压
- 下载Tomcat:
- 访问Apache Tomcat官方网站。
- 导航到下载页面,选择适合操作系统的版本进行下载。
- 解压文件:
- Windows:右键点击下载的压缩包,选择“解压到此处”或使用解压工具如WinRAR、7-Zip。
- Linux:打开终端,使用命令
tar -zxvf apache-tomcat-*.tar.gz
解压。 - 建议解压到
C:\apache-tomcat-9.0.56
(Windows)或/opt/apache-tomcat-9.0.56
(Linux)目录。
三、配置环境变量
- Windows:
- 右键点击“计算机”或“此电脑”,选择“属性” > “环境变量”。
- 新建系统变量:
- 变量名:
CATALINA_HOME
- 变量值:Tomcat安装路径(如
C:\apache-tomcat-9.0.56
)
- 变量名:
- 编辑
Path
变量,添加%CATALINA_HOME%\bin
。
- Linux:
- 编辑
~/.bashrc
或~/.bash_profile
文件,添加:export CATALINA_HOME=/opt/apache-tomcat-9.0.56 export PATH=$PATH:$CATALINA_HOME/bin
- 重新加载配置文件:
source ~/.bashrc
或source ~/.bash_profile
。
- 编辑
- 验证环境变量:
- 运行
echo %CATALINA_HOME%
(Windows)或echo $CATALINA_HOME
(Linux)确认路径正确。
- 运行
四、启动与停止Tomcat
- 启动Tomcat:
- Windows:打开命令提示符,切换到
%CATALINA_HOME%\bin
目录,运行startup.bat
。 - Linux:打开终端,切换到
$CATALINA_HOME/bin
目录,运行./startup.sh
。 - 访问
http://localhost:8080
,看到Tomcat欢迎页面表示启动成功。
- Windows:打开命令提示符,切换到
- 停止Tomcat:
- Windows:运行
shutdown.bat
。 - Linux:运行
./shutdown.sh
。
- Windows:运行
五、常见配置
1. 修改端口号
- 编辑
$CATALINA_HOME/conf/server.xml
,找到<Connector port="8080" ... />
,修改port
属性。 - 保存后重启Tomcat,访问新端口号(如
http://localhost:8081
)。
2. 配置管理员账号
- 编辑
$CATALINA_HOME/conf/tomcat-users.xml
,添加管理员用户:<user username="admin" password="admin" roles="manager-gui,admin-gui"/>
- 保存后重启Tomcat,访问
http://localhost:8080/manager/html
使用新账号登录。
3. 部署Web应用程序
- 将WAR文件放置在
$CATALINA_HOME/webapps
目录,Tomcat会自动部署。 - 或通过管理界面上传WAR文件部署。
4. 配置虚拟主机
- 编辑
$CATALINA_HOME/conf/server.xml
,添加<Host>
元素配置虚拟主机:<Host name="www.example.com" appBase="webapps"> <Context path="" docBase="example" /> </Host>
- 配置DNS解析和服务器的
hosts
文件。
5. 配置数据库连接池
- 编辑
$CATALINA_HOME/conf/server.xml
,添加数据源资源:<Resource name="jdbc/MyDB" auth="Container" type="javax.sql.DataSource" maxTotal="100" maxIdle="30" maxWaitMillis="10000" username="user" password="pass" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/mydb"/>
- 在
WEB-INF/web.xml
中声明资源引用:<resource-ref> <description>DB Connection</description> <res-ref-name>jdbc/MyDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
6. 配置日志文件
- 编辑
$CATALINA_HOME/conf/logging.properties
,配置日志级别和输出文件:.level = FINE handlers = 1catalina.org.apache.juli.FileHandler 1catalina.org.apache.juli.FileHandler.pattern = ./logs/catalina.%t.log
- 保存后重启Tomcat生效。
六、性能调优
- 调整连接器参数:编辑
server.xml
,修改maxThreads
、minSpareThreads
等参数。 - 调整JVM堆内存:设置
CATALINA_OPTS
环境变量,例如:export CATALINA_OPTS="-Xms512m -Xmx1024m"
七、故障排除
- Tomcat无法启动:检查日志文件,确保环境变量配置正确,端口号未被占用。
- 无法访问管理界面:确认管理员账号配置正确,管理应用已启用。
- 数据库连接失败:检查数据库配置,确保数据库服务运行,账号密码正确。
八、总结
本教程涵盖了Tomcat的安装、环境变量配置、启动停止、端口号修改、管理员账号配置、Web应用部署、虚拟主机配置、数据库连接池配置、日志文件配置以及性能调优和故障排除的基本步骤。希望对用户有所帮助。