1. 概述编辑
1.1 版本
FineBI服务器版本 | 功能变更 |
---|---|
6.0 | - |
1.2 应用场景
Tomcat 是免费且性能相对稳定的 Web 应用服务器,在许多中小型企业中深受欢迎。
1.3 功能简介
本文介绍在Windows系统中,如何将 FineBI 工程部署到 Tomcat 容器中。
1.4 注意事项
同一个 Tomcat 服务器中不能部署多个 BI 工程,JDK 版本为:JDK 1.8 且小版本需在 JDK8u102 以上。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
2. 部署步骤编辑
2.1 准备服务器
请根据工程「数据量」和「用户数」维度,准备合适的服务器环境:FineBI服务器配置推荐
不支持部署在 Windows32 位操作系统上。
2.2 安装JDK
独立部署时,用户需要单独准备 JDK 。
1)下载安装JDK
操作步骤 | 说明 |
---|---|
版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 由于 FineBI 不支持 32 位操作系统,请务必下载 64 位的JDK |
下载JDK | 下载链接:JDK |
安装JDK | 安装教程请参考 JDK 官方文档 用户安装 JDK 配置环境变量时,配置 path 时,变量值建议加上%JAVA_HOME%\jre\bin |
按住「Win+R」键,输入「cmd」,调用命令终端。
输入 java -version 和javac ,出现如下则表示 JDK 安装成功:
2.3 安装Tomcat
独立部署时,用户需要单独准备 Tomcat 。
1)下载安装Tomcat
操作步骤 | 说明 |
---|---|
版本要求 |
|
下载Tomcat | 下载链接:Tomcat ,请选择「64-bit Windows zip」
|
安装Tomcat | 安装教程请参考 Tomcat 官方文档
|
2)检查Tomcat是否安装成功
%Tomcat_HOME%\bin 目录下双击 startup.bat,启动 Tomcat 服务器,在浏览器输入命令http://localhost:8080,出现如下图所示的网页则表示安装成功:
注:平台自带的日志管理不能清理%TOMCAT_HOME%/logs文件夹下的日志文件,catalina.out 文件长久运行会占用很大磁盘空间,建议定时清理 catalina.out 文件。
2.4 拷贝FineBI工程
将 webroot 文件夹拷贝到%Tomcat_HOME%\webapps下,如下图所示:
注1:webroot 文件夹,可通过 FineBI 试用安装 后,在安装目录%FineBI%\webapps下获取。
注2:webroot 文件夹名称,即为 FineBI 工程名。
用户可以自定义修改。后面访问 BI 工程时,地址「http://ip:端口/工程名/decision」中的工程名也要随之更改。
2.5 拷贝tools.jar
将2.2节JDK安装目录%JAVA_HOME%\jdk\lib下的 tools.jar,拷贝到%Tomcat_HOME%\lib和%Tomcat_HOME%\webapps\工程名\WEB_INF\lib下。
注:如果不执行该操作,访问 BI 工程时,页面显示报错信息:HTTP Status 404。
2.6 配置内存参数
FineBI 对服务器有一定的配置要求,因此需要配置内存参数保证服务器稳定。详情请参见:修改 FineBI 配置参数
注:修改 FineBI 配置参数中的 headless 参数若不配置,超管 导出 Excel 时,将会报错:无导出权限。
2.7 配置JVM参数
1)应用场景:
为了对Tomcat服务器进行运维管理,建议配置自动生成 dump 日志的 JVM 参数。
配置该参数对工程运行没有性能损耗的影响,仅用于在服务器宕机时生成 dump 日志。
2)操作方法:
进入%Tomcat%\bin目录下,编辑配置文件catalina.bat,增加JVM 参数。修改后,重启 Tomcat 生效。
set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump
注:D:\heapdump 路径表示的是宕机文件生成路径,可自行修改调整。
如下图所示:
2.8 启动 Tomcat 服务器
双击%Tomcat_HOME%\bin目录下的startup.bat文件,即可启动 Tomcat 服务器,如下图所示:
2.9 访问FineBI工程
在浏览器中输入访问地址http://IP:端口/webroot/decision,示例为http://localhost:8080/webroot/decision,打开FineBI工程登录页面,即部署成功,如下图所示:
3. 注意事项编辑
3.1 0day漏洞预警
若客户遇到0day漏洞预警通知,请参见:0day漏洞说明
3.2 性能较差
问题描述
工程在 Windows 系统中部署成功后,出现卡顿问题,性能较差。
原因分析
Windwos Server 2016 及之后版本中,Windows 对控制台的功能做了一次更新,支持了更多类似于 cmd 窗口的功能。
这些新增的功能,导致在 Server2016 中部署的 Tomcat 以窗口模式启动的时候,对输出到控制台的日志造成了严重的性能问题,最终导致 BI 性能卡顿。
解决方案一:保留启动窗口
1)双击startup.bat后,在弹出的 Tomcat 窗口上,右键点击最上面白色栏,选择「属性」,勾选「使用旧版控制台」,点击「确定」。如下图所示:
2)重启 Tomcat 工程。
解决方案二:禁用启动窗口
1)进入%Tomcat_HOME%\bin目录下,找到setclasspath.bat文件,将set _RUNJAVA="%JRE_HOME%\bin\java.exe"修改为set _RUNJAVA="%JRE_HOME%\bin\javaw.exe"。如下图所示:
2)保存后重启 Tomcat 工程。
注1:使用 startup.bat 启动 Tomcat, 命令窗口会一闪而过,但服务已经启动了。想要访问工程,还需等待 Tomcat 启动的时间。
注2:这种方式下,想要停止 Tomcat ,只能到任务管理器中杀 java 进程。