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 。
| 操作步骤 | 说明 |
|---|---|
| 版本要求 |
|
| 下载Tomcat | 下载链接：Tomcat ，请选择「tar.gz」，将下载的Tomcat 安装包上传到 Linux 服务器
|
| 安装Tomcat | 安装教程请参考 Tomcat 官方文档 示例语句：Tomcat安装包解压到/data目录 # tar -zxvf apache-tomcat-8.5.51.tar.gz -C /data 同一个 Tomcat 服务器中不能部署多个 FineBI 工程。 |
3. 部署步骤
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 FineBI安装与启动，安装本地FineBI后，%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程文件
1）压缩上一节的 webroot 文件夹。
2）将压缩包上传至服务器%Tomcat_HOME%\webapps目录下。
3）解压压缩包。
cd /usr/BI/apache-tomcat-9.0.44/webapps
unzip webroot.zip
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：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
