此流程有助于确保平稳过渡,最大限度地减少停机时间,并保障数据完整性。尽可能先在非生产环境中进行测试。
备份、卸载、重新安装和恢复流程
开始之前的重要提示:
数据库备份和恢复步骤最为关键。务必确保该步骤成功完成后再继续下一步。
- 以管理员身份运行所有命令提示符。
- 这些说明基于标准的 JMP Live 本地部署实践(涉及 JMP Pro、通过 JMP Live Database 安装程序部署的 PostgreSQL 数据库、Keycloak 和 JMP Live 服务)。
- 由于服务将离线,请安排在维护窗口期间进行此操作。
第一步:准备和备份
1. 将配置文件备份到新文件夹(例如 C:\Backup)
- 找到并复制位于 JMP Pool 和 JMP Live 安装目录中的 .env 文件。这两个文件将会被重复使用。
- 备份 Keycloak .conf 文件(仅供参考;不能直接重复使用)。
重要提示:请确保所有证书(certs)均未存储在默认的“程序文件”文件夹中,因为卸载程序时该文件夹将被删除。如有需要,请将其移动到安全位置。
2. 停止所有 JMP Live 服务
- 打开服务(services.msc)并停止:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
步骤 2:数据库备份
1. 打开提升权限的命令提示符(以管理员身份运行)。
2. 导航至 (cd) Backups 文件夹
3. 执行以下数据库备份命令:
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- 更新命令中的文件路径,使其与您的安装路径匹配。
4. 监控进度,因为这可能需要相当长的时间,具体取决于数据库的大小。
5. 在继续操作之前,请确认备份文件存在且不为空/不损坏。
- 这一步骤至关重要,因为备份失败会导致数据丢失。
- 必须备份和恢复整个 JMP Live 数据库,否则不能保证新部署能够正常工作。
步骤 3:卸载现有组件
请按任意顺序卸载以下程序(通过控制面板 > 程序和功能 或 添加/删除程序):
- JMP Live
JMP Pro
- JMP Live Database(PostgreSQL 实例)
- 钥匙斗篷
步骤 4:数据库的安装和恢复
1. 安装 JMP Live 自解压可执行文件中包含的 JMP Live 数据库组件。
2. 使用相同的提升权限的命令提示符和备份文件夹,运行以下还原命令。
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- 更新命令中的文件路径,使其与您的安装路径匹配。
3. 确认恢复操作成功完成(检查日志或查询数据库)。
步骤 5:安装其他 JMP Live 组件
请严格按照以下顺序安装:
1. JMP Pro
2. 钥匙斗篷
- 安装过程中,输入所需的管理员和数据库设置。
- 在记事本中打开备份的 Keycloak .conf 文件,用作配置值(例如,端口、管理员凭据、数据库连接)的参考。
3. JMP Live
- 安装过程中,如果您计划在安装后覆盖 .env 文件,则提示信息无需完全准确。
- 确保在提示时正确指定 JMP Pro 安装路径(或稍后在 JMP Pool .env 文件中更新它;即更改任何 18 → 19 引用)。
步骤 6:安装后配置
1. 再次停止服务(如果已自动启动):
- 打开服务(services.msc)并停止:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. 覆盖配置文件
- 将 JMP Pool 和 JMP Live 目录中的新 .env 文件替换为备份副本。
- 检查并更新所有版本特定的路径(例如 JMP Pro 路径 18 → 19)。这些路径可以在记事本中编辑。
保存更改。
3. 启动 JMP Live
- 导航至:`C:\Program Files\JMP\JMP Live\`(或您的安装路径)。
- 以管理员身份运行 `launch.cmd`。
- 等待两个命令提示符窗口完成初始化,然后关闭它们。
4. 开始服务
- 打开服务 (services.msc) 并按以下顺序启动:
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
步骤 7:最终核实和重新授权
1. 访问 JMP Live Administrator Web 界面。
- https://URL/admin/login
2. 以管理员身份登录。
3. 转到“管理”选项卡。
4. 重新授权 JMP Live(按照屏幕提示完成许可/连接验证)。
5. 测试关键功能:从桌面版 JMP Pro 发布示例报告,验证用户访问权限,检查数据刷新等。
如果出现问题:
- 检查服务状态和日志。
- 验证数据库连接和 Keycloak 领域设置。
- 请查阅官方 JMP Live 安装说明或联系 JMP 技术支持。