1. 概述
1.1 版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0.5 | - |
| 6.0. |
1.2 功能简介
本文介绍在 Weblogic 中间件中部署 FineBI 工程的方法。
2. 环境搭建
用户需要提前在 Linux 系统下安装 JDK 和 weblogic，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
2.2 安装JDK和Weblogic
用户需要提前在服务器下安装 JDK 和 Weblogic，具体的安装方法可以自行查阅资料。
| 内容 | 版本要求 |
|---|---|
| JDK | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统必须安装 64 位的 JDK |
| Weblogic | 支持Weblogic12.2.1.3及以上版本 由于安全限制问题，在一个域下只能部署一个FineBI的工程，否则会报错 |
2.2 Weblogic优化
1）删除 Weblogic 安装目录 %Weblogic%/Middleware/Oracle_Home/oui/modules目录下「jackson-annotations-2.7.9.jar」，如下图所示：
2）删除 weblogic 安装目录%Weblogic%/Middleware/Oracle_Home/oracle_common/modules/thirdparty 目录下的「jackson-annotations-2.7.9.jar」、「jackson-core-2.7.9.jar」、「jackson-databind-2.7.9.1.jar」，如下图所示：
3）删除 Weblogic 安装目录 %Weblogic%/Middleware/Oracle_Home/wlserver/modules 下的「org.slf4j.jdk*.jar」，如下图所示：
注：没有该文件的则忽略此步骤。
4）由于 Weblogic 中 jackson 老版本包会引起报错，引起 FineBI 抽数失败问题。因此需要删除 Weblogic 安装目录 %Weblogic%/Middleware/Oracle_Home/oracle_common/modules（Linux为 %weblogic%/oracle_common）下的「com.fasterxml.jackson.core.jackson-databind」、「com.fasterxml.jackson.core.jackson-core」、「com.fasterxml.jackson.core.jackson-annotations」，如下图所示：
注：没有该文件的则忽略此步骤。
3. 部署步骤
Windows、Linux、Unix下的 Weblogic 管理控制台界面是一样的，即实现步骤是一样的。
本文示例环境为Linux+Weblogic12c+jdk1.8，其他版本步骤基本相同，但功能位置可能略有不同，请自行调整。
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 FineBI安装与启动，安装本地FineBI后，%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程文件
1）压缩上一节的 webroot 文件夹。
2）将压缩包上传至WebLogic服务器任意目录下并解压。
本文示例：/weblogic/Oracle/Middleware/Oracle_Home/user_projects/domains/appWLSDomain/autodeploy目录下
3）解压压缩包。
3.3 上传web.xml文件
1）下载web.xml文件： web.xml
2）将web.xml文件上传到/webroot/WEB-INF文件夹下。
本文示例：/weblogic/Oracle/Middleware/Oracle_Home/user_projects/domains/appWLSDomain/autodeploy/webroot/WEB-INF/
3.4 修改weblogic.xml
6.0.10 版本新增参数安全校验，改动了 cbb JAR 包，工程所用的weblogic容器中的JAR包会与改动冲突，因此需要配置过滤，优先使用应用内置的jar包。。
1）在/webroot/WEB-INF目录下查找weblogic.xml，如果不存在该文件，新建即可。
2）在weblogic.xml文件中配置过滤，优先使用应用内置的jar包。
点击下载并解压，获取示例文件：weblogic.zip
3.5 参数配置
FineBI工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在部署工程前，对参数进行配置，详情请参见：WebLogic服务器配置修改
3.6 部署工程
1）使用管理员账户登录WebLogic管理控制台。
2）在WebLogic控制台中，选择左侧「部署」菜单，点击「安装」按钮。
3）选择3.2节拷贝的webroot工程文件位置，选定 webroot，点击「下一步」。
4）选择安装类型为「将此部署安装为应用程序」，点击「下一步」。
5）直接点击「完成」按钮，进行部署。
注：在部署 WebLogic 过程中，无需更改编码方式，FineBI 在定义数据连接时已经对编码进行了处理。
6）看到「已激活所有更改，不需要重新启动信息」时，表示已经部署完毕。
3.7 启动工程
1）使用管理员账户登录WebLogic管理控制台。
2）在WebLogic控制台中，选择左侧「部署」菜单，查看工程状态和健康状况。
若工程状态为「活动」，健康状况为「正常」，代表工程已启动。
若工程未启动，状态为「准备就绪」，则代表工程未启动，需要手动启动。
点击「控制」，勾选「webroot」点击「启动>为所有请求提供服务器」，如下图所示：
3.8 访问FineBI系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineBI初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
默认端口号为 7001，工程名默认为webroot。
注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
