1. 环境准备
FineBI 支持的 Weblogic 版本及对应的 JDK 版本如下所示:
Weblogic版本 | JDK版本 |
---|---|
Weblogic12.2.1.* | JDK 1.8 且小版本需在 JDK8u102 以上 |
注:部署前请先确认服务器环境的 JDK 版本,否则无法部署成功并使用。
支持的操作系统包括 Windows、Linux、Unix 操作系统,Linux、Unix 下的 Weblogic 管理控制台和 Windows下的界面是一致的,即实现步骤是一样的。
2. 部署步骤
以下示例环境为 Windows10+Weblogic12.2.1.3+JDK1.8 ,其他版本步骤基本相同,可能每个版本功能位置不同,需要找到自身版本环境的对应位置。
2.1 前期准备
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」三个 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」三个 JAR 包,如下图所示:
注:没有该文件的则忽略此步骤。
5)在此处下载 web.xml 文件,并将其放入 FineBI 安装目录%FineBI%/webapps/webroot/WEB-INF下,否则在部署的时候选择不到 webroot 应用工程。
6)在finedb数据库的表「FINE_CONF_ENTITY」中找到「DistributedOptimizationConfig.spiderConfig.spider_namenode_mode」字段,将该字段对应的值「zookeeper」修改为「master」并保存,如下图所示:
注:FineBI 2019-08 之后的版本不需要进行此步骤操作。
2.2 拷贝工程
1)拷贝 FineBI 安装目录%FineBI%/webapps下的 webroot 文件夹至服务器(Weblogic所在的服务器)任意目录,如服务器的D:/webroot;
2)将环境上安装的JDK目录 lib 下面的 tools.jar 拷贝到%Weblogic_home%/lib或%webroot%/WEB-INF/lib任一位置,比如拷贝至D:/webroot/WEB-INF/lib下。
2.3 Weblogic 部署 FineBI 应用
1)启动 Weblogic 服务器,打开 Weblogic 管理控制台,默认地址为http://localhost:7001/console,选择左边的部署菜单,点击右侧的安装按钮进行部署,如下图所示:
2)调整至 FineBI 部署位置,即D:/webroot,选择「webroot」,点击「下一步」,如下图所示:
3)选择默认的定位方式不变(将此部署安装为应用程序),点击「下一步」,如下图所示:
4)使用默认设置直接点击「完成」(也可根据需求点击下一步逐步进行设置),如下图所示:
注:在部署 weblogic 过程中,无需更改编码方式,FineBI 在定义数据连接时已经对编码进行了处理。
5)默认会自动激活所有更改,若没有激活,点击左侧的「激活更改」按钮进行提交,如下图所示:
看到「已激活所有更改。不需要重新启动」信息时,表示已经部署完毕,同时看到工程右侧的状态为「活动」,健康状况为「OK」,表示工程已启动成功。
6)若状态为准备就绪,则需要启动一下工程,选择「刚部署的应用>启动」,如下图所示:
2.4 检测是否部署成功
打开浏览器,输入访问地址http://localhost:7001/webroot/decision可成功看到访问界面,7001 端口可根据需要进行修改,如下图所示:
注:地址由「服务器IP+端口+工程文件名+decision」。
2.5 服务器宕机风险参数配置
FineBI 对服务器有一定的配置要求,当服务器不能满足 BI 使用时,会出现宕机风险,相关参数配置详情参见:修改 FineBI 配置参数