1. 概述
1.1 版本
报表服务器版本 | JAR 包 | 新增功能 |
|---|---|---|
| 10.0 | 2019-05-20 | - |
| 10.0.14 | - | 服务器部署向导页面中，外接数据库配置信息界面中支持设置数据连接 URL |
| 10.0.18 | - | 外接数据库数据更改后，外接数据库用户若没有相关权限，例如：create、alter，工程启动后会进入部署向导页面，给出提示 |
1.2 应用场景
在进行服务器部署时，会出现部署失败的情况，而导致失败的原因有很多种，此时就需要提供一个页面或者工具来引导用户检测并修复问题。
1.3 功能简介
在服务器部署失败时，引导用户及时检测并修复问题，从而成功部署。
2. 前期准备
配置容器环境如下表所示：
| 容器 | 说明 |
|---|---|
| Tomcat | 详情请参见：Linux 下 Tomcat 服务器部署包、Linux 下 Tomcat 服务器独立部署 |
| JBoss | JBoss6.4 服务器部署 |
| WebLogic | WebLogic 服务器文件夹部署、WebLogic 服务器 war 包部署 |
| WebSphere | WebSphere8.5 服务器部署 |
| Resin | Resin 服务器的部署 |
3. 部署报错页面
3.1 tools.jar
3.1.1 tools.jar 不匹配
tools.jar 不匹配时，报错内容如下图所示：
3.1.2 工程缺少 tools.jar
工程缺少 tools.jar 时，报错内容如下图所示：
3.2 数据库连接异常
3.2.1 内置数据库连接失败
内置数据库连接失败时，报错内容如下图所示：
3.2.2 外接数据库连接失败
外接数据库连接失败时，报错内容如下图所示：
修改外接数据库相关配置后，点击「重新检测」，连接成功则直接启用新的数据库；若连接的数据库无表信息，则提示目标数据库为新数据库，无法使用
3.3 websocket 端口异常
websocket 端口冲突时，报错页面如下图所示：
3.4 外接数据库异常
提示外接数据库异常，并有报错提示：请检查数据库用户是否具有表的创建和修改权限，或查看数据库日志排查问题。
先检查下是不是用户没有数据库创建和修改表的权限，如果是请给用户开权限，如果不是查看数据库日志进一步排查问题。
注：外接数据库用户，在升级时若没有数据库相关权限，则会给出提示，终止升级。
4. 示例
这里以 Tomcat 容器为例进行演示。将 %FR_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%\lib 目录下的 tools.jar 复制到 工程名\WEB_INF\lib 文件夹下，如下图所示：
4.3 部署成功
重启 Tomcat ，此时再次访问平台http://localhost:8080/webroot/decision，跳转到登录页面，即部署成功。如下图所示：
5. 注意事项
5.1 工程启动后报 tools.jar 不匹配
5.1.1 问题现象
服务器启动后，访问平台提示 tools.jar 异常，tools.jar 不匹配。
5.1.2 排查步骤
1）复制系统环境变量的 tools.jar
部署向导会给出解决方案，把环境使用的jdk\lib\tools.jar复制到WEB-INF\lib下，如下图所示：
2）排查环境使用的 JAVA_HOME 和复制的是不是一致的
因为 Linux 自带 openjdk ，没有配置 JAVA_HOME 的情况默认使用 openjdk ，而且通常这个 openjdk 不带 tools.jar 。
3）排查 JDK 的系统版本是否和系统环境匹配
64 位环境是可以安装 32 位 JDK 的，同时 Tomcat 可以正常启动，但是会一直报错 tools.jar 不匹配。
补充说明：
若依然提示 tools.jar 不匹配，通常就是系统版本和 JDK 版本不匹配。因为系统版本一致的情况下，即使 tools.jar 的版本和执行环境的 JDK 不一致，也是可以正常启动的。