NLA模块的升级，需要访问到NLA所在服务器上，修改NLA模块安装目录下的文件。
| 注意 |
|---|
| ！！！在升级版本后，需要重新清理浏览器缓存再访问自然语言查询平台！！！ |
| 目录 |
|---|
1. 更换服务包
1.1. Services目录概要
使用软件WinSCP（跨平台文件传输工具）远程访问NLA所在服务器上NLA根目录下的services目录。services目录结构如下：
- services目录下存放着java和python服务的依赖文件，每个文件夹对应一个python服务，每个jar包对应一个java服务。
1.2. 服务模块升级
1.2.1. 单一服务模块
- 单一的服务模块升级，只需要更换services下对应的包即可：
① 如果是python的服务需要升级，就更换对应服务的文件夹。例如nl2sql服务升级了，则需替换掉nl2sql整个文件夹内所有文件。
② 如果是 .jar的包需要升级，需要在更换对应jar包的同时，更换“common” 、“config” 、“voiceengineproxy”这三个jar包。
1.2.2. 多个服务模块
- 若是需要升级多个服务模块，建议直接替换整个services文件夹。
- 用services替换掉：/NLA安装路径/services
2. 更换镜像
- 加载新镜像
| 注意 |
|---|
更新所需资源可联系 Smartbi 官方支持获取。 在进行版本更新后，需要重新清理浏览器缓存再访问 Smartbi。 |
安装目录结构
自然语言分析的安装目录结构如下：
| 文件或目录名 | 用途 |
|---|---|
| backup | 备份目录，用来备份配置和元数据 |
| config | 深度学习服务的配置目录 |
| data | 深度学习服务的元数据 |
| nginx_conf | ngxin配置文件目录 |
| scripts | docker 加载服务使用的脚本 |
| services | docker服务挂载目录，用于更新 |
| logs | 日志文件 |
| docker-compose.yml | docker服务的启动脚本 |
| run.sh | 启动服务脚本 |
| stop.sh | 停止服务脚本 |
1. 停止NLA服务
停止旧版 Smartbi-NLA 的服务。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 进入Smartbi-NLA的安装目录下，实际操作时请将“/Smartbi-NLA 安装目录”更换为实际安装目录
cd /Smartbi-NLA 安装目录
# 停止服务
sh stop.sh |
2. 服务包更新
通常版本更新仅涉及目录 services、config 以及 data目录下的nl2sql_data，根据实际发包内容进行选择性更新即可。
| 注意 |
|---|
| 备份目录名的格式请按照“bk_目录名_版本更新当天时间”的格式进行命名。 |
2.1. 更新services
参考以下步骤对旧版的“services”目录进行备份后，上传新的“services”目录到Smartbi-NLA 安装目录下。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 进入安装目录下
cd /Smartbi-NLA 安装目录
# 备份docker服务挂载目录
mv services /backup/bk_services_20220112 |
2.2. 更新config
参考以下步骤对旧版的“config”目录进行备份后，上传新的“config”目录到Smartbi-NLA 安装目录下。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 进入安装目录下
cd /Smartbi-NLA 安装目录
# 备份深度学习服务的配置目录
mv config /backup/bk_config_20220112 |
2.3. 更新nl2sql_data
参考以下步骤对旧版的“nl2sql_data”目录进行备份后，上传新的“nl2sql_data”目录到Smartbi-NLA 安装目录的data下。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 进入安装目录的data目录下
cd /Smartbi-NLA 安装目录/data
# 备份nl2sql服务的元数据
mv nl2sql_data ../backup/bk_nl2sql_data_20220112 |
2.4. 更换镜像
上传新镜像文件到服务器上，加载新镜像。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
docker load -i <新镜像文件名> |
接着进入NLA的安装目录下，修改docker-compose.
yml文件，将image（镜像名）修改为更新后的镜像:yml文件，手动将image（镜像名）修改为更新后的镜像，例如：
| 更新前 | image: "aienv4j:v2" |
|---|---|
| 更新后 | image: "aienv4j:v3" |
| 代码块 | ||||
|---|---|---|---|---|
| ||||
cd /SmartbiNLA安装目录
vi docker-compose.yml |
3.
更换nl2sql_data配置项用nl2sql_data替换掉：/NLA安装路径/data/nl2sql_data启动NLA服务
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 进入Smartbi-NLA的安装目录下，实际操作时请将“/Smartbi-NLA 安装目录”更换为实际安装目录
cd /Smartbi-NLA 安装目录
# 启动服务
sh run.sh |
4. 检查升级
通过查看当前正在运行中的docker服务数量进行验证，正常启动时运行数量如下：
- 无代理模式部署的NLA，应有12个docker容器处于运行状态；
- Nginx代理模式部署的NLA，应有13个docker容器处于运行状态。
运行数量与描述一致则说明已更新升级成功。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 查看运行中的容器
docker ps |
