1. 版本编辑
系统版本 | 服务器版本 | JDK 版本 | JAR 包版本 | BI 工程版本 |
---|---|---|---|---|
Windows10 | Tomcat-8.5.27 | JDK1.8 | 2019-11-29 | 5.1 |
注:以上版本信息只是示例的环境配置,用户可根据自己的实际应用场景选择不同的版本。
2. 操作步骤编辑
2.1 环境配置
用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行百度。
Tomcat 版本与 JDK 版本需要与操作系统对应,不支持 32 位的操作系统。Tomcat 版本、 JDK 版本与 BI 版本对应关系如下:
Tomcat 版本 | JDK版本 | BI 工程版本 |
---|---|---|
8.0及以上(不支持 Tomcat 8.0.32 版本) | JDK1.8 | 5.0 以上 |
注:FineBI5.0 以上仅支持 JDK1.8 版本,且同一个 Tomcat 服务器中不能部署多个 BI 工程。
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 启动 Tomacat 服务器
进入%Tomcat_HOME%/bin目录下双击 startup.bat,即可启动 Tomcat 服务器( Linux 系统下执行 ./startup.sh )。
2.5 访问 BI 工程
在浏览器中输入访问地址http://localhost:8080/webroot/decision,打开 BI 工程登录页面,即部署成功。
2.6 配置 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. 注意事项编辑
3.1 服务器宕机风险参数配置
FineBI 对服务器有一定的配置要求,当服务器不能满足 BI 使用时,会出现宕机风险,相关参数配置详情参见:FineBI宕机风险参数说明。
3.2 导出 Excel 设置
Linux 环境下使用 Tomcat 下部署了 FineBI 工程后,若要导出 Excel ( 包含 组件导出Excel 和 仪表板导出Excel ),则需要进入%Tomcat%/bin目录下,编辑配置文件 catalina.sh,搜索 RUNJAVA,在所有类似如下图所示的内容后面,都增加一行代码:
Djava.awt.headless=true \
修改文件后保存,并重启 FineBI 工程,即可导出 Excel。
3.3 Windows 系统下 CMD 窗口
1)Windows 系统下的 CMD 窗口默认可编辑,如果鼠标点进窗口,会造成所有的 Java 线程阻塞,造成 Tomcat 假死宕机不能使用。此时需要在 Tomcat 的 CMD 界面点击属性。如下图所示:
2)取消勾选两个编辑选项,点击确定保存该属性,并重启 Tomcat 即可。如下图所示:
3.4 关于页面显示 HTTP Status 404
将安装的 JDK 目录lib下面的tools.jar拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置。
3.5 Tomcat 高版本对 URL 特殊字符限制
1)Tomcat 9.0 做了更严格的限制,严格按照 RFC 3986 规范进行访问解析,而 RFC 3986 规范定义了 URL 中只允许包含英文字母(a-zA-Z)、数字(0-9)、-_.~4个特殊字符以及所有保留字符(RFC3986中指定了以下字符为保留字符:! * ’ ( ) ; : @ & = + $ , / ? # [ ])。
2)解决方法:
需要在 server.xml 文件中增加如下代码:
<Connector port="8084" protocol="HTTP/1.1" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>" useBodyEncodingForURI="true" connectionTimeout="20000" redirectPort="8443"URIEncoding="UTF-8"/>
3.6 内存不足
问题报错:配置管理员密码出错或Java heap space。
原因分析:表示 Tomcat 的内存不足,需修改Tomcat 内存配置。
解决方案:修改内存的方法参见文档:Java heap space。
3.7 7.0.100 版本的 Tomcat 部署
7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下,否则会报错。
文件请参见:web.xml
注:该 Tomcat 的 bug 已经在 7.0.103 中修复。