1. 使用对象
本文针对已部署 Data Agent 中「FineAI」、「FineAI Redis」、「FineChatBI 语义解析小模型」三个组件容器，但未部署「postgresql」组件容器的用户。
注： PostgreSQL 组件为 Data Agent 运行所必备组件，必须部署。
2. 升级运维平台与FineBI
请按顺序先升级运维平台，再升级 FineBI 平台。
| 运维平台 | FineBI |
|---|---|
参考文档将运维平台升级至 V2.41.0 及以上。 | 参考文档将 FineBI 项目升级到 7.0.8 及以上。 |
3. 备份fine-ai外挂
提示:1）以下备份迁移操作不涉及历史会话，仅作用于上传的文件及产物。
2）由于历史会话不迁移，因此无法在历史会话中查看产物，若需要历史会话记录，请联系帆软做迁移工作，且做好 checkpoint 备份。
3.1 确认外挂目录位置
参考【导出项目部署信息】文档操作，导出部署信息查看外挂路径。
以外挂目录为：/data-ssd/dora/fanruan260513103732/fine-ai/ 为例，效果如下所示：
3.2 备份文件
1）备份 runtime 目录下除 checkpoints.sqlite 之外的所有文件。
注：
1）若需要保留历史会话记录，请备份整个 runtime 目录，包括 checkpoints.sqlite，备份后联系帆软进行迁移工作。
2）若无重大历史会话文件，建议直接按照文档进行备份。
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插件
提示:1）点击下载最新版 Data Agent 插件
2）管理员登录 FineBI，点击「管理系统>插件管理>我的插件」
3）点击「从本地更新」，选择获取的最新 Data Agent 插件安装包，完成安装即可。
注：插件包较大，因此安装时间较长，请耐心等待。
5. 卸载原Data Agent相关容器并重新上传镜像
管理员登录运维平台，卸载「FineAI」、「FineAI Redis」、「FineChatBI 语义解析小模型」容器后，上传新 Data Agent 镜像内容。
5.1 操作前重要提示
1）卸载须知：
本操作将永久删除 Dora 历史会话与记忆，保留 Agent 相关配置，删除后所有内容不可恢复！
请务必在卸载容器前慎重评估相关影响，帆软无法对已卸载的容器进行任何恢复操作。
2）建议操作：
在卸载项目前，强烈建议自行对项目涉及的所有服务器进行快照备份。快照备份操作步骤请自行咨询你的服务器运维人员。
通过快照恢复的项目仅可找回相关资料，不确保项目及对应容器仍然可用。
必须完成本文【3. 备份fine-ai外挂】与【7. 恢复备份数据】操作，否则将影响此前在 Dora 中数据源为 Excel/CSV 的 Agent，需要手动在这些 Agent 配置页中，删除并重新添加数据源。
5.2 卸载步骤
1）进入开发者模式
管理员登录运维平台，点击项目，点击「维护>组件管理」。
点击「进入开发者模式>确定」，即可进入开发者模式。
2）卸载容器
在开发者模式界面，找到对应容器，点击「卸载容器」。
弹出提示「卸载后此容器和挂载目录将全部被清理并无法恢复！如确定卸载，请输入容器名称：」
手动输入容器名称后，点击「确定」，运维平台会自动对该容器和相关资源依次卸载。
5.3 获取镜像包
若您已使用「全量版离线安装包」部署运维平台至 V2.41.0 及以上，可跳过此步骤，无需再次获取 DataAgent 镜像。
注1：对于信创版 FineBI，支持在 ARM 架构的信创服务器中添加AI服务。
注2：本文提供的镜像均为最新 AI 镜像，不同 FineBI 版本适配不同版本的AI镜像。如需历史版本镜像，请联系帆软技术支持获取。
| AMD64（X86_64）架构 | |
|---|---|
| ARM64 架构 |
5.4 上传镜像包
管理员登录运维平台，点击「运维平台管理>运维组件」。
点击「导出部署信息」，导出成功后会提示导出的文件地址。
前往运维平台所在服务器，在导出文件所在的 logs 目录，同级目录下，有一个 resources 文件夹，即为镜像上传位置。
例如本示例，导出文件所在文件夹为/home/ops/fanruan_5d15bea4/ops/logs，那么镜像上传位置为/home/ops/fanruan_5d15bea4/ops/resources
请将上一步下载的两个镜像.tar.gz文件，上传到 resources 文件夹中
5.5 推送入库
管理员登录运维平台，点击「维护中心>镜像管理」，点击「加载镜像」。
即可选择 resources 下的两个 AI 镜像文件进行加载，加载完成后 resources 下的镜像文件会被删除。
5.6 确认并修改部署版本
推送成功后，管理员登录运维平台，点击「维护中心>镜像管理」，查看推送到仓库的新镜像。
找到刚刚推送的「fine-ai-bi7」、「fine-chat-bi-parser-bi7」、「postgresql」、「redis」镜像，记下版本号。
管理员登录运维平台，点击「运维平台管理>更新升级>部署列表>自动修改」。
运维平台将自动识别 FineOps 镜像仓库中各镜像的最新版本，并修改 AI 相关组件的镜像版本号，DataAgent 将按更新后的版本部署。请确认 DataAgent 的部署版本与上述步骤中上传的镜像版本一致。
6. 重新部署Data Agent组件
卸载完成后，请按照以下操作步骤，重新部署 Data Agent 组件。
6.1 进入添加组件界面
管理员登录运维平台，选择对应 FineBI 项目，点击「维护>组件管理」按钮。
点击「添加组件」，选择添加组件类型「业务服务>AI」。
注：
1）AI 组件的部署入口，默认不直接对外开放。请在浏览器按 F12 打开开发者工具，在控制台执行 Ops.supportAI()，打开 AI 部署入口。
2）若启用后仍未显示「AI」入口，请检查组件管理中是否存在未完全卸载的旧组件：fine-ai-bi7、fine-chat-bi-parser-bi7、fine-ai-redis、postgresql，残留旧组件会阻塞入口的正常呈现。
6.2 配置AI文件服务
无论选择低、中、高哪一版服务器配置，均需为其配置AI文件服务，支持复用 FineBI 服务器中已有的 MinIO 服务或对接已有的S3文件服务器。
支持对接的 S3 服务器可参考文档：DataAgent对接华为云OBS实现文件服务、DataAgent对接阿里云OSS实现AI文件对接、DataAgent对接MinIO实现文件服务
6.3 新增节点（选做）
如为AI组件准备了全新服务器，需要先将该服务器添加到项目节点中。
点击「新增节点」按钮，输入服务器信息，点击「新增节点」，等待添加完成即可。
具体节点设置如下表所示：
| 节点设置 | 说明 |
|---|---|
| 节点类型 | 请选择「组件」 该组件服务器上不建议部署其他工程或内容 |
| 主机 | 请输入节点主机IP（内网IP） 注：同一项目中，主机不支持重复添加多次 |
| 端口 | 请输入节点端口号，默认为22 |
| 用户名 | 请输入有sudo权限的服务器用户名 |
| 验证方法 | 支持两种：密码、公钥 注1：密码密钥仅用于部署项目，部署结束后无需使用，项目与运维平台的对接依赖平台配置。 因此后续如修改了服务器密码，不会对运维监控产生影响。 注2：如选择公钥方式验证 请上传后缀为.key / .pem / .crt的私钥文件（例如id_rsa.key） 请勿上传其他后缀格式的私钥文件，请勿上传公钥文件（例如id_rsa.pub） |
| 挂载路径 | 请输入节点安装目录的服务器路径，即【2. 准备Data Agent服务器】环节设置的挂载目录 默认为~/data，~代表所使用的服务器用户的主目录 注：可在终端使用该用户账号访问服务器，输入echo $HOME命令查看该用户的主目录路径 |
| 外网IP | 选填项 如果服务器不支持内网访问，仅支持外网映射，可以填写可联通的外网IP |
6.4 选择节点
选择需要用于部署 AI 组件的项目节点。
节点最低配置为CPU16核、可用内存32G、可用磁盘500G。低于该配置的节点灰化不可选。
6.5 确认服务配置
建议组件使用默认端口，若部署环境网络限制严格，请根据文档【确认DataAgent项目服务器配置】，准备的可用空闲端口，对每一个组件的端口进行调整。
注：
1）请务必修改 FineAI Redis 组件与 postgresql 组件的密码，组件的默认密码随机生成，部署成功后无法修改。
2）postgresql 组件用户名：fine_ai_checkpoint_user
6.6 开始部署
点击「开始部署」按钮，自动在所选节点中部署 AI 相关组件。若部署失败则显示失败原因。
6.7 配置WORKER参数（选做）
若 DataAgent 服务器选择中配或高配，需配置双 WORKER 参数。
单个 fine-ai 容器内默认运行 1 个worker，最多配置 2 个worker。
请按照以下步骤操作：
1）管理员登录运维平台，选择对应 FineBI 项目，点击「维护>组件管理」按钮。
2）点击「进入开发者模式」，选择「fine-ai 组件>自定义环境变量」。
3）在弹窗中，添加环境变量：FINE_AI_UVICORN_WORKERS=2。
7. 恢复备份数据
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
8. 重启FineAI
1）完成以上操作后，管理员登录运维平台，点击项目，点击「维护>组件管理」。
2）找到「FineAI」组件，点击「重启」。
9. 验证升级操作
前往「Dora >管理后台> Agent」，选择此前配置了 Excel/CSV 作为数据源的 Agent，保存并发布该 Agent，若无报错情况，则为升级成功。