1. 概述编辑
1.1 版本
FineBI 版本 | JAR 包 | 新增功能 |
|---|---|---|
| 5.0 | 2019-06-14 | - |
| 5.1.10 | - | 服务器部署向导页面中，外接数据库配置信息界面中支持设置数据连接 URL |
| 5.1.15 | - | 外接数据库数据更改后，外接数据库用户若没有相关权限，例如：create、alter，工程启动后会进入部署向导页面，给出提示 |
| 5.1.21 | - | 新增「部署环境异常」类报错，用来细化之前 tools.jar 类报错问题 |
| https 工程的 websocket 端口被占用时，进入部署向导页面 |
1.2 应用场景
在进行服务器部署时，会出现部署失败的情况，而导致失败的原因有很多种，此时就需要提供一个页面或者工具来引导用户检测并修复问题。
1.3 功能简介
在服务器部署失败时，引导用户及时检测并修复问题，从而成功部署。
2. 前期准备编辑
配置容器环境如下表所示：
| 容器 | 说明 |
|---|---|
| Tomcat | JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上，详细请参见 Tomcat服务器部署 |
| Weblogic | JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上，详情请参见：Weblogic服务器部署 |
| Wildfly | 详情请参见：Wildfly(JBoss)9~18服务器部署、Wildfly(JBoss)8服务器部署 |
| WebSphere | 详情请参见：Linux 系统 Websphere 服务器部署 |
| Resin | 详情请参见：Resin服务器部署 |
| Docker | 详情请参见：Docker 部署 FineBI |
3. 服务器部署向导检测内容编辑
3.1 部署环境异常
报错页面如下图所示：
详情请参见：部署环境异常
3.2 数据库
3.2.1 内置数据库连接失败
内置数据库连接失败时，报错内容如下图所示：
3.2.2 外接数据库连接失败
外接数据库连接失败时，报错内容如下图所示：
修改外接数据库相关配置后，点击「重新检测」，连接成功则直接启用新的数据库；若连接的数据库无表信息，则提示目标数据库为新数据库，无法使用
3.3 websocket 端口异常
websocket 端口冲突时，报错页面如下图所示：
注：5.1.21 版本，https 工程的 websocket 端口被占用时，报错页面与下图一样。
3.4 没有外接数据库相关权限
外接数据库数据更改后，外接数据库用户若没有相关权限，例如：create、alter，工程启动后会进入部署向导页面，给出提示。如下图所示：
注：外接数据库用户，在升级时若没有数据库相关权限，则会给出提示，终止升级。
4. 示例编辑
这里以 Tomcat 容器为例进行演示。将 %BI_HOME%/webapps/webroot 文件夹复制到 %TOMCAT_HOME%/webapps 文件夹下，启动 Tomcat。
4.1 跳转部署向导页面
工程启动失败后，访问平台http://localhost:8080/webroot/decision，webroot 工程启动失败，自动跳转到服务器部署向导页面 http://localhost:8080/webroot/decision/v10/deployment/recommendation，如下图所示：
4.2 根据提示操作
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%\webapps\webroot\WEB-INF\lib文件夹下，如下图所示：
4.3 部署成功
重启 Tomcat ，此时再次访问平台http://localhost:8080/webroot/decision，跳转到登录页面，即部署成功。如下图所示：
