1. 概述
1.1 版本
FineBI服务器版本 | 功能变更 |
---|---|
6.0 | - |
1.2 应用场景
JBoss AS是 JBoss 的开源版本,JBoss EAP 是 JBoss 的企业版本。为了更好地区分两者,从 JBoss AS8 开始 JBoss AS 更名为 WildFly 。
本文以 Windows + WildFly-10.1.0 + jdk1.8 为例进行演示,其他版本命令可能略有区别,请自行处理。
2. 环境搭建
用户需要提前安装 JDK 和 WildFly,具体的安装方法可以自行查阅资料,技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度,准备合适的服务器环境:单机工程部署支持环境及配置
2.2 安装JDK
独立部署时,用户需要单独准备 JDK 。
操作步骤 | 说明 |
---|---|
版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配,64 位操作系统必须安装 64 位的 JDK。 |
下载JDK | 下载链接:JDK 将下载的 JDK 安装包上传到服务器 |
安装JDK | 安装教程请参考 JDK 官方文档 示例:将安装包解压到/data目录即可 |
2.3 下载WildFly
操作步骤 | 说明 |
---|---|
版本要求 | Wildfly9~18 Wildfly8 的部署略有不同,请参考:Wildfly(Jboss)8服务器部署 |
下载WildFly | 下载链接:wildfly |
安装WildFly | 将下载的压缩包解压到某个文件夹下 |
2.4 配置环境变量
1)新建系统变量JBOSS_HOME,变量值为 WildFly 解压缩路径。如下图所示:
2)编辑变量 Path,新增值%JBOSS_HOME%\bin。如下图所示:
3)启动服务,验证是否配置成功。进入 bin 目录下,双击运行standalone.bat文件,看到如下日志,代表启动成功。如下图所示:
4)浏览器访问http://localhost:8080(WildFly 的 http 协议默认端口是 8080),出现下图所示画面代表服务器配置成功。
5)关闭已打开的 cmd 窗口。
2.5 上传core文件
1)下载并解压:core.zip
2)将解压出来的文件上传覆盖Wildfly../wildfly-9.0.0.Final/modules/system/layers/base/com/fasterxml/jackson/core目录中。
如下图所示:
3. 部署步骤
3.1 获取工程文件
1)付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式:服务平台>在线支持。
2)免费用户请参考 FineBI安装与启动,安装本地FineBI后,%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 上传jersey-server文件
2)拷贝进上一节 /webroot/WEB-INF/lib中。
3.3 上传jboss-deployment-structure.xml文件
Wildfly10 用户必做(其他版本用户请忽略该步骤)
1)下载:jboss-deployment-structure.xml
2)拷贝进上一节/webroot/WEB-INF中。
3.4 拷贝工程文件
1)拷贝上一节的 webroot 文件夹
2)上传至 wildfly 目录 ../wildfly-9.0.0.Final/standalone/deployments 下,
3)将其重命名为 webroot.war,如下图所示:
4)在 deployments 目录下新建一个文件,命名为 webroot.war.dodeploy,如下图所示:
5)进入 wildfly 目录 ../wildfly-9.0.0.Final/modules/system/layers/base/sun/jdk/main/ 下,编辑 module.xml 文件。
在 <paths></paths> 父标签末尾加入 <path name="com/sun/management"/> 保存,如下图所示:
3.5 修改standalone.xml文件
Wildfly10 用户必做(其他版本用户请忽略该步骤):
修改...standalone/configuration/standalone.xml文件,jboss.bind.address:127.0.0.1 修改为jboss.bind.address:0.0.0.0,如下图所示:
3.6 参数配置
FineBI工程部署到应用服务器上时,对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时,会出现宕机风险。
建议在部署工程前,对参数进行配置,详情请参见:WildFly服务器配置修改
3.7 启动wildfly并部署工程
进入 wildfly 目录 ../wildfly-9.0.0.Final/bin,执行 ./standalone.sh命令启动 wildfly 会自动进行部署。
注:若之前部署失败,请先删除 ../wildfly-*.0.0.Final/standalone/ 目录下的 /data、/tmp 文件,再重新部署。
3.8 访问FineBI系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision,打开FineBI初始化配置页面,即部署成功。如下图所示:
注1:访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
默认端口号为 8080,工程名默认为webroot。
注2:平台登录的用户名和密码是3.1节工程的。若该工程从未登录过,则直接进入初始化配置界面。
4. 注意事项
4.1 访问工程报错 not found
问题描述
访问工程报错 not found,但日志里工程正常启动。
解决方案
访问工程 URL 后加 / ,例如:http://localhost:8080/webroot/decision/
4.2 全局更新数据不能存放在部署目录下
全局更新 设置中,数据存放路径不能为部署目录下。