Ubuntu22.04 UEFI系统配置Apache Tomcat/8.5.87为开机自动启动

发布于:2025-03-23 ⋅ 阅读:(15) ⋅ 点赞:(0)

前置条件,Java与Tomcat目录均为/usr/local路径下。
在这里插入图片描述
java安装目录为:/usr/local/java
在这里插入图片描述
tomcat安装目录为:/usr/local/tomcat
在这里插入图片描述

1. 创建 Tomcat 专用用户和组(可选但推荐)

# 创建 tomcat 用户组
sudo groupadd tomcat

# 创建 tomcat 用户,并指定主目录为 Tomcat 安装路径
sudo useradd -s /bin/false -g tomcat -d /usr/local/tomcat/apache-tomcat-8.5.87 tomcat

# 授权 Tomcat 目录给 tomcat 用户
sudo chown -R tomcat:tomcat /usr/local/tomcat/apache-tomcat-8.5.87
sudo chmod -R u+x /usr/local/tomcat/apache-tomcat-8.5.87/bin

2. 创建 systemd 服务文件

# 创建服务文件
sudo nano /etc/systemd/system/tomcat.service

将以下内容粘贴到文件中(已根据你的路径配置):

[Unit]
Description=Apache Tomcat 8.5.87
After=network.target

[Service]
Type=forking

# 环境变量(直接使用你的 JDK 和 Tomcat 路径)
Environment="JAVA_HOME=/usr/local/java/jdk1.8.0_361"
Environment="CATALINA_HOME=/usr/local/tomcat/apache-tomcat-8.5.87"
Environment="CATALINA_BASE=/usr/local/tomcat/apache-tomcat-8.5.87"
Environment="CATALINA_PID=/usr/local/tomcat/apache-tomcat-8.5.87/temp/tomcat.pid"

# 启动和停止命令
ExecStart=/usr/local/tomcat/apache-tomcat-8.5.87/bin/startup.sh
ExecStop=/usr/local/tomcat/apache-tomcat-8.5.87/bin/shutdown.sh

# 使用专用用户和组
User=tomcat
Group=tomcat

# 失败时自动重启
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

3. 启用服务并启动 Tomcat

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 设置开机自启动
sudo systemctl enable tomcat

# 立即启动 Tomcat
sudo systemctl start tomcat

4. 验证配置

# 检查服务状态(确认状态为 active (running))
sudo systemctl status tomcat

# 确认开机启动已启用(输出应为 enabled)
sudo systemctl is-enabled tomcat

# 测试 Tomcat 是否响应(默认端口 8080)
curl http://localhost:8080

5. 常见问题处理

问题1:Tomcat 启动失败
# 查看详细日志
journalctl -u tomcat --no-pager

# 检查日志中是否有以下错误:
# - JAVA_HOME 路径是否正确(/usr/local/java/jdk1.8.0_361)
# - CATALINA_HOME 路径是否正确(/usr/local/tomcat/apache-tomcat-8.5.87)
问题2:PID 文件未生成
# 检查 Tomcat 的 temp 目录是否存在
ls /usr/local/tomcat/apache-tomcat-8.5.87/temp

# 如果不存在,手动创建并授权
sudo mkdir -p /usr/local/tomcat/apache-tomcat-8.5.87/temp
sudo chown tomcat:tomcat /usr/local/tomcat/apache-tomcat-8.5.87/temp
问题3:权限不足
# 确保所有 Tomcat 文件属于 tomcat 用户
sudo chown -R tomcat:tomcat /usr/local/tomcat/apache-tomcat-8.5.87

最终验证

# 重启系统,检查 Tomcat 是否自动启动
sudo reboot

# 重启后检查服务状态
sudo systemctl status tomcat

按以上步骤操作后,Tomcat 将在系统启动时自动运行,且所有路径均已适配你的实际安装目录。