本章简要介绍如何在 Linux 服务器上单独部署 Smartbi NLA 模块。


配置需求清单：

组件配置CPU内存硬盘备注

NLA核心服务

最低配置

X86架构 16核

32G+

1TB+

建议单独部署，独占该配置服务器，并要求和Smartbi服务处于同一路由下

推荐配置X86架构 32核128G1TB+，看实际数据量加装

安装前准备

1. 联系Smartbi官方支持获取NLA安装包“nla-setup.zip”

2. 在进行部署前，请先查看 部署环境要求。

部署流程

NLA安装部署流程参考如下

操作步骤

1. 解压

上传安装包到服务器上，并解压

# 解压到当前路径下
unzip nla-setup.zip
# 将其解压到指定路径下
unzip nla-setup.zip -C 路径

给解压目录添加读取、写入、执行权限

# 对当前目录及其子目录的所有内容授予读取、写入和执行的操作权限。
sudo chmod -R 777 nla-setup

2. 安装NLA模块

由于 NLA 和 Smartbi 是分开部署在不同的服务器上，这种部署策略会容易引起跨域问题，因此需要通过给NLA服务器配置代理来解决跨域问题。

NLA 提供两种部署模式，用户可根据实际情况进行选择。

部署模式功能情形
Nginx代理模式使用安装包携带的Nginx来部署代理，操作简单，无需手动部署。
无代理模式

不安装代理

选择无代理模式，需要用户另外给NLA服务器配置代理服务器。


若用户已有代理服务器或

2.1. 无代理模式安装

① 在目录“nla-setup”下执行安装脚本

sh install.sh

安装路径示例： /data/smartbi-nla

是否配置Nginx代理：n

安装路径错误示例： /data/smartbi-nla/

安装路径的最后一定不能添加多一个“/”号

② 安装成功（初次安装的时候就自动加载镜像并启动NLA模块）

③ 进入到安装路径下，启动NLA模块（手动启动的方法，安装时已启动模块）

sh run.sh

2.2. Nginx代理模式安装

① 调用 “sh install.sh” 命令安装

sh install.sh

1）安装路径示例： /data/smartbi-nla

安装路径错误示例： /data/smartbi-nla/

安装路径要求为绝对路径，最后一定不能添加多一个“/”号

2）是否配置代理：y

3）配置Nginx域名：输入Nginx代理服务器的域名，通常采用安装服务器的ip地址就可以了

  • 若用户已购买域名服务，则可输入该域名，用此域名用于代理NLA服务器；
  • 若用户未购买域名服务，则输入NLA服务器的 IP 地址。

例如，体验中心 IP：xx.xx.xxx.xx

4）设置目标 Smartbi 的URL：输入smartbi的服务器地址和端口号

例：http://10.10.31.65:18080/

② 安装成功（初次安装的时候就自动加载镜像并启动NLA模块）

3. 验证安装

通过 “docker ps” 查看当前正在运行中的docker服务数量进行验证，正常启动时运行数量如下：

  • 无代理模式部署的NLA，应有11个docker容器处于运行状态
  • Nginx代理模式部署的NLA，应有12个docker容器处于运行状态

若运行数量与描述一致，且采用 docker ps 命令多次查看其结果都正常，则说明已更新升级成功。若有服务的进程挂掉，则可通过查看对应的日志进行排错，具体可参考 自主排查方案。

# 查看运行中的容器
docker ps

Nginx代理模式部署仅比无代理模式部署增加了一个“smartbi-nla_Nginx_1”容器。

4. 配置连接信息

1）浏览器访问 Smartbi，在 “系统运维”>“更多工具”下找到“自然语言配置”

2）进入“自然语言配置”，输入正确的 NLA访问地址，格式如下：

https://<NLA的代理IP地址>:<代理端口>/aiweb

不同代理模式部署的NLA模块，其代理信息如下：

代理模式备注
Nginx代理模式

使用安装包携带的Nginx来部署代理：

“代理IP地址” 为当前部署的NLA服务器的地址，“代理端口”默认为9060。

安装包自带的Nginx代理模式的默认端口是 9060 ，若冲突可以修改“docker-compose.yaml”文件中的配置项，采用其他开放的未占用端口。


无代理模式

使用无代理模式部署且自行配置了代理方式的

“代理IP地址”和“代理端口”根据自行所配置的代理信息填写。

3）信息正确输入后，点击 测试连接 ，若出现如下图的 测试通过 弹出框，则表示可以成功连接上自然语言分析。如下图所示：

4）测试连接成功后，点击右下角的 保存 按钮保存配置。更多自然语言的配置项说明请参考 自然语言配置。

5）至此 Smartbi NLA 已部署完毕。

运维命令

1. 关闭NLA服务

  • 进入到安装路径下，调用脚本stop.sh
sh stop.sh

2. 卸载NLA模块

  • 进入安装目录下，执行脚本关闭NLA的服务，接着把安装目录删除，便可完成卸载操作。
sh stop.sh
cd ..
rm -rf 安装目录名