配置需求清单：
| 组件 | 配置 | CPU | 内存 | 硬盘 | 备注 |
|---|---|---|---|---|---|
NLA核心服务 | 最低配置 | X86架构 16核 | 32G+ | 1TB+ | 建议单独部署，独占该配置服务器，并要求和Smartbi服务处于同一路由下 |
| 推荐配置 | X86架构 32核 | 128G | 1TB+，看实际数据量加装 |
安装前准备
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 提供两种部署模式，用户可根据实际情况进行选择。
| 部署模式 | 功能 | 情形 |
|---|---|---|
| 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. 配置Smartbi
1）登录 Smartbi，在 “系统运维”>“更多工具”下找到“自然语言配置”
2）进入“自然语言配置”，填写NLA访问地址，格式如下：
https://<NLA的代理IP地址>:<代理端口>/aiweb
不同代理模式部署的NLA模块，其代理信息如下：
| 代理模式 | 备注 |
|---|---|
| Nginx代理模式 | 使用安装包携带的Nginx来部署代理： “代理IP地址” 为当前部署的NLA服务器的地址，“代理端口”默认为9060。 安装包自带的Nginx代理模式的默认端口是 9060 ，若冲突可以修改“docker-compose.yaml”文件中的配置项，采用其他开放的未占用端口。 |
| 无代理模式 | 使用无代理模式部署且自行配置了代理方式的 “代理IP地址”和“代理端口”根据自行所配置的代理信息填写。 |
3）信息正确输入后，点击 测试连接 ，若出现如下图的 测试通过 弹出框，则表示可以成功连接上数据库。如下图所示：
4）测试连接成功后，点击右下角的 保存 按钮保存配置。
运维命令
1. 关闭NLA服务
- 进入到安装路径下，调用脚本stop.sh
sh stop.sh
2. 卸载NLA模块
- 进入安装目录下，执行脚本关闭NLA的服务，接着把安装目录删除，便可完成卸载操作。
sh stop.sh cd .. rm -rf 安装目录名
