1.1 版本

1.2 应用场景

在进行服务器部署时，会出现部署失败的情况，而导致失败的原因有很多种，此时就需要提供一个页面或者工具来引导用户检测并修复问题。

1.3 功能简介

在服务器部署失败时，引导用户及时检测并修复问题，从而成功部署。

配置容器环境：

• Tomcat7 及以上，（Tomcat7编码修改为UTF-8，Tomcat8 不需要修改），详细请参见 Tomcat服务器部署

• JBoss 6.0.0 及以上，详细请参见 Jboss服务器

• WebLogic 12c 及以上，详细请参见 Weblogic服务器

• WebSphere 8.5.5.9 及以上，详细请参见 WebSphere服务器
  

• Jetty 8.0 及以上

• Glassfish 3.0 及以上

• Resin 4.0.4 及以上

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 端口冲突时，报错页面如下图所示：

这里以 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.1 工程启动后报 tools.jar 不匹配

5.1.1 问题现象

服务器启动后，访问平台提示 tools.jar 异常，tools.jar 不匹配。

5.1.2 排查步骤

1）复制系统环境变量的 tools.jar

部署向导会给出解决方案，把环境使用的jdk/lib/tools.jar复制到webroot/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 不一致，也是可以正常启动的。