历史版本27 :Wildfly(JBoss)9~18服务器部署 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

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目录中。

如下图所示:

b'n1.png

3. 部署步骤编辑

3.1 获取工程文件

1)点击跳转至服务器部署包下载地址:服务器部署包 

2)在「其他下载>服务器部署版」下,根据自身系统,选择下载对应版本的服务器部署包。如下图所示:

3)将下载后的部署包解压至某个目录下,%Tomcat_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。

3.2 上传jersey-server文件

1)下载:jersey-server-2.34.jar

2)拷贝进上一节 %FineBI%/webapps/webroot/WEB-INF/lib中。

3.3 上传jboss-deployment-structure.xml文件

Wildfly10 用户必做(其他版本用户请忽略该步骤)

1)下载:jboss-deployment-structure.xml

2)拷贝进上一节%FineBI%/webapps/webroot/WEB-INF中。

3.4 拷贝工程文件

1)拷贝上一节%BI_HOME%/webapps目录下的 webroot 文件夹

2)上传至 wildfly 目录 ../wildfly-9.0.0.Final/standalone/deployments 下,

3)将其重命名为 webroot.war,如下图所示:

2.png

4)在 deployments 目录下新建一个文件,命名为 webroot.war.dodeploy,如下图所示:

4.png

5)进入 wildfly 目录 ../wildfly-9.0.0.Final/modules/system/layers/base/sun/jdk/main/ 下,编辑 module.xml 文件。

<paths></paths> 父标签末尾加入 <path name="com/sun/management"/> 保存,如下图所示:

6.png

3.5 修改standalone.xml文件

Wildfly10 用户必做(其他版本用户请忽略该步骤):

修改...standalone/configuration/standalone.xml文件,jboss.bind.address:127.0.0.1 修改为jboss.bind.address:0.0.0.0,如下图所示:

1632810858906173.png

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

7.png

4. 注意事项编辑

4.1 访问工程报错 not found

问题描述

访问工程报错 not found,但日志里工程正常启动。

解决方案

访问工程 URL 后加 / ,例如:http://localhost:8080/webroot/decision/

4.2 全局更新数据不能存放在部署目录下

全局更新 设置中,数据存放路径不能为部署目录下。