1. 概述编辑
Tomcat 是免费且性能相对稳定的 Web 应用服务器,在许多中小型企业中深受欢迎,本文将介绍如何将 FineBI 5.0 &5.1 部署到 Tomcat 服务器端。
1.1 版本
用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行查阅资料。
Tomcat 版本与 JDK 版本需要与操作系统对应,Tomcat 版本、 JDK 版本与 BI 版本对应关系如下:
Tomcat 版本 | JDK 版本 |
---|---|
8.0 (不支持 Tomcat 8.0.32 版本) | JDK1.8 |
9.0 | JDK1.8 |
1.2 注意事项
FineBI5.0 以上仅支持 JDK1.8 版本,且同一个 Tomcat 服务器中不能部署多个 BI 工程。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
2. 操作步骤编辑
示例在 Windows 系统下部署步骤。
2.1 准备工作
2.1.1 确认 JDK 安装成功
调用终端命令,输入 java -version 和javac ,出现如下则表示 JDK 安装成功:
2.1.2 Tomcat 服务器已经安装成功
%Tomcat_HOME%\bin 目录下双击 startup.bat,启动 Tomcat 服务器( Linux 系统下执行./startup.sh ),在浏览器输入命令http://localhost:8080,出现如下图所示的网页则表示安装成功:
2.2 拷贝 BI 工程
将%FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下,如下图所示:
注:BI 工程名 webroot 可以自定义修改,但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。
2.3 拷贝 tools.jar
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置下
注:如果不执行该操作,访问 BI 工程时,页面显示报错信息:HTTP Status 404。
2.4 配置参数
2.4.1 配置 BI 使用内存参数
FineBI 对服务器有一定的配置要求,因此需要配置内存参数保证服务器稳定,详情参见:修改 FineBI 配置参数
注:修改 FineBI 配置参数 5.1 节的 headless 参数若不配置,超管 导出 Excel 时,将会报错:无导出权限。
2.4.2 配置 dump JVM 参数
1)此处需要为工程配置上宕机自动生成 dump 日志的 JVM 参数,配置该参数对工程运行没有性能损耗的影响,仅用于在服务器宕机时生成 dump 日志。
进入%Tomcat%/bin目录下,编辑配置文件 catalina.bat ( Linux 系统下为 catalina.sh ),增加如下 JVM 参数:
set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump
注:其中D:\heapdump 路径表示的是宕机文件生成路径,可以根据需要修改文件路径。修改保存后,需要重启 Tomcat 才能使配置生效。
如下图所示:
2.5 启动 Tomacat 服务器
进入%Tomcat_HOME%/bin目录下双击 startup.bat,即可启动 Tomcat 服务器( Linux 系统下执行./startup.sh),如下图所示:
2.6 访问 BI 工程
在浏览器中输入访问地址http://IP:端口/webroot/decision,示例为http://localhost:8080/webroot/decision,打开 BI 工程登录页面,即部署成功,如下图所示:
3. 索引编辑
序号 | 简介 | 参考文档 |
---|---|---|
1 | Tomcat 的默认端口为 8080,如果该端口被占用,Tomcat 将无法启动。这时就需要重新配置端口 如果服务器上有多个 Tomcat,需要给每个 Tomcat 配置一个端口号 | Tomcat 端口配置 |
2 | 有的用户为了服务器上文件的有效管理,需要将报表目录放在特定的位置,而不将报表文件夹拷贝到 Tomcat 服务器安装目录%Tomcat_HOME%\webapps下,可参考本文步骤进行设置 | Tomcat 设置报表工程访问路径 |
3 | 报错 500 | 服务器部署引入 tools.jar |
4 | 介绍工程部署到 Tomcat 中遇到的问题及解决方案 | Tomcat部署相关问题 |