历史版本10 :Linux下Tomcat独立部署FineBI工程 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

FineBI服务器版本
功能变更
6.0-

1.2 应用场景

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

1.3 功能简介

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

1.4 注意事项

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

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

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

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

  • 不支持 Tomcat 10.0 版本。

2. 环境搭建编辑

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

2.1 准备服务器

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

2.2 安装JDK

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

操作步骤
说明
版本要求

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

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

下载JDK

下载链接：JDK

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

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

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

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 服务器中不能部署多个 FineBI 工程。

3. 部署步骤编辑

3.1 安装本地工程

参考该文档先行安装本地FineBI，以获取webroot工程：FineBI安装与启动

3.1 拷贝工程文件

1）进入本地%BI_HOME%/webapps目录，压缩 webroot 文件夹。

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

3）解压压缩包。

cd /usr/BI/apache-tomcat-9.0.44/webapps

unzip webroot.zip

3.2 拷贝tools.jar文件

1）进入服务器%JAVA_HOME%\jdk\lib目录，找到tools.jar文件

2）拷贝tools.jar文件到%Tomcat_HOME%\lib下或者%Tomcat_HOME%\webapps\工程名\WEB_INF\lib下。

cp /usr/java/jdk1.8.0_241-amd64/lib/tools.jar /usr/BI/apache-tomcat-9.0.44/lib

3.3 参数配置（选做）

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

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

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

注：重点是「Java 虚拟机检查」相关的配置项以及「设置 dump JVM 参数」，其他内容建议在启动工程后逐一确认。

3.4 修改端口号（选做）

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

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

netstat  -anp  |grep 8080

2）若被占用，需要修改 Tomcat 端口号。详情请参见 修改FineBI工程端口号 

3.5 启动 Tomcat

1）进入bin目录（根据目录自行修改）

cd /home/BItest/tomcat/bin

2）启动 Tomcat

./startup.sh

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

cd /home/BItest/tomcat/logs

tail -f catalina.out

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

3.6 访问FineBI系统

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

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

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

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