JPOM Server 线上升级完整实战指南（安全不丢数据）

适用环境：Linux / Ubuntu
JPOM 版本示例：server-2.11.12
启动方式：官方 Server.sh 脚本
数据路径：/home/ubuntu/java/jpom/server/data

一、升级前说明（必读）

在升级 JPOM Server 前，请务必注意以下几点：

• 不要直接删除 server 目录
• 不要使用 kill -9 强杀进程
• 正确做法是：
  停止服务 → 备份旧版本 → 解压新版本 → 恢复数据 → 启动

本文记录的是一次线上安全升级流程，升级后数据、账号、项目均可完整保留。

二、停止 JPOM Server 服务

进入 JPOM Server 的脚本目录，使用官方脚本停止服务：

cd /home/ubuntu/java/jpom/server/bin
sudo ./Server.sh stop

确认服务是否已经停止：

ps -ef | grep jpom | grep -v grep

无输出表示已成功停止。

三、备份旧 Server 并解压新版本

1️⃣ 进入 JPOM 根目录

cd /home/ubuntu/java/jpom

2️⃣ 备份旧 server 目录（非常重要）

mv server server_bak_$(date +%F_%H%M)

示例：

server_bak_2026-01-12_1411

这样可以随时回滚，避免升级失败无法恢复。

3️⃣ 解压新版本安装包

tar -zxvf server-2.11.12-release.tar.gz

由于官方压缩包没有自带 server 目录，需要手动整理目录结构：

mkdir server
mv bin conf lib LICENSE server/

此时目录结构应为：

/home/ubuntu/java/jpom/
├── agent
├── server
│   ├── bin
│   ├── conf
│   ├── lib
│   └── LICENSE
├── server_bak_2026-01-12_1411
├── server-2.11.12-release.tar.gz

四、恢复旧配置与数据（关键步骤）

1️⃣ 拷贝配置文件

cp server_bak_2026-01-12_1411/conf/* server/conf/

作用：

• 恢复端口、运行参数、日志配置等
• 避免新版本使用默认配置启动

2️⃣ 拷贝核心业务数据

cp -r server_bak_2026-01-12_1411/data server/

data 目录包含：

• 用户账号
• 项目配置
• 节点（agent）信息
• 权限与任务数据

👉 这是 JPOM 的核心数据，必须拷贝

3️⃣ 拷贝数据库文件

cp -r server_bak_2026-01-12_1411/db server/

说明：

• JPOM 默认使用 SQLite
• 所有持久化数据最终存储在该目录

五、为启动脚本添加执行权限

防止出现“权限不够”的问题：

chmod +x server/bin/*.sh

六、启动 JPOM Server

cd server/bin
./Server.sh start

Agent 启动
cd /home/ubuntu/.../agent/bin 切换到服务器对应目录
./Agent.sh start

查看服务状态：

./Server.sh status

七、查看启动日志

实时查看日志，确认是否启动成功：

tail -f ../logs/server.log

启动成功通常会看到类似信息：

JPOM Server started
Version: 2.11.12

八、升级完成检查项

• 浏览器访问 JPOM 控制台
• 原有账号、项目、节点是否存在
• 【系统管理 → 关于】确认版本号

九、升级流程总结（一句话版）

停服务 → 备份 server → 解压新包 → 恢复 conf/data/db → 启动

十、附：常见注意事项

• 升级 Server 不强制要求同步升级 agent
• 如 agent 版本过低，控制台会有提示
• 建议长期将 server_bak_* 保留至少一份