1. 概述
1.1 版本
FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0 | - |
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服务器部署 |
3. 服务器部署向导检测内容
3.1 部署环境异常
报错信息：部署环境异常
解决方案：详情请参见：部署环境异常
报错页面如下图所示：
3.2 数据库连接异常
3.2.1 内置数据库连接失败
报错信息：数据库连接异常，内置数据库连接失败。
解决方案：请删除WEB-INF/embed/finedb目录下的db.lck文件。
3.2.2 外接数据库连接失败
报错信息：数据库连接异常，外接数据库连接失败。
解决方案：
请确认数据库连接信息，修改外接数据库相关配置后，点击「重新检测」，连接成功则直接启用新的数据库。
请注意该数据库中必须有finedb表信息，若无表信息，则提示目标数据库为新数据库，无法使用
3.3 websocket 端口异常
报错信息：websocket端口异常
解决方案：websocket 端口被其他进程占用，需要修改一个空闲可用端口。
3.4 外接数据库异常
报错信息：外接数据库异常，并有报错提示：请检查数据库用户是否具有表的创建和修改权限，或查看数据库日志排查问题。
解决方案：
先检查下是不是用户没有数据库创建和修改表的权限，如果是请给用户开权限。
如果不是查看数据库日志进一步排查问题。
注：外接数据库用户，在升级时若没有数据库相关权限，则会给出提示，终止升级。
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，跳转到登录页面，即部署成功。如下图所示：
