升级 NineData 社区版

NineData 社区版会定期迭代版本，本文档提供 NineData 社区版的升级以及版本回滚指南。

前提条件

• 服务器中已安装旧版本 NineData 社区版。当前版本号，可登录 NineData 社区版控制台查看，位于页面左上角。

  

• 服务器可访问互联网（用于下载新版本镜像）。

• 服务器剩余磁盘空间使用率需低于 85%。

升级步骤

1. 打开终端窗口，停止旧的 NineData 容器。

   docker stop ninedata

2. 备份 NineData 容器的数据目录，以应对特殊情况下需要回滚的场景。默认情况下，数据目录为 /opt/ninedata。

3. 在终端窗口中，删除旧的 NineData 容器。

   docker rm ninedata

4. 输入如下命令启动新版本容器，容器启动后检测到数据目录已存在，则开始自动升级。

   docker run -p 9999:9999 --privileged \
   -v /opt/ninedata:/u01 \
   --name ninedata \
   -d swr.cn-east-3.myhuaweicloud.com/ninedata/ninedata:<版本号>

5. 在命令行输入 docker logs -f ninedata 查看进度，升级过程涉及重新拉起原来版本服务，并以此为基础升级新版本，过程预计需要 20 分钟。待命令行显示如下提示则代表升级完成。

   

验证升级

1. 打开浏览器访问：http://服务器 IP:9999
2. 使用旧版本的账号密码完成登录操作。
3. 查看控制台左上角的版本号是否为最新。
4. 检查最近任务执行记录等是否完整。

回滚至老版本

如遇特殊情况需要回退版本，请执行回滚步骤。回滚步骤整体和升级步骤一致，仅在第 4 步启动容器时，需要指定旧版本号。

危险

回滚操作将导致升级后产生的所有数据被清除，回滚前请妥善备份现有数据目录。

1. 打开终端窗口，停止正在运行的 NineData 容器。

   docker stop ninedata && docker rm ninedata

2. 备份现有数据目录，然后使用升级步骤中第 2 步备份的数据目录完整替换现有数据目录。

3. 执行如下命令启动原版本的容器。

   docker run -p 9999:9999 --privileged \
   -v /opt/ninedata:/u01 \
   --name ninedata \
   -d swr.cn-east-3.myhuaweicloud.com/ninedata/ninedata:<版本号>

4. 在命令行输入 docker logs -f ninedata 查看进度，出现下图提示则代表回滚完成。