版本升级4.5+

本升级指南支持从 4.0.0 版本开始，将产品升级至最新版本。请严格按照以下步骤操作，以确保升级过程顺利完成。

升级准备

警告！！！

• 严禁覆盖安装： 请勿将新版本直接覆盖到原始安装版本的文件夹中，以免导致不可预知的错误。

在进行产品升级前，务必进行数据备份。若不执行此操作，存在数据丢失的风险。

• 具体备份步骤如下：

  1. 数据库备份：手动备份河图应用连接的数据库数据。

  2. 附件备份：备份附件（用户上传文件及程序生成文件）文件夹。默认路径为河图安装目录下的work文件夹。若修改过application-prod.yml中的安装目录( hetu.file.save-path)信息，请根据配置文件中指定的路径进行数据备份。

升级操作

步骤一：解压安装包。

• 将最新版本的安装包解压到临时目录。例如：

unzip -d /tmp/hetu  hetu-app-4.5.0.zip

步骤二：删除旧文件和文件夹

• 删除原始安装版本中的bin、lib、plugin、web、config（需保留dbconfig.properties文件）、data文件夹。示例命令如下：

rm -rf /opt/hetu/bin
rm -rf /opt/hetu/config/application*
rm -rf /opt/hetu/config/logback-spring.xml
rm -rf /opt/hetu/lib
rm -rf /opt/hetu/plugin
rm -rf /opt/hetu/web
rm -rf /opt/hetu/data

步骤三：移动新版本文件

• 将新版本产品包中的bin、config、lib、plugin、web、data文件夹移动到原始安装版本的安装文件夹中。示例命令如下：

mv /tmp/hetu/bin /opt/hetu/
mv /tmp/hetu/config/* /opt/hetu/config/
mv /tmp/hetu/lib /opt/hetu/
mv /tmp/hetu/plugin /opt/hetu/
mv /tmp/hetu/web /opt/hetu/
mv /tmp/hetu/data /opt/hetu/

步骤四：配置文件与静态文件处理（按需选择）

• 如果之前修改过config文件夹中的配置文件或web文件夹中的静态文件，请在新文件中重新进行相应修改，以确保系统配置和功能的一致性。

步骤五：执行升级脚本

• 进入河图安装目录/bin 文件夹下，执行升级脚本。在执行升级脚本前，请先停止河图程序。升级脚本执行方式如下：

查询安装的版本

• linux: 在 shell 窗口执行./upgrade.sh 原始安装版本的版本号。从 4.5.0 版本开始，可忽略原始安装版本号，直接执行./upgrade.sh，系统将自动获取版本号。

• windows: cmd窗口执行 ./upgrade.bat 原始安装版本的版本号。同样，4.5.0及之后版本可忽略版本号，直接执行./upgrade.bat。

# 4.5.0之前版本需要手动输入原始安装版本号。
# 如：以4.4.0升级到4.5.0为例。
./upgrade.sh 4.4.0
# 4.5.0之后版本可忽略原始安装版本号，使用自动获取。
./upgrade.sh

步骤六：更新公私钥(可选)

• 为保护数据安全，建议原安装版本为2024.1前的进行此操作 更新方式

步骤七：启动与验证

• 完成上述步骤后，启动河图应用，并验证项目数据以及已发布的大屏、看板、门户等是否可以正常访问。确保系统各项功能正常运行，以确认升级成功。