平台升级

本文档将指导您完成 Lighthouse 平台的升级操作。

升级须知

在开始升级前，请确保：

已完成数据备份
记录当前版本号：/opt/lighthouse/lighthouse.sh -v
已选择合适的升级时间窗口
已通知相关用户升级期间服务可能短暂不可用

升级准备

确认版本升级路径

版本说明

支持从低版本直接升级到最新版本
建议先在测试环境验证升级流程
如从较早版本（1.8.0 以前）升级，请联系技术支持
由于 1.18.0 版本新增 License 管理功能，从 1.17.0及之前的版本，直接升级到 1.18.0 及以上版本，需要提前手动清空所有数据才可正常使用。如遇此情况，请联系技术支持。

获取升级包

查看当前版本

/opt/lighthouse/lighthouse.sh -v

下载最新安装包

cd /opt
curl https://static.lighthouse.cyritex.com/install.sh | bash

注意事项

确保下载目录有足够的磁盘空间（建议至少预留升级包大小的 3 倍空间）

升级方式选择

方式一：原目录升级（推荐）

适用场景

在原安装目录（默认 /opt）下进行升级
无需更改数据存储位置
适合大多数升级场景

卸载当前版本

cd /opt/lighthouse
./lighthouse.sh uninstall

备份当前版本

cd /opt
mv lighthouse lighthouse-$(./lighthouse/lighthouse.sh -v | grep Version | awk '{print $2}')

解压并安装新版本

版本号替换

请将命令中的 x.x.x 替换为实际下载的安装包版本号，例如:

如果下载的是 1.22.0 版本，则执行: tar -zxvf lighthouse_offline_1.22.0_amd64.tar.gz

tar -zxvf lighthouse_offline_x.x.x._amd64.tar.gz
cd lighthouse
./lighthouse.sh install

方式二：新目录升级

适用场景

需要更改安装目录（例如从 /opt 迁移到 /app）
需要调整数据存储位置
适合系统规划调整场景

迁移数据

cp -a /opt/lighthouse-data  /app/

按方式一的步骤 1-3 执行升级

配置调整

安装前需要修改 .env 文件中的数据目录路径：

# 修改为新的数据目录路径
#BASE_CONFIG_DIR 取的是 lighthouse.sh 所在的目录
`PERSISTENT_PATH=${BASE_CONFIG_DIR}/../lighthouse-data````

升级验证

必要检查

版本和服务状态

# 检查版本号
/opt/lighthouse/lighthouse.sh -v

# 检查服务状态
/opt/lighthouse/lighthouse.sh status

功能验证
- 登录平台检查基本功能
- 验证数据采集是否正常
- 检查已有监控项是否正常工作
- 确认告警功能是否正常

故障处理

如果升级过程中遇到问题：

查看错误日志

# 查看安装日志
tail -f /opt/lighthouse/install.log

# 查看服务日志
docker logs -f lighthouse-server

执行回滚
- 停止新版本服务
- 恢复备份的版本和数据
- 重启服务
获取支持
- 准备版本信息和错误日志
- 联系技术支持团队

升级准备​

确认版本升级路径​

获取升级包​

升级方式选择​

方式一：原目录升级（推荐）​

方式二：新目录升级​

升级验证​

故障处理​