1. 版本编辑
系统版本 | 服务器版本 | JDK 版本 | JAR 包版本 | BI工程版本 |
---|---|---|---|---|
Windows10 | Tomcat-8.5.27 | JDK1.8 | 2019-11-29 | 5.1 |
注1:以上版本信息只是示例的环境配置,用户可根据自己的实际应用场景选择不同的版本。
注2:Tomcat 版本与 JDK 版本需要与操作系统对应,不支持32位的操作系统。
注3:暂不支持 Tomcat 8.0.32 版本。
注4:FineBI5.0 以上仅支持 JDK1.8 版本,且同一个 Tomcat 服务器中不能部署多个 BI 工程。
2. 操作步骤编辑
2.1 拷贝 BI 工程
将%FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下。
注:BI 工程名 webroot 可以自定义修改,但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。
2.2 拷贝 tools.jar
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置下
注:如果不执行该操作,访问 BI 工程时,页面显示报错信息:HTTP Status 404。
2.3 启动 Tomacat 服务器
进入%Tomcat_HOME%/bin目录下双击 startup.bat,即可启动 Tomcat 服务器( Linux 系统下执行 ./startup.sh )。
2.4 访问 BI 工程
在浏览器中输入访问地址http://localhost:8080/webroot/decision,打开 BI 工程登录页面,即部署成功。
2.5 配置 JVM 参数
此处我们还需要为工程配置上宕机自动生成 dump 日志的 JVM 参数,配置该参数对工程运行没有性能损耗的影响,仅用于在服务器宕机时生成 dump 日志。
进入%Tomcat%/bin目录下,编辑配置文件 catalina.bat ( Linux 系统下为 catalina.sh ),增加如下 JVM 参数:
JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError" JAVA_OPTS="$JAVA_OPTS -XX:HeapDumpPath=/opt/"
注:其中/opt/路径表示的是宕机文件生成路径,可以根据需要修改文件路径。修改保存后,需要重启 Tomcat 才能使配置生效。
3. 注意事项编辑
1)Linux 环境下使用 Tomcat 下部署了 FineBI 工程后,若要导出 Excel ( 包含组件导出Excel和仪表板导出Excel ),则需要进入%Tomcat%/bin目录下,编辑配置文件 catalina.sh,搜索 RUNJAVA,在所有类似如下图所示的内容后面,都增加一行代码:
Djava.awt.headless=true \
修改文件后保存,并重启 FineBI 工程,即可导出 Excel。
2)Windows 系统下的 CMD 窗口默认可编辑,如果鼠标点进窗口,会造成所有的 Java 线程阻塞,造成 Tomcat 假死宕机不能使用。此时需要在 Tomcat 的 CMD 界面点击属性。
取消勾选两个编辑选项,点击确定保存该属性,并重启 Tomcat 即可。
3)关于页面显示 HTTP Status 404
将安装的 JDK 目录lib下面的tools.jar拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置。