服务器部署向导

  • 文档创建者:宋会青
  • 编辑次数:9次
  • 最近更新:Wendy123456 于 2021-03-17
  • 1. 概述

    1.1 版本

    报表服务器版本

    JAR 包

    新增功能
    10.02019-05-20-
    10.0.14
    2021-03-17服务器部署向导页面中,外接数据库配置信息界面中支持设置数据连接 URL

    1.2 应用场景

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

    1.3 功能简介

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

    2. 前期准备

    配置容器环境:

    3. 服务器部署向导检测内容

    3.1 tools.jar

    3.1.1 tools.jar 不匹配

    tools.jar 不匹配时,报错内容如下图所示:

    18.png

    3.1.2 工程缺少 tools.jar

    工程缺少 tools.jar 时,报错内容如下图所示:

    1614578206457932.png

    3.2 数据库

    3.2.1 内置数据库连接失败

    内置数据库连接失败时,报错内容如下图所示:

    20.png

    3.2.2 外接数据库连接失败

    外接数据库连接失败时,报错内容如下图所示:

    21.png

    修改外接数据库相关配置后,点击「重新检测」,连接成功则直接启用新的数据库;若连接的数据库无表信息,则提示目标数据库为新数据库,无法使用

    3.3 websocket 端口异常

    websocket 端口冲突时,报错页面如下图所示:

    22.png

    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,如下图所示:

    3.png

    4.2 根据提示操作

    %JAVA_HOME%/lib 目录下的 tools.jar 复制到 工程名/WEB_INF/lib 文件夹下,如下图所示:

    图片.png

    4.3 部署成功

    重启 Tomcat ,此时再次访问平台http://localhost:8080/webroot/decision,跳转到登录页面,即部署成功。如下图所示:

    图片.png

    5. 注意事项

    5.1 工程启动后报 tools.jar 不匹配

    5.1.1 问题现象

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

    5.1.2 排查步骤

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

    部署向导会给出解决方案,把环境使用的jdk/lib/tools.jar复制到webroot/lib下,如下图所示:

    34.png

    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 不一致,也是可以正常启动的。

    附件列表


    主题: 部署集成
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526