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节拷贝的工程的。若该工程从未登录过,则直接进入初始化配置界面。