1. 概述
1.1 版本
| WebSphere 版本 | JDK 版本 |
|---|---|
| WebSphere8.5.5.13 版本 | JDK 1.8 且小版本需在 JDK8u102 以上 |
注：部署前请先确认服务器环境的 JDK 版本。
1.2 功能简介
FineBI 支持将工程部署在 WebSphere 中使用。本文以 Linux 系统为例部署 WebSphere8.5 服务器。
2. 环境搭建
用户需要提前安装 JDK 和 WildFly，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
注：目前 Windows+Websphere8.5 及以上版本不支持部署 FineBI 工程。
2.2 安装JDK和WebSphere
用户需要提前在服务器下安装 JDK 和 WebSphere，具体的安装方法可以自行查阅资料。
| 内容 | 说明 |
|---|---|
| WebSphere | 支持 WebSphere8.5.5.13及以上版本 WebSphere 升级：若已有WebSphere版本过低，必须先升级到8.5.5.13及以上版本，才能配置JDK1.8，否则无法成功使用 FineBI 内置 Spider 引擎。 |
| JDK | 下载链接：JDK 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统必须安装 64 位的 JDK。 |
| SDK | 在已经确保 Websphere 版本为8.5.5.13及以上，并且已经配置使用了 JDK1.8，此时需要升级 SDK 版本到 8.0.5.17 |
2.3 其他操作
6.0.10版本新增参数安全校验，因此改动了 cbb JAR 包，部分工程升级后，工程所用的WebSphere容器中的JAR包与改动冲突。
如存在JAR包冲突，会导致工程启动失败或部分功能不可用，工程日志中有相关报错关键词「validation」/「validator」
1）下载javax.j2ee.validation.jar：javax.j2ee.validation.jar
2）上传并覆盖%WebSphereHome%/AppServer/plugins目录下的javax.j2ee.validation.jar。
3. 部署步骤
本文示例环境为CentOS8.0+WebSphere8.5+JDK1.8，其他版本步骤基本相同，但功能位置可能略有不同，请自行调整。
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 FineBI安装与启动，安装本地FineBI后，%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3）将两个 JAR 包上传至/webroot/WEB-INF/lib目录下。
hibernate-validator-4.3.2.Final.jar
4）处理好的webroot 文件夹即为所需的工程文件。
3.2 创建工程目录
此处采用ear包的方式部署 BI 。
1）在was工程节点目录下创建 webroot.ear 目录，参考如下命令（根据自己的 was 工程节点目录修改）
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/
mkdir webroot.ear2）将上节 %FineBI%/webapps/webroot文件夹拷贝至目录 webroot.ear 下，参考如下命令：
cp -r /opt/FineBI/webapps/webroot
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear3）进入 webroot.ear 目录，将 webroot 文件夹重命名为 webroot.war，参考如下命令：
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear
mv webroot webroot.war3.3 参数配置
FineBI工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在部署工程前，对参数进行配置，详情请参见：WebSphere服务器配置修改
3.4 部署FineBI
1）使用管理员账户登录WebSphere管理控制台。
2）在WebSphere控制台中，选择左侧「应用程序>新建应用程序」菜单，点击「新建企业应用程序」按钮。
3）选择「远程文件系统」，手动输入3.2节的webroot.war文件的路径,如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear ，点击「下一步」。
4）选择「详细-显示所有的安装选项和参数」，点击「下一步」，点击「继续」，进入安装企业应用程序和模块的选项。
5）在安装企业应用程序和模块的选项中
步骤1：选择安装选项：使用默认设置，直接进入「下一步」。
步骤2：将模块映射至服务器：勾选「复选框」，进入「下一步」。
步骤3：为Web模块提供JSP重新装入选项：使用默认设置，直接进入「下一步」。
步骤 4: 映射共享库：勾选全部「复选框」，进入「下一步」。
步骤5：映射共享库关系：勾选全部「复选框」，进入「下一步」。
步骤 6: 为 Web 模块映射虚拟主机：勾选「复选框」，进入「下一步」。
步骤 7: 为 Web 模块映射上下文根：将上下文根改为工程名，进入「下一步」。
步骤 8: 映射 JASPI 提供程序：勾选全部「复选框」，进入「下一步」。
步骤 9: 模块的元数据：使用默认设置，直接进入「下一步」。
步骤 10: 显示模块构建标识：使用默认设置，直接进入「下一步」。
步骤 11: 摘要：：使用默认设置，点击「完成」。
6）进入自动安装界面，等待部署完成之后，点击「保存」。
7）保存结束之后，WebSphere中的帆软应用就部署好了。
3.5 启动工程
1）使用管理员账户登录WebSphere管理控制台。
2）在WebSphere控制台中，选择左侧「应用程序>应用程序类型>WebSphere企业应用程序」菜单。
3）查看应用程序状态。绿色为已启动，红色为未启动。
4）若程序未启动，可勾选工程，点击「启动」，等待应用程序状态变更为绿色即可。
3.6 访问FineBI系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineBI初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
可在「服务器>服务器类型>WebSphere Application Server>通信>端口>WC_defaulthost」查看端口号
注2：平台登录的用户名和密码是3.1节工程的。若该工程从未登录过，则直接进入初始化配置界面。
