规则模型部署手册

本文将介绍如何部署 BI 规则模型和安装 BI 问答插件，对部署需求、部署步骤以及后续的版本更新提供了说明和指导。

2.1 BI 工程要求

在使用问答 BI 前，需要先在服务器上部署 BI 6.1及以上版本的工程。

1）若没有 BI 工程，需要先在服务器上部署 BI 工程，部署要求以及部署方法可参考：工程部署方案选择

2）若已有 BI 工程，使用超管账号登陆 FineBI 系统，点击「管理系统>注册管理>版本信息」，即可查看工程的版本号。若工程版本为 6.1 以下，请参考 FineBI 版本升级 将工程升级至 6.1及以上版本。

2.2 BI 规则模型要求

BI规则模型和 BI 工程建议分布部署在两台服务器上，若需要部署在同一台服务器上请注意预留出足够的空间。

BI 规则模型部署环境要求如下表所示：

1）获取 「镜像」：下载镜像文件

2）获取「代码」压缩包：联系运营获取

3）获取 「问答BI 插件」：联系运营获取

4.1 安装 Docker

安装步骤中需要使用到 Docker，请先检查服务器中是否已完成安装 Docker，检查 Docker 命令：docker --version

• 若没有安装则会显示 command not found，如下图所示，此时则需要在服务器上安装 Docker，安装步骤可参考：Linux系统安装Docker

• 若已安装则会显示 Docker 的版本信息，如下图所示：

4.2 安装镜像

0）（可选）镜像文件完整性校验
安装镜像过程失败时，可查看镜像文件 md5 码和本文档是否一致，若不一致则需要重新下载文件。

示例代码：md5sum fine-chat-bi-parser-base_v1_6.tar

1）将 「镜像」上传到服务器中指定的文件夹中

示例上传文件夹路径为：/home/AI

注：直接上传，上传后不要解压！！！

2）使用命令进入到文件夹路径，命令为：cd 文件夹路径

示例代码：cd /home/AI

3）检查文件

示例代码：ls

4）运行镜像文件，命令为：docker load -i 镜像文件压缩包

示例代码：docker load -i fine-chat-bi-parser-base_v1_6.tar

5）运行完成后，使用命令检查，出现镜像的名称和版本号即为完成，命令为：docker images

示例代码：docker images

6）使用命令运行镜像，命令为：docker run -it -e TZ=Asia/Shanghai --name fine-chat-bi-parser-base -d -p 8666:8666 基础镜像名称:基础镜像版本号

示例代码：docker run -it -e TZ=Asia/Shanghai --name fine-chat-bi-parser-base -d -p 8666:8666 fine-chat-bi-parser-base:v1.6

7）使用命令检查容器，命令为：docker ps

4.3 安装代码

1）将获取的代码文件 encrypt_vXX_XXX.tar 包上传至服务器，之后再解压。命令为：tar -xvf 代码文件路径/代码文件名称

示例代码：tar -xvf /home/AI/encrypt_v1_5_1.tar

2）将代码文件放置到镜像中，命令为：docker cp 代码文件路径/代码文件名称 fine-chat-bi-parser-base:/root/

示例代码：docker cp /home/AI/encrypt_v1_5_1/ fine-chat-bi-parser-base:/root/

3）进入镜像的 /bin/bash 文件夹中，命令为：docker exec -it 镜像名称 /bin/bash

示例代码：docker exec -it fine-chat-bi-parser-base /bin/bash

4）进入代码文件夹，命令为：cd /root/代码文件名称/pipeline/

示例代码：cd /root/encrypt_v1_5_1/pipeline/

5）运行代码，命令为：python app.py

示例代码：python app.py

6）可直接关闭终端，或依次按下 Ctrl+P 和 Ctrl+Q 退出 Docker 容器。

1）超管登录管理平台，选择「管理系统>插件管理>应用商城」，选择从本地安装获取的安装包，完成安装即可。该插件，需要先禁用，再启用。

2）完成后刷新页面，选择「管理系统>智能问答配置」，配置 规则模型的 ip 地址和端口号（默认端口为8666），测试成功后，点击保存即可。

3）在管理系统右下角出现「问答BI」按钮即可完成，如下图所示：

6.1 升级至 3.11.0 版本

若用户当前所使用的为 3.11.0 之前的版本，期望能够体验 3.11.0 及之后版本的新功能，那么需要更新镜像。

更新内容：

1）减少镜像占用的磁盘空间，相比上一版本减少约 10GB

2）兼容后续版本的新功能

在升级之前，共创用户请提供您日志文件（路径/root/encrypt_v1_5_1/pipeline/logs下的所有日志文件）给帆软运营团队。

具体的升级步骤请参照以下说明：

6.1.1 删除历史容器

1）终止运行中的 chat2chart 容器，命令为：docker stop chat2chart

2）删除 chat2chart 容器，命令为：docker rm chat2chart

3）清理镜像文件，释放磁盘空间，命令为：docker rmi chat2chart_base:v1.5 

6.1.2 重新部署 BI 规则模型

1）获取最新的安装包，参考本文第 3 节。

2）使用 3.11.0 及以上安装包部署 BI 规则模型，参考本文第 4 节。

6.1.3 更新问答 BI 插件

1）超管登录管理平台，选择「管理系统>插件管理>我的插件」。

2）选择从本地安装获取的新版本安装包，更新插件。

3）清空缓存并刷新页面。

4）进入智能问答配置，手动刷新预加载，即可完成镜像升级

6.2 其他版本升级

若是不需要跨 3.11.0 版本的升级，则只需要分别更新镜像中的代码和工程中插件。

升级前需获取新版本「代码」压缩包和新版本的 「问答BI 插件」安装包，具体的升级步骤请参照以下说明：

6.2.1 更新代码

1）使用命令进入容器，命令为：docker exec -it 镜像名称 /bin/bash 

2）查看进程号，命令为：ps -ef | grep app.py 

3）关闭进程，命令为：kill -9 进程号

4）退出容器，命令为：exit

5）将获得的新代码压缩包上传到服务器中

6）将代码文件放置到镜像中，命令为：docker cp 代码文件路径/代码文件名称 chat2chart:/root/

7）进入镜像的 /bin/bash 文件夹中，命令为：docker exec -it 镜像名称 /bin/bash

8）进入代码文件夹，命令为：cd /root/代码文件名称/pipeline/

9）运行代码，令为：nohup python app.py &（终端显示nohup: ignoring input and appending output to 'nohup.out'命为正常现象）

6.2.2 更新插件

1）超管登录管理平台，选择「管理系统>插件管理>我的插件」。

2）选择从本地安装获取的新版本安装包，更新插件。

3）清空缓存并刷新页面。

7.1 加载镜像时报错“no space left on device”

大概率因为 docker 数据默认存放路径 /var/lib/docker 被分配的硬盘空间不足。可执行 df -Th /var/lib/docker/ 查看被分配的空间大小。

解决办法：改变 docker data-root 路径

1）修改 /etc/docker/daemon.json 文件，没有则新建文件夹及文件，并将 data-root 修改为硬盘空间充足的路径：

{
    "data-root": "/硬盘空间大的路径"
}

2）重启 docker

命令示例：systemctl restart docker