1. 概述
1.1 版本
WebSphere 版本 | JDK 版本 |
---|---|
WebSphere8.5.5.13 版本 | JDK 1.8 且小版本需在 JDK8u102 以上 |
注1:FineBI 的 5.1.18.5 和 5.1.21 两个版本不支持 was 部署,可能存在服务器数据集相关功能不可用的问题。
注2:部署前请先确认服务器环境的 JDK 版本。
1.2 应用场景
有时用户需要将工程部署在 WebSphere 中使用。
1.3 功能介绍
FineBI 支持将工程部署在 WebSphere 中使用。本文以 Linux 系统为例部署 WebSphere8.5.5.13 服务器。
注:目前 Windows+WebSphere8.5 及以上版本不支持部署 FineBI5.1 工程。
2. 示例
示例环境为 CentOS + WebSphere 8.5.5.13 + JDK1.8 ,其他版本步骤基本相同,可能每个版本功能位置不同,需要找到自身版本环境的对应位置。
2.1 操作步骤
2.1.1 部署准备
1)升级 WebSphere
因为 FineBI 内置 Spider 引擎不支持 JDK 1.6 ,因此需要将 WebSphere 升级到 8.5.5.13 或更新的版本,才可以配置 JDK 1.8。任何低于 8.5.5.13 的版本都需要先升级到 8.5.5.13 ,升级后再配置使用 JDK1.8。
详情请参见:WebSphere 升级 。
2)升级SDK
在已经确保 Websphere 版本为 8.5.5.13 或更新版本,并且已经配置使用了 JDK1.8 。此时需要升级 SDK 版本到 8.0.5.17,这里采用直接替换的方法升级
详情请参见:WebSphere 升级最新的 SDK 。
2.2.2 创建工程目录
1)此处采用ear包的方式部署 BI 。
首先在was工程节点目录下创建 webroot.ear 目录,参考如下命令(根据自己的 was 工程节点目录修改)
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/
mkdir webroot.ear
2)将 %FineBI%/webapps/webroot文件夹拷贝至目录 webroot.ear 下,参考如下命令:
cp -r /opt/FineBI/webapps/webroot
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear
3)进入 webroot.ear 目录,将 webroot 文件夹重命名为 webroot.war,参考如下命令:
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear
mv webroot webroot.war
2.2.3 放置 tools.jar
将 was 使用的 jdk 文件夹下的 tools.jar 文件拷贝至 webroot.ear/webroot.war/WEB-INF/lib 目录下
cp /opt/IBM/WebSphere/AppServer/java_1.8_64/lib/tools.jar
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear/webroot.war/WEB-INF/lib
2.2.4 修改内存
1)启动 was 工程,登录管理控制台。WebSphere 的部署是在管理控制台进行部署,跟 Tomcat 等差别很大。进入管理控制台登录界面,输入用户名密码,如下图所示:
2)打开左侧目录树的服务器,点击WebSphere Application Server ,选择server1,如下图所示:
3)选择Java和进程管理中的进程定义 ,如下图所示:
4)选择其他属性中的Java 虚拟机,如下图所示:
5)设置初始堆大小和最大堆大小都为 4096,如下图所示:
6)点击完成后,点击保存到主配置,使配置生效,如下图所示:
2.2.5 部署 BI
1)新建应用程序
打开左侧目录树的应用程序,点击新建应用程序,选择右侧显示框中的新建企业应用程序,如下图所示:
2)选择远程文件系统,手动输入 webroot.ear 文件夹的路径,如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear 然后点击下一步,如下图所示:
3)选择详细-显示所有的安装选项和参数,点击下一步,如下图所示:
4)企业应用程序和模块的选项,点击下一步,如下图所示:
5)进入步骤 2:将模块映射至服务器,勾选复选框,如下图所示:
6)点击下一步,进入步骤 3,按照默认设置,如下图所示:
7)继续点击下一步至步骤 4 , 映射共享库,勾选步骤 4 下的所有复选框,如下图所示:
8)下一步进入步骤 5,映射共享库关系,勾选下面的复选框,如下图所示:
9)下一步进入步骤 6,为 Web 模块映射虚拟主机,勾选复选框,如下图所示:
10)下一步进入步骤 7,为 Web 模块映射上下文根,将上下文根改为工程名,如下图所示:
11)下一步进入步骤 8, 映射 JASPI 提供程序,勾选复选框,如下图所示:
12)下一步勾选metadata-complete属性框,如下图所示:
13)点击下一步,如下图所示:
14)点击完成,如下图所示:
15)开始进入安装页面,如下图所示:
16)等待安装完成后,点击保存到主配置,如下图所示:
17)至此 WebSphere 就部署好了,自动跳转至路径选择页面,如下图所示:
2.2.6 检测是否部署成功
1)选择左侧目录树中的应用程序>应用程序类型>WebSphere 企业应用程序,勾选部署的工程名,点击启动,如下图所示:
2)启动成功后如下图所示:
2.2 效果查看
1)输入访问地址http://虚拟机ip:9080/webroot/decision可成功看到访问界面,9080 端口可根据需要进行修改。如下图所示:
注:访问地址由「服务器 IP+端口+工程文件名+decision」组成。
2.3 服务器宕机风险参数设置
FineBI 对服务器有一定的配置要求,当服务器不能满足 BI 使用时,会出现宕机风险,相关参数配置详情参见:修改 FineBI 配置参数