1. 概述
1.1 版本
报表服务器版本 | 新增功能 |
|---|---|
| 11.0 | - |
| 11.0.3 | 新增「部署环境异常」类报错，用来细化之前 tools.jar 类报错问题 |
| https 工程的 websocket 端口被占用时，进入部署向导页面 |
1.2 应用场景
在进行服务器部署时，会出现部署失败的情况，而导致失败的原因有很多种，此时就需要提供一个页面或者工具来引导用户检测并修复问题。
1.3 功能简介
在服务器部署失败时，引导用户及时检测并修复问题，从而成功部署。
2. 前期准备
配置容器环境如下表所示：
| 容器 | 说明 |
|---|---|
| Tomcat | 详情请参见： |
| JBoss | JBoss6.4 服务器部署 |
| WebLogic | WebLogic 服务器文件夹部署、WebLogic 服务器 war 包部署 |
| WebSphere | WebSphere8.5 服务器部署 |
| Resin | Resin 服务器的部署 |
3. 部署报错页面
3.1 部署环境异常
报错页面如下图所示：
详情请参见：部署环境异常
3.2 数据库连接异常
3.2.1 内置数据库连接失败
内置数据库连接失败时，报错内容如下图所示：
3.2.2 外接数据库连接失败
外接数据库连接失败时，报错内容如下图所示：
修改外接数据库相关配置后，点击「重新检测」，连接成功则直接启用新的数据库；若连接的数据库无表信息，则提示目标数据库为新数据库，无法使用
3.3 websocket 端口异常
websocket 端口冲突时，报错页面如下图所示：
注：11.0.3 版本，https 工程的 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，跳转到登录页面，即部署成功。如下图所示：
