1. 使用对象
本文针对已部署 Data Agent 中「FineAI」、「FineAI Redis」、「FineChatBI 语义解析小模型」三个组件容器，但未部署「postgresql」容器的用户。
2. 升级运维平台与FineBI
请按顺序先升级运维平台，再升级 FineBI 平台。
| 运维平台 | FineBI |
|---|---|
参考文档将运维平台升级至 V2.36 及以上。 | 参考文档将 FineBI 项目升级到 7.0.7 及以上。 |
3. 备份fine-ai外挂
提示:1）以下备份迁移操作不涉及历史会话，仅作用于上传的文件及产物。
2）由于历史会话不迁移，因此无在历史会话中查看产物，若需要历史会话记录，请联系帆软做迁移工作，且做好 checkpoint 备份。
3.1 确认外挂目录位置
参考【导出项目部署信息】文档操作，导出部署信息查看外挂路径。
以外挂目录为：/data-ssd/dora/fanruan260513103732/fine-ai/ 为例，效果如下所示：
3.2 备份文件
1）备份 runtime 目录下除 checkpoints.sqlite 之外的所有文件。
注：若需要保留历史会话记录，请备份整个 runtime 目录，包括 checkpoints.sqlite。
2）runtime 可能位于以下两个位置之一，请先确认实际路径：
fine-ai/runtime
fine-ai/logs/_runtime
3）备份并检查是否成功（命令根据实际情况修改）：
# 示例：以 /data-ssd/dora/fanruan260513103732/fine-ai/logs/_runtime 为例
sudo tar -czvf /tmp/fine-ai-backup.tar.gz \
-C /data-ssd/dora/fanruan260513103732/fine-ai/logs/_runtime \
--exclude=df/checkpoints.sqlite \
.
4. 卸载原Data Agent相关容器
管理员登录运维平台，卸载「FineAI」、「FineAI Redis」、「FineChatBI 语义解析小模型」容器。
4.1 操作前重要提示
1）卸载须知：
本操作将永久删除 Dora 历史会话与记忆，保留 Agent 相关配置，删除后所有内容不可恢复！
请务必在卸载容器前慎重评估相关影响，帆软无法对已卸载的容器进行任何恢复操作。
2）建议操作：
在卸载项目前，强烈建议自行对项目涉及的所有服务器进行快照备份。快照备份操作步骤请自行咨询你的服务器运维人员。
通过快照恢复的项目仅可找回相关资料，不确保项目及对应容器仍然可用。
必须完成本文【3. 备份fine-ai外挂】与【6. 恢复备份数据】操作，否则将影响此前在 Dora 中数据源为 Excel/CSV 的 Agent，需要手动在这些 Agent 配置页中，删除并重新添加数据源。
4.2 卸载步骤
1）进入开发者模式
管理员登录运维平台，点击项目，点击「维护>组件管理」。
点击「进入开发者模式>确定」，即可进入开发者模式。
2）卸载容器
在开发者模式界面，找到对应容器，点击「卸载容器」。
弹出提示「卸载后此容器和挂载目录将全部被清理并无法恢复！如确定卸载，请输入容器名称：」
手动输入容器名称后，点击「确定」，运维平台会自动对该容器和相关资源依次卸载。
5. 重新部署Data Agent组件
卸载完成后，请参考部署文档第 5 节：【5. 部署Data Agent组件】 重新部署。
6. 恢复备份数据
1）确认备份的目标位置，即检查新外挂目录的 runtime 位置；
2）使用以下命令，将本文【3.2 备份文件】步骤中打包的备份文件拷贝至目标位置：
# 示例：备份文件包与目标位置需用户对应修改
sudo cp /tmp/fine-ai-backup.tar.gz /data-ssd/dora/fanruan260513103732/fine-ai/runtime/
3）使用以下命令，进入目标位置并解压备份文件包：
# 示例：备份文件包与目标位置需用户对应修改
cd /data-ssd/dora/fanruan260513103732/fine-ai/runtime
sudo tar -xzvf fine-ai-backup.tar.gz
7. 重启FineAI
1）完成以上操作后，管理员登录运维平台，点击项目，点击「维护>组件管理」。
2）找到「FineAI」组件，点击「重启」。
8. 升级Data Agent插件
升级完成后，将 【配置Data Agent插件】章节中安装的插件升级到最新。
9. 验证升级操作
前「Dora >管理平台> Agent」，选择此前配置了 Excel/CSV 作为数据源的 Agent，保存并发布该 Agent，若无报错情况，则为升级成功。
上一篇：升级Data Agent