反馈已提交

网络繁忙

Linux下Tomcat独立部署FineReport工程

  • 文档创建者:文档助手1
  • 历史版本:54
  • 最近更新:Carly 于 2023-12-12
  • 1. 概述

    1.1 版本

    报表服务器版本
    功能变更
    11.0-

    1.2 应用场景

    Tomcat 是免费且性能相对稳定的 Web 应用服务器,在许多中小型企业中深受欢迎。

    1.3 功能简介

    本文介绍在 Linux 系统中,如何将 FineReport 工程部署到 Tomcat 容器中。

    注:相比于传统部署架构,容器化部署具有隔离性、可移植性、灵活性、可伸缩性和可控性等优点,可大幅降低企业的维护成本和资源成本。

           推荐使用更具优势的容器化部署方案:部署新项目-FineReport

    1.4 注意事项

    • 本文以 CentOS7+JDK1.8+Tomcat9.0.44 为例进行演示,其他版本命令可能略有区别,请自行处理。

    • 用户需要提前在 Linux 系统下安装 JDK 和 Tomcat,具体的安装方法可以自行查阅资料,技术支持不负责解答环境搭建部分的内容。

    • 同一个 Tomcat 服务器中不能部署多个 FineReport 工程

    • JDK 版本需为 1.8 且小版本需在 JDK8u102 以上。

    • 不支持 Tomcat 10.0 版本。

    2. 环境搭建

    用户需要提前在 Linux 系统下安装 JDK 和 Tomcat,具体的安装方法可以自行查阅资料,技术支持不负责解答环境搭建部分的内容

    2.1 准备服务器

    请根据工程「用户数」维度,准备合适的服务器环境:工程部署推荐环境及配置

    2.2 安装JDK

    独立部署时,用户需要单独准备 JDK 。

    操作步骤
    说明
    版本要求

    支持JDK 1.8 且小版本需在 JDK8u102 以上

    下载JDK

    1)确认服务器系统架构:uname -m

    2)下载正确版本安装包:JDK

    安装的 JDK 版本一定要与操作系统匹配,64 位操作系统可以安装 32 位的 JDK ,但是 FineReport 不支持这样的操作,必须保持统一

    3)将下载的 JDK 安装包上传到 Linux 服务器

    安装JDK
    安装教程请参考 JDK 官方文档
    示例语句:将安装包解压到/data目录

    # tar -zxvf jdk8.0.202-linux_x64.tar.gz -C /data

    验证安装成功

    查询语句:java -version

    返回结果:返回版本,即代表安装成功

    2.3 安装Tomcat

    独立部署时,用户需要单独准备 Tomcat 。

    1)下载安装Tomcat

    操作步骤
    说明
    版本要求
    • 支持tomcat8.0(不支持 Tomcat 8.0.32 版本)

    • 支持tomcat9.0

    • 不支持tomcat10.0

    下载Tomcat

    下载链接:Tomcat ,请选择「tar.gz」,将下载的Tomcat 安装包上传到 Linux 服务器

    • tar.gz 是 Linux 系统安装文件

    • 32-bit Windows zip 是 Window32 位安装包

    • 64-bit Windows zip 是 Window64 位安装包

    安装Tomcat安装教程请参考 Tomcat 官方文档

    示例语句:Tomcat安装包解压到/data目录

    # tar -zxvf apache-tomcat-8.5.51.tar.gz -C /data

    同一个 Tomcat 服务器中不能部署多个 FineReport 工程。

    3. 部署步骤

    3.1 获取工程文件

    1)付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式:服务平台>在线支持。

    2)免费用户请参考 设计器安装,安装设计器后,%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。

    3.2 拷贝工程文件

    1)压缩上一节 webroot 文件夹。

    2)将压缩包上传至服务器%Tomcat_HOME%\webapps目录下。

    3)解压压缩包。

    cd /data/tomcat/webapps

    unzip webroot.zip

    3.3 参数配置(选做)

    FineReport工程部署到应用服务器上时,对应用服务器有一定的配置要求。

    如果应用服务器不能满足工程使用时,会出现宕机风险。

    建议在启动 Tomcat 服务器前,对参数进行配置,详情请参见:运维监控指导手册 。

    注:重点是「Java 虚拟机检查」相关的配置项,其他内容建议在启动工程后逐一确认。

    3.4 修改端口号(选做)

    若 Linux 系统中有多个 Tomcat 同时运行,需要确认默认的 8080 端口号是否被占用;若 Linux 系统之前没有部署过工程,可忽略该节内容。

    1)使用语句查看默认的 8080 端口号是否被占用,下图为被占用情况。

    netstat  -anp  |grep 8080

    2)若被占用,需要修改 Tomcat 端口号。详情请参见 修改Tomcat端口号 

    3.5 启动Tomcat

    1)进入bin目录(根据目录自行修改)

    cd /data/tomcat/bin

    2)启动 Tomcat

    ./startup.sh

    3)查看实时日志,实时日志中出现重启耗时则意味着启动成功。

    cd /data/tomcat/logs

    tail -f catalina.out

    注:启动 Tomcat 后,如果报错「Database is not initialized」,请检查下用户读写权限,可使用命令chmod -R 777 tomcat配置权限。

    3.6 访问FineReport系统

    在浏览器中输入访问地址http://IP:端口号/工程名/decision,打开FineReport初始化配置页面,即部署成功。如下图所示:

    注1:访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。

          Tomcat 默认端口号为 8080,工程名默认为webroot。

    注2:平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过,则直接进入初始化配置界面。

    4. 注意事项

    部署常见问题请参见:Tomcat部署问题汇总

    附件列表


    主题: 部署集成
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持