安装指南

Red Hat JBoss Enterprise Application Platform 7.4

Red Hat JBoss Enterprise Application Platform 7.4

Red Hat Customer Content Services

摘要

本安装指南包含 Red Hat JBoss Enterprise Application Platform (JBoss EAP) 支持的安装方法。本指南还包含有关将 JBoss EAP 配置为服务或通过守护进程分离的进程的说明,以及卸载 JBoss EAP 的说明。

提供有关 JBoss EAP 文档的反馈

要报告错误或改进文档,请登录到 Red Hat JIRA 帐户并提交问题。如果您没有 Red Hat Jira 帐户,则会提示您创建一个帐户。

流程

  1. 单击以下链接 以创建 ticket
  2. 请包含 文档 URL章节编号 并描述问题
  3. Summary 中输入问题的简短描述。
  4. Description 中提供问题或功能增强的详细描述。包括一个指向文档中问题的 URL。
  5. Submit 创建问题,并将问题路由到适当的文档团队。

使开源包含更多

红帽承诺替换我们的代码、文档和网页属性中存在问题的语言。我们从这四个术语开始: master、slave、blacklist 和 whitelist。这些更改将在即将发行的几个发行本中逐渐实施。详情请查看 CTO Chris Wright 信息

第 1 章 准备安装 JBoss EAP

您可以选择使用三种安装程序中的任一种来安装 JBoss EAP 实例。根据您的要求,每个安装程序类型在某些情况下都很有用。

1.1. JBoss EAP 安装方法

您可以选择多种方式之一来安装 JBoss EAP。每种方法都会最适合于某些情况。

下表简要概述了每种安装类型,以及涵盖相关进程的部分的链接。

表 1.1. 安装程序类型

方法描述

安装程序安装

  • 您可以在控制台或图形向导中运行安装程序。这两个选项都提供安装和配置服务器实例的逐步说明。安装程序安装是在所有受支持的平台上安装 JBoss EAP 的首选方法。
  • 安装程序还提供额外的设置选项,包括 Quickstarts 和 Maven 存储库的配置。

归档安装

  • 归档安装适合在所有支持的操作系统上安装。
  • 如果要手动提取实例,可使用此方法。
  • 归档安装提供 JBoss EAP 的默认安装,并且您必须在安装后实施任何配置更改。
注意

如果您计划使用 JBoss 运营网络(JBoss ON)来部署和安装 JBoss EAP 补丁,请使用存档安装方法安装目标 JBoss EAP 实例。

RPM 安装

  • 您可以使用 RPM 软件包在受支持的 Red Hat Enterprise Linux 6 安装上安装 JBoss EAP。

1.2. EAP_HOME 变量

您可以使用变量 EAP_HOME 来表示 JBoss EAP 安装的路径。将 EAP_HOME 变量设置为 JBoss EAP 安装的实际路径。为 EAP_HOME 变量设置的路径保持不变,在补丁或更新 JBoss EAP 实例后不会改变。

注意

EAP_HOME 不是环境变量。JBOSS_HOME 是脚本中使用的环境变量。

根据您选择安装 JBoss EAP 的安装选项,您可以找到安装目录或默认路径,如下所示:

  • 如果您使用存档安装方法安装 JBoss EAP,安装目录是您提取存档的 jboss-eap-7.4 目录。
  • 如果您使用安装程序应用程序安装 JBoss EAP,EAP_HOME 的默认路径为 ${user.home}/EAP-7.4.0

    • 对于 Red Hat Enterprise Linux 和 Solaris: /home/USER_NAME/EAP-7.4.0/
    • 对于 Microsoft Windows: C:\Users\USER_NAME\EAP-7.4.0\
  • 如果您使用 RPM 安装方法安装 JBoss EAP,安装目录为 /opt/rh/eap7/root/usr/share/wildfly/

第 2 章 JBoss EAP 的存档安装

您可以使用存档安装程序来安装、配置和卸载 JBoss EAP 实例。您可以在 JBoss EAP 支持的所有平台上使用存档安装。

2.1. 下载 JBoss EAP 存档

您可以使用红帽客户门户上的 JBoss EAP 存档文件安装 JBoss EAP EAP。归档文件安装是独立的平台。

先决条件

流程

  1. 登录到红帽客户门户
  2. Downloads
  3. 产品下载列表中选择 Red Hat JBoss Enterprise Application Platform
  4. Version 下拉列表中,选择 7.4
  5. 在列表中找到 Red Hat JBoss Enterprise Application Platform 7.4.0,点 Download 链接。

2.2. 使用存档安装 JBoss EAP

您可以使用存档安装方法安装 JBoss EAP。此方法是安装 JBoss EAP 的一种最简单的方式,它提供了服务器的基本默认安装,并将配置文件和库放置在标准文件夹中。

先决条件

  • 在红帽客户门户上设置帐户
  • 检查 JBoss EAP 7 支持的配置并确保您的系统受支持。
  • 下载 JBoss EAP 安装软件包。
  • 安装受支持的 Java 开发套件(JDK)。
  • 如果使用 Windows,请设置 JAVA_HOMEPATH 环境变量。如果您没有设置此设置,快捷方式将不起作用。

流程

  1. 登录到红帽客户门户
  2. Downloads
  3. 产品下载列表中选择 Red Hat JBoss Enterprise Application Platform
  4. Version 下拉列表中,选择 7.4
  5. 在列表中选择 Red Hat JBoss Enterprise Application Platform 7.4.0,然后选择 Download 链接。
  6. 可选:将存档文件移动到您要安装 JBoss EAP 的服务器和位置。

    注意

    您必须具有对此目录的读取和写入权限。

  7. 根据您的操作系统,选择以下选项之一:

    • 对于 Red Hat Enterprise Linux,在管理 CLI 中输入以下命令来提取归档文件:

      $ unzip jboss-eap-7.4.0.zip
    • 对于 Windows Server,右键单击归档文件并选择 Extract All
注意

EAP_HOME 是 JBoss EAP 安装的顶级目录。目录通过提取存档来创建。

其他资源

  • 请参阅 JBoss EAP 安装指南中的设置 EAP_HOME 变量。
  • 如需有关身份验证和授权选项的更多信息,请参阅 JBoss EAP 配置指南中的管理用户

2.3. JBoss EAP 配置文件

您可以通过取消注释和编辑对应的行来配置配置文件中提供的选项。如果不编辑配置文件,服务默认为使用默认配置文件 standalone.xml 启动独立的 JBoss EAP 服务器。

启动脚本和关联的配置文件位于 EAP_HOME/bin/init.d/ 目录中。

注意

jboss-eap.conf 文件中有几个可配置的选项。您必须为 JBOSS_HOMEJBOSS_USER 提供正确的值。

如果要在受管域中启动 JBoss EAP,请将 JBOSS_MODE=domain 添加到 jboss-eap.conf。例如,若要指定自定义域配置文件,可添加 JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xmlJBOSS_HOST_CONFIG=HOST_CONFIG_FILE.xml

注意

默认情况下,JBoss EAP 使用 domain.xmlhost-master.xml 作为域配置文件。

2.4. 将 JBoss EAP 存档安装配置为 RHEL 上的服务

您可以将归档安装配置为作为 Red Hat Enterprise Linux(RHEL)中的服务运行。

先决条件

  • 以归档安装方式安装 JBoss EAP。
  • 确保您在服务器上具有管理员特权。

流程

  1. 通过在文本编辑器中打开 jboss-eap.conf,再设置 JBoss EAP 安装的选项,配置 jboss-eap.conf 文件中的启动选项。
  2. 将服务初始化和配置文件复制到系统目录中:

    1. 将修改后的服务配置文件复制到 /etc/default 目录。

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default
    2. 将服务启动脚本复制到 /etc/init.d 目录中,并为其授予执行权限:

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      $ sudo chmod +x /etc/init.d/jboss-eap-rhel.sh
      $ sudo restorecon /etc/init.d/jboss-eap-rhel.sh
  3. 使用 chkconfig 服务管理命令,将新的 jboss-eap-rhel.sh 服务添加到自动启动的服务列表中:

    $ sudo chkconfig --add jboss-eap-rhel.sh
  4. 使用以下命令之一验证服务是否已正确安装:

    1. Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh start
    2. Red Hat Enterprise Linux 7 和 8:

      $ sudo service jboss-eap-rhel start

      服务启动。如果服务没有启动并且您收到错误消息,请检查错误日志并确保配置文件中的选项已正确设置。

    3. Red Hat Enterprise Linux 9:

      注意

      Red Hat Enterprise Linux 9 在默认构建中没有 initscripts 软件包。此软件包包括 jboss-eap-rhel.sh 服务使用的 /etc/init.d/functions 文件。需要 /etc/init.d/functions 文件将 JBoss EAP 启动为服务;因此,使用以下命令安装 initscripts 软件包:

      $ sudo dnf install initscripts
      1. 重启 systemctl:

        $ sudo systemctl daemon-reload
      2. 启动 JBoss EAP:

        $ sudo service jboss-eap-rhel start
  5. 可选: 要在 Red Hat Enterprise Linux 服务器启动时自动启动该服务,请运行以下命令:

    $ sudo chkconfig jboss-eap-rhel.sh on

验证

  • 要检查文件的权限,请在包含文件的目录中输入 ls -l 命令。
  • 要检查是否启用了自动服务启动,请输入以下命令:

    $ sudo chkconfig --list jboss-eap-rhel.sh

其他资源

  • 有关控制服务状态的更多信息,请参阅 JBoss EAP 基本系统设置指南中的管理系统服务
  • 有关查看错误日志的更多信息,请参阅 JBoss EAP 配置指南中的引导日志

2.5. 删除 RHEL 上的 JBoss EAP 服务

根据您的工作环境,归档安装方法可能无法满足您的环境需求。您可以移除 JBoss EAP 的实例以及与之关联的任何服务。然后,您可以使用适当的安装方法安装 JBoss EAP。

流程

  1. 如果服务正在运行,请打开终端并使用以下命令之一停止该服务:

    1. Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh stop
    2. Red Hat Enterprise Linux 7 及更新的版本:

      $ sudo service jboss-eap-rhel stop
  2. 从服务列表中删除 JBoss EAP:

    $ sudo chkconfig --del jboss-eap-rhel.sh
  3. 删除配置文件和启动脚本:

    $ sudo rm /etc/init.d/jboss-eap-rhel.sh
    $ sudo rm /etc/default/jboss-eap.conf

2.6. 在 Microsoft Windows Server 上安装 JBoss EAP 存档安装作为服务

您可以使用存档安装方法在 Microsoft Windows Server 上安装 JBoss EAP。这个方法提供了服务器的基本默认安装,并将配置文件和库放置在标准文件夹中。服务器的默认安装包含 service.bat 脚本,您可以将它用于 Jsvc 来停止和启动 JBoss EAP。

先决条件

  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。

流程

  1. 安装 JBoss EAP Core Services Jsvc 软件包:

    1. 打开浏览器并登录到红帽客户门户网站的软件下载页面
    2. Product 下拉列表中,选择 Apache Jsvc
    3. Version 下拉列表中,选择最新版本。
    4. Releases 列表中选择 Red Hat JBoss Core Services Apache Jsvc。确保为系统选择正确的平台和架构。接下来,选择 Download 链接。
  2. 将下载的存档文件提取到含有 JBoss EAP 安装目录的目录。这会生成一个与 JBoss EAP 安装目录相同深度的 jbcs-jsvc-<VERSION> 目录。以下示例显示了 jbcs-jsvc-<VERSION> 目录的路径:

    C:\Program Files
    ├── jboss-eap-7.4
    │   ├── bin
    │   └── ...
    └── jbcs-jsvc-<VERSION>
  3. 打开终端并将目录更改为 EAP_HOME\bin,以安装该服务。要获得所有可能选项的列表,请在没有任何参数的情况下运行 service.bat

    注意

    如果指定 /jbossuser/jbosspass 参数,您必须确保您的 JBoss EAP 用户的密码不包含哈希(#)或分号(;)。

    以下示例显示了为单机服务器或受管域中的服务器创建新服务所需的基本 service.bat install 命令。

    输入以下命令,根据需要调整服务的日志级别:

    1. 对于单机服务器:

      $ service.bat install /loglevel INFO
    2. 对于受管域中的服务器:

      使用 /host 参数指定服务控制的 JBoss EAP 主机控制器的名称。您可以通过在管理 CLI 中执行 ls /host 来查看名称的有效值。

      在以下命令中,将 EAP_HOST_NAME 替换为您的 JBoss EAP 主机控制器名称:如果您在未提供 JBoss EAP 主机控制器名称的情况下指定 /host 参数,则名称默认为 master

      $ service.bat install /host EAP_HOST_NAME /loglevel INFO
  4. 创建一个名为 JBossEAP7 的新 Windows 服务。

验证

  • 打开 Windows Services 控制台(services.msc)并检查是否已创建该服务,以验证服务控制台中的新服务。

如果使用默认服务名称,则在 Windows 服务列表中,新服务会显示为 JBossEAP7

注意

从 Services 控制台,您可以启动和停止该服务,并更改其如何和何时启动该服务的设置。

2.7. 将 JBoss EAP 存档安装配置为 Microsoft Windows Server 上的服务

您可以使用存档安装方法在 Microsoft Windows Server 上安装 JBoss EAP。这个方法提供了服务器的基本默认安装,并将配置文件和库放置在标准文件夹中。

警告

如果您使用 set 命令在 Windows Server 命令提示符中设置系统环境变量,则不会永久设置环境变量。您必须使用 setx 命令,或者使用 Control Panel 中的 System 接口。

先决条件

  • 以归档安装方式安装 JBoss EAP。
  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。
  • 验证 JBoss EAP 服务器实例未在运行。

流程

  1. 使用 setx 命令创建两个系统环境变量:JBOSS_HOMENOPAUSE
  2. 使用 setx 命令配置两个环境变量:

    1. 配置 JBOSS_HOME 变量的路径到 JBoss EAP 安装目录。
    2. jboss-cli.bat 脚本包含 if "x%NOPAUSE%" == "x" pause 行代码。当您发出 pause 命令时,此代码会创建一个状态消息。要禁用这些消息,您必须为 NOPAUSE 变量指定一个值。例如,将 NOPAUSE 变量设置为 NOPAUSE=true 可禁用脚本完成后的状态消息。

其他资源

  • 要了解如何在 Microsoft Windows Server 上设置环境变量,请参阅 Microsoft Windows 文档。

2.8. 在 Microsoft Windows Server 上启动和停止 JBoss EAP 服务

在某些情况下,您可能需要使用命令提示符来停止或启动服务。例如,如果您进行任何 registry 更改,您必须停止该服务,然后重新启动该服务以强制服务重新读取 registry。

先决条件

  • 以归档安装方式安装 JBoss EAP。

流程

  • 要启动该服务,在命令提示符后运行以下命令:
$ net start JBossEAP7
  • 要停止该服务,在命令提示符后运行以下命令:
$ net stop JBossEAP7

2.9. 在 Microsoft Windows Server 上删除 JBoss EAP 服务

根据您的工作环境,归档安装方法可能无法满足您的环境需求。您可以移除 JBoss EAP 的实例以及与之关联的任何服务。然后,您可以使用适当的安装方法安装 JBoss EAP。

流程

  1. 如果服务正在运行,使用服务名称输入 net stop 命令来打开命令提示并停止服务:

    net stop JBossEAP7
  2. 在命令提示符处,将目录改为 EAP_HOME\bin 并执行以下命令:

    service.bat uninstall

2.10. 使用 Jsvc 安装和启动 JBoss EAP 存档安装

您可以使用 JBoss Core Services ApacheHTTP Server 安装指南中的 Apache Java Service(Jsvc)组件将 JBoss EAP 作为分离的进程守护进程在 Red Hat Enterprise Linux (RHEL)上运行。

注意

虽然 Jsvc 可以在 RHEL 上工作,但我们强烈建议您使用原生方法在 RHEL 上运行 JBoss EAP 作为服务。

Jsvc 是一组库和应用程序,使 Java 应用程序能够作为后台服务运行。使用 Jsvc 运行的应用程序可以特权用户身份执行操作,然后将身份切换为非特权用户。

流程

  1. 打开浏览器并登录到红帽客户门户网站的软件下载页面
  2. Product 下拉列表中,选择 Apache Jsvc
  3. Version 下拉列表中,选择最新版本。
  4. Releases 列表中选择 Red Hat JBoss Core Services Apache Jsvc。确保为系统选择正确的平台和架构。接下来,选择 Download 链接。
  5. 将下载的存档文件提取到含有 JBoss EAP 安装目录的目录。

    这会生成一个与 JBoss EAP 安装目录相同深度的 jbcs-jsvc-<VERSION> 目录。例如:

    /var/opt/
    ├── jboss-eap-7.4
    │   ├── bin
    │   └── ...
    └── jbcs-jsvc-<VERSION>
  6. 可选:使用 Jsvc 启动 JBoss EAP 的命令示例假定已创建了 jboss 用户。如果您还没有为 JBoss EAP 创建用户,请运行以下命令来创建 jboss 用户和组:

    # groupadd -f -g 185 -r jboss
    # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss

其他资源

2.11. 启动或停止 JBoss EAP 作为单机服务器的 Jsvc 命令

使用 Java 服务(Jsvc),您可以输入各种命令来启动或停止 JBoss EAP。下表显示了 JBoss EAP 安装存档命令所需的路径列表。

表 2.1. 路径的文件位置

指令中的文件参考文件位置

JSVC_BIN

EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc

JSVC_JAR

EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar

CONF_DIR

EAP_HOME/standalone/configuration

LOG_DIR

EAP_HOME/standalone/log

以下示例演示了使用带有 JSVC_BIN \ 路径的 Jsvc 启动独立 JBoss EAP 服务器:

$ JSVC_BIN \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -D[Standalone] -XX:+UseCompressedOops -Xms1303m \
 -Xmx1303m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true \
 -Dorg.jboss.boot.log.file=LOG_DIR/server.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \
 -Djboss.home.dir=EAP_HOME \
 -Djboss.server.base.dir=EAP_HOME/standalone   \
 @org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules \
 -jaxpmodule javax.xml.jaxp-provider \
 org.jboss.as.standalone

以下示例演示了如何使用带有 JSVC_BIN \ 路径的 Jsvc 来停止独立 JBoss EAP 服务器:

$ JSVC_BIN \
 -stop \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -D[Standalone] -XX:+UseCompressedOops -Xms1303m \
 -Xmx1303m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true \
 -Dorg.jboss.boot.log.file=LOG_DIR/server.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \
 -Djboss.home.dir=EAP_HOME \
 -Djboss.server.base.dir=EAP_HOME/standalone   \
 @org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules \
 -jaxpmodule javax.xml.jaxp-provider \
 org.jboss.as.standalone

2.12. 在受管域中启动或停止 JBoss EAP 的 Jsvc 命令

使用 Java 服务(Jsvc),您可以输入各种命令来启动或停止 JBoss EAP。下表显示了用于存档 JBoss EAP 安装的命令所需的路径。

表 2.2. 路径的文件位置

指令中的文件参考文件位置

JSVC_BIN

EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc

JSVC_JAR

EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar

CONF_DIR

EAP_HOME/domain/configuration

LOG_DIR

EAP_HOME/domain/log

在发出以下命令之前,请设置 JAVA_HOME 系统环境变量。

以下示例演示了使用 Jsvc 启动 JBoss EAP 受管域:

$ JSVC_BIN \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -nodetach -D"[Process Controller]" -server -Xms64m \
 -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true  \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true  \
 -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \
 org.apache.commons.daemon.support.DaemonWrapper \
 -start org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules org.jboss.as.process-controller \
 -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \
 -mp EAP_HOME/modules -- \
 -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \

以下示例演示了如何使用 Jsvc 停止 JBoss EAP 受管域:

$ JSVC_BIN \
 -stop \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -nodetach -D"[Process Controller]" -server -Xms64m \
 -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true  \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true  \
 -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \
 org.apache.commons.daemon.support.DaemonWrapper \
 -start org.jboss.modules.Main -start-method main \

2.13. 卸载 JBoss EAP 存档安装

您可以使用 存档安装方法将 JBoss EAP 安装在单个目录中。

根据您的工作环境,归档安装方法可能无法满足您的环境需求。您可以移除 JBoss EAP 的实例以及与之关联的任何服务。然后,您可以使用适当的安装方法安装 JBoss EAP。

先决条件

  • 可选:备份任何可重复使用的配置文件和部署。

流程

  1. 删除安装目录,以卸载 JBoss EAP。
  2. 删除依赖于您计算机上安装的 JBoss EAP 的任何脚本。

第 3 章 JBoss EAP 安装程序

您可以使用 JBoss EAP 安装程序安装、配置和卸载 JBoss EAP 实例。您可以在 JBoss EAP 支持的所有平台上使用 JBoss EAP 安装程序。

3.1. 下载并安装 JBoss EAP 安装程序

您可以使用红帽客户门户提供的 JBoss EAP 安装程序。可使用 .jar 存档来运行图形或基于文本的安装程序。安装程序是在所有受支持的平台上安装 JBoss EAP 的首选方式。

先决条件

流程

  1. 登录到红帽客户门户
  2. 产品下载列表中,选择 Red Hat JBoss Enterprise Application Platform
  3. Downloads
  4. Version 下拉列表,选择 7.4
  5. 在列表中找到 Red Hat JBoss Enterprise Application Platform 7.4.0 安装程序文件,然后单击 Download 链接。

3.2. 运行 JBoss EAP 图形安装程序

图形安装程序为您提供了安装、配置和卸载 JBoss EAP 实例的便捷方式。另外,您可以使用图形安装程序来访问许多可选配置选项。

先决条件

流程

  1. 打开一个终端,再前往含有下载的 JBoss EAP 安装程序文件的目录。
  2. 使用以下命令运行图形安装程序:

    $ java -jar jboss-eap-7.4.0-installer.jar
  3. 为安装程序选择所需的语言,然后单击确定
  4. 通过选择"我接受此许可协议的条款",然后点 Next,同意接受 RED HAT JBOSS MIDDLEWARE 的 EULA 提示。
  5. 选择 JBoss EAP 的安装路径,然后单击 Next
  6. 选择要安装的组件。取消选择时禁用所需的组件。

    图 3.1. JBoss EAP 安装程序 - 组件选择屏幕

    JBoss EAP 安装程序 - 组件选择屏幕
  7. 创建管理用户并分配密码。然后单击"下一步"
  8. 查看您的安装选项,然后单击 Yes
  9. 安装进度完成后,点 Next
  10. 为您的 JBoss EAP 安装选择默认配置,或者选择通过安装程序执行高级配置。

    注意

    即使您选择了默认配置,您仍然可以在以后使用 JBoss EAP 管理接口更改配置。

  11. 选择 Perform default configuration,或者选择 Perform advanced configuration 并选择要配置的项目,然后单击 Next

    图 3.2. JBoss EAP 安装程序 - 配置运行时环境屏幕

    JBoss EAP 安装程序 - 配置运行时环境屏幕
  12. 以下配置步骤是可选的:

    配置密码库

    您可以使用 Configure Password Vault 选项在运行时环境的高级配置中安装密码库。

    • 配置密码库以将敏感密码存储在加密的密钥存储中,然后单击 Next。 

    如需更多信息,请参阅如何配置服务器安全指南中的密码库文档

    图 3.3. JBoss EAP 安装程序 - 配置密码库屏幕

    JBoss EAP 安装程序 - 配置密码库屏幕

    SSL 安全性

    您可以通过指定密钥存储的位置和保护 JBoss EAP 管理接口的密码,在运行时环境的高级配置中启用 SSL 安全性。

      a.指定密钥存储的位置,以及用于保护 JBoss EAP 管理接口的密码。

      b.指定这些值后,点 Next

      如需更多信息,请参阅如何配置服务器安全指南中有关保护管理接口的文档。

    警告

    红帽建议显式禁用 SSLv2、SSLv3 和 TLSv1.0,以便在所有受影响的软件包中明确禁用 TLSv1.1 或 TLSv1.2。

    LDAP 配置

    您可以启用 LDAP 服务器作为身份验证和授权授权,如下所示:

      a.选择 Configure Runtime

      b.选择 Enable LDAP authentication

      c.在 LDAP 配置屏幕上,完成所需的配置并单击 Next

      如需更多信息,请参阅 如何配置身份管理 中的 LDAP 文档

    图 3.4. JBoss EAP 安装程序 - LDAP 配置屏幕

    JBoss EAP 安装程序 - LDAP 配置屏幕

    LDAP 安全域配置

    您可以使用 LDAP 连接在运行时环境的高级配置中启用 LDAP 身份验证,这在上一步中定义。启用 LDAP 身份验证会创建新的安全域,此域也会与管理接口关联。 

    • 指定 LDAP Security Realm 的值,然后单击 Next

      如需更多信息,请参阅 如何配置身份管理 中的 LDAP 文档

    图 3.5. JBoss EAP 安装程序 - LDAP 安全域配置屏幕

    JBoss EAP 安装程序 - LDAP 安全域配置屏幕

    安全域配置

    您可以通过为 JBoss EAP 服务器实例配置安全域,在运行时环境的高级配置中添加安全域。大多数字段已填充默认值,不需要修改。

      a.为您的 JBoss EAP 服务器实例配置安全域。

      b.点 Next

      如需更多信息,请参阅安全架构指南中的安全域

    图 3.6. JBoss EAP 安装程序 - 安全域配置屏幕

    JBoss EAP 安装程序 - 安全域配置屏幕

    Java 安全套接字扩展配置

    您可以通过在上一步中定义的安全域配置 Jave Secure Socket Extension(JSSE),在高级配置中添加一个安全域。

      a.对于 JSSE 元素,设置密钥存储或信任存储。

      b.点 Next

    图 3.7. JBoss EAP 安装程序 - Java Secure Socket 扩展配置屏幕

    JBoss EAP 安装程序 - {JSSE} 配置屏幕

    Quickstarts

    您可以选择在运行时环境的高级配置中安装快速入门,方法是选择快速启动安装路径,然后单击 Next

    Maven 存储库设置

    您可以在运行时环境的高级配置中安装 Quickstarts,方法是选择 Maven 存储库及其 settings.xml 文件。

    图 3.8. JBoss EAP 安装程序 - Maven 存储库设置屏幕

    JBoss EAP 安装程序 - Maven 存储库设置屏幕

    套接字绑定

    选择以下选项之一来配置套接字绑定:

    • 在运行时环境的高级配置设置中配置服务器端口绑定,方法是为所有默认绑定配置端口偏移或配置自定义端口绑定。您可能需要确定安装是否使用默认端口绑定。
    • 通过选择偏移类型来配置端口偏移。
    • 通过选择是否为单机模式、域模式或两者配置端口来配置自定义绑定。
    • 如果主机仅配置 IPv6,请选中 Enable pure IPv6 configuration 复选框,安装程序会进行必要的配置更改。

    配置套接字绑定后,点 Next

    图 3.9. JBoss EAP 安装程序 - Socket 绑定屏幕

    JBoss EAP 安装程序 - Socket 绑定屏幕

    用于独立配置的自定义套接字绑定

    • 为独立模式配置自定义端口:为每个独立配置设置端口(standalone, standalone ha, standalone full, standalone full-ha),然后点 Next

    图 3.10. JBoss EAP 安装程序 - 用于独立配置屏幕的自定义套接字绑定

    JBoss EAP 安装程序 - 用于独立配置屏幕的自定义套接字绑定

    域配置的自定义套接字绑定

    • 为域模式设置自定义端口绑定:为主机配置(domain host)和每个域配置集(domain default, domain ha, domain full, domain full-ha)设置端口和系统属性,然后点 Next

    图 3.11. JBoss EAP 安装程序 - 自定义域配置屏幕套接字绑定

    JBoss EAP 安装程序 - 自定义域配置屏幕套接字绑定

    日志记录选项

    您可以在运行时环境的高级配置设置中配置日志级别,如下所示:

      a.为根日志记录器和控制台日志记录器选择所需的日志记录级别。

      b.点 Next

    Jakarta 服务器面临设置

    您可以在运行时环境的高级配置设置中安装 Jakarta Server Faces 实施,如下所示:

      a.配置 Jakarta Server Faces 选项和到您的 Jakarta Server Faces JAR 的选项和路径。

      b.点 Next

      如需更多信息,请参阅配置指南中的安装 Jakarta Server Faces 实施

    图 3.12. JBoss EAPinstaller - Jakarta 服务器遇到设置屏幕

    JBoss EAP 安装程序 - Jakarta Server Faces 设置屏幕

    JDBC 驱动程序设置

    您可以通过安装和设置 JDBC 驱动程序,在运行时环境的高级配置设置中安装 JDBC 驱动程序。

      a.从下拉列表中选择适当的驱动程序供应商。

      b.指定驱动程序的 JAR 位置。

      c.点 Next

      如需更多信息,请参阅配置指南中的数据源 JDBC 驱动程序章节

    图 3.13. JBoss EAP 安装程序 - JDBC 驱动程序设置屏幕

    JBoss EAP 安装程序 - JDBC 驱动程序设置屏幕

    数据源设置

    您可以通过配置数据源,安装 JDBC 驱动程序,并在运行时环境的高级配置设置中安装数据源。

      a.提供数据源名称并配置其他选项。

      b.点 Next

      如需更多信息,请参阅配置指南中的数据源管理

    图 3.14. JBoss EAP 安装程序 - 数据源设置屏幕

    JBoss EAP 安装程序 - 数据源设置屏幕
  13. 配置进度完成后,点 Next
  14. Start-Menu 复选框中选择 Create 快捷方式来创建快捷方式,然后单击 Next

    注意

    仅允许字母数字字符、短划线(-)和下划线(_)字符。在 Microsoft Windows 上,也允许使用斜杠(/)和反斜杠(\)字符。

  15. 如果要捕获将来自动安装程序安装时所选安装选项,请点 Generate installation script and properties file,然后点 Done

安装现已完成。安装程序创建的 目录是服务器的顶级目录。这称为 EAP_HOME

3.3. 运行 JBoss EAP 基于文本的安装程序

您可以使用基于文本的安装程序安装、配置和卸载 JBoss EAP 实例。此安装程序方法提供了未经批准且直接的体验。

先决条件

流程

  1. 打开一个终端,再前往含有下载的 JBoss EAP 安装程序的目录。
  2. 使用以下命令运行基于文本的安装程序:

    $ java -jar jboss-eap-7.4.0-installer.jar -console
  3. 按照提示安装 JBoss EAP:安装程序创建的 目录是服务器的顶级目录。这称为 EAP_HOME

其他资源

  • 请参阅 JBoss EAP 安装指南中的设置 EAP_HOME 变量。

3.4. 将 JBoss EAP 安装程序安装配置为 RHEL 上的服务

您可以将安装程序安装配置为作为 Red Hat Enterprise Linux(RHEL)中的服务运行。

先决条件

  • 安装安装程序。
  • 确保您在服务器上具有管理员特权。

流程

  1. 通过在文本编辑器中打开 jboss-eap.conf,再设置 JBoss EAP 安装的选项,配置 jboss-eap.conf 文件中的启动选项。
  2. 将服务初始化和配置文件复制到系统目录中:

    1. 将修改后的服务配置文件复制到 /etc/default 目录。

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default
    2. 将服务启动脚本复制到 /etc/init.d 目录中,并为其授予执行权限:

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      $ sudo chmod +x /etc/init.d/jboss-eap-rhel.sh
  3. 使用 chkconfig 服务管理命令,将新的 jboss-eap-rhel.sh 服务添加到自动启动的服务列表中:

    $ sudo chkconfig --add jboss-eap-rhel.sh
  4. 使用以下命令之一验证服务是否已正确安装:

    1. Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh start
    2. Red Hat Enterprise Linux 7 及更新的版本:

      $ sudo service jboss-eap-rhel start

      服务启动。如果服务没有启动并且您收到错误消息,请检查错误日志并确保配置文件中的选项已正确设置。

  5. 可选: 要在 Red Hat Enterprise Linux 服务器启动时自动启动该服务,请运行以下命令:

    $ sudo chkconfig jboss-eap-rhel.sh on

    验证

    • 要检查文件的权限,请在包含文件的目录中输入 ls -l 命令。
    • 要检查是否启用了自动服务启动,请输入以下命令:

      $ sudo chkconfig --list jboss-eap-rhel.sh
    • 有关控制服务状态的更多信息,请参阅 JBoss EAP 基本系统设置指南中的管理系统服务
    • 有关查看错误日志的更多信息,请参阅 JBoss EAP 配置指南中的引导日志

3.5. 将 JBoss EAP 安装程序安装配置为 Microsoft Windows Server 上的服务

您可以使用安装程序安装方法在 Microsoft Windows Server 上安装 JBoss EAP。这个方法提供了服务器的基本默认安装,并将配置文件和库放置在标准文件夹中。服务器的默认安装包含 service.bat 脚本,您可以将它用于 Jsvc 来停止和启动 JBoss EAP。

注意

如果您使用 set 命令在 Windows Server 命令提示符中设置系统环境变量,则不会永久设置环境变量。您必须使用 setx 命令,或者使用 Control Panel 中的 System 接口。

先决条件

  • 安装 JBoss EAP 安装程序。
  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。
  • 确保您有一个 JBoss EAP 服务器的实例未在运行。

流程

将 JBoss EAP 安装程序安装配置为 Microsoft Windows Server 中的服务的步骤与存档安装方法的步骤类似。参阅将 JBoss EAP 存档安装配置为 Microsoft Windows Server 上的服务

3.6. 使用 Jsvc 安装并运行 JBoss EAP 安装程序安装

您可以使用 JBoss Core Services ApacheHTTP Server 安装指南中的 Apache Java Service(Jsvc)组件将 JBoss EAP 作为分离的服务(一个进程守护进程)在 Red Hat Enterprise Linux (RHEL)上运行。

警告

虽然 Jsvc 可以在 RHEL 上工作,但我们强烈建议您使用原生方法在 RHEL 上运行 JBoss EAP 作为服务。

Jsvc 是一组库和应用程序,使 Java 应用程序能够作为后台服务运行。使用 Jsvc 运行的应用程序可以特权用户身份执行操作,然后将身份切换为非特权用户。

先决条件

  • 安装 JBoss EAP 安装程序。
  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。
  • 确保您有一个 JBoss EAP 服务器的实例未在运行。

流程

使用 Jsvc 配置 JBoss EAP 安装程序安装的过程与使用存档安装方法的流程类似。如需更多信息,请参阅 JBoss EAP 安装指南中的以下章节:

  • 使用 Jsvc 安装和启动 JBoss EAP 安装程序安装
  • 启动或停止 JBoss EAP 作为单机服务器的 Jsvc 命令
  • 在受管域中启动或停止 JBoss EAP 的 Jsvc 命令
  • 可选:在 Microsoft Windows Server 上将 JBoss EAP 安装程序安装配置为服务

其他资源

3.7. 使用自动安装程序安装

如果您使用安装程序安装来安装 JBoss EAP,您可以使用上一安装生成的安装脚本来自动执行相同的配置的未来安装。

警告

自动安装程序不向后兼容。您无法使用先前版本的 JBoss EAP 及自动化安装程序生成的安装脚本。仅使用由相同 JBoss EAP 次要版本生成的安装脚本。例如,JBoss EAP 7.4.

先决条件

  • 使用安装程序安装生成自动安装脚本。

    • 自动安装脚本是 XML 文件。

流程

  1. 打开一个终端,再前往含有下载的 JBoss EAP 安装程序文件的目录。
  2. 运行以下命令以使用自动安装脚本 XML 文件安装 JBoss EAP:

    $ java -jar jboss-eap-7.4.0-installer.jar auto.xml

    默认情况下,安装程序会提示您输入 JBoss EAP 配置所需的任何密码。您可以通过预先设置安装的密码来进行无人值守安装。

    注意

    您可以在网络主机上存储自动安装脚本 XML 文件,并使用 HTTP 或 FTP 将安装程序用于安装。例如:

    $ java -jar jboss-eap-7.4.0-installer.jar http://network-host.local/auto.xml
    $ java -jar jboss-eap-7.4.0-installer.jar ftp://network-host.local/auto.xml

其他资源

  • 请参阅 JBoss EAP 安装指南中的无人值守自动化安装程序安装。

3.8. 无人值守自动化安装程序安装

若要进行无人值守的自动化安装程序安装,您必须预设 JBoss EAP 安装所需的密码。

当安装脚本 XML 文件从之前的安装程序安装生成时,也会生成一个不完整的安装脚本变量文件。它的文件名与安装脚本文件相同,但带有一个 .variables 后缀。

变量文件包含无人值守自动安装所需的密钥和密码参数的列表。

您可以将所需的密码作为已完成的变量文件提供,或者在运行安装程序命令时作为参数提供。

3.9. 在安装程序命令中提供密码作为参数

您可以在文本编辑器中编辑 .variables 文件,并为每个键提供密码值。然后,您可以使用自动安装脚本运行安装程序。如果已完成的变量文件与安装脚本 XML 文件位于同一个目录中,安装程序会自动检测变量文件。此外,您不得具有修改的变量文件名。

先决条件

  • 使用 JBoss EAP 安装程序生成自动安装脚本。

    • 自动安装脚本是 XML 文件。

流程

  1. 在文本编辑器中打开 .variables 文件,并为每个键提供密码值。以下示例演示了为键设置密码值:

    adminPassword = password#2
    vault.keystorepwd = vaultkeystorepw
    ssl.password = user12345
  2. 使用自动安装脚本 XML 文件运行安装程序:

    $ java -jar jboss-eap-7.4.0-installer.jar auto.xml
    
    Checking for corresponding .variables file
    Variables file detected: auto.xml.variables
    [ Starting automated installation ]
    ...

3.10. 提供密码作为已完成的变量文件

您可以使用管理 CLI 中的 -variablefile 选项指定变量文件的路径。然后,您可以使用自动安装脚本运行安装程序,以使用 -variables 参数将密码指定为键或值对。

先决条件

  • 使用 JBoss EAP 安装程序生成自动安装脚本。

    • 自动安装脚本是 XML 文件。

流程

  1. 使用 -variablefile 指定变量文件的路径:

    $ java -jar jboss-eap-7.4.0-installer.jar auto.xml -variablefile auto.xml.variables
  2. 使用自动安装脚本 XML 文件运行安装程序,并使用 -variables 参数将所需密码指定为键/值对,如下例所示:

    $ java -jar jboss-eap-7.4.0-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345
    注意

    在指定 -variables 键或值对时,检查您没有输入任何空格。

3.11. 使用图形卸载程序卸载 JBoss EAP 安装程序

如果使用安装程序安装 JBoss EAP,您可以使用图形卸载程序卸载 JBoss EAP。图形卸载程序提供了一种便捷的方式,可在几个简单步骤中卸载 JBoss EAP 安装程序。

先决条件

  • 安装 JBoss EAP 安装程序。
  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。
  • 确保您有一个 JBoss EAP 服务器的实例未在运行。

流程

  1. 打开一个终端,再进入 EAP_HOME/Uninstaller
  2. 使用以下命令运行图形卸载程序:

    $ java -jar uninstaller.jar

    图形卸载器与下图类似:如果要删除 JBoss EAP 安装目录,请选中复选框。

    图 3.15. JBoss EAP 图形卸载程序

    JBoss EAP JBoss EAP Graphical Uninstaller
  3. Uninstall 启动卸载过程。
  4. 卸载过程完成后,点 Quit 以退出卸载程序。

3.12. 使用文本卸载程序卸载 JBoss EAP 安装程序安装

如果使用安装程序安装 JBoss EAP,您可以使用文本卸载程序卸载 JBoss EAP。文本卸载程序为手动卸载 JBoss EAP 安装程序提供了一种更简单的方式。

先决条件

  • 安装 JBoss EAP 安装程序。
  • 确保您在服务器上具有管理员特权。
  • 设置 JAVA_HOME 系统环境变量。
  • 确保您有一个 JBoss EAP 服务器的实例未在运行。

流程

  1. 打开一个终端,再进入 EAP_HOME/Uninstaller
  2. 使用以下命令运行基于文本的卸载程序:

    $ java -jar uninstaller.jar -console
  3. 按照提示卸载 JBoss EAP。

第 4 章 JBoss EAP 的 RPM 安装

您可以使用 RPM 软件包在受支持的 Red Hat Enterprise Linux 6、Red Hat Enterprise Linux 7 和 Red Hat Enterprise Linux 8 安装 JBoss EAP。

4.1. 订阅次版本 JBoss EAP 存储库

若要使用 RPM 安装 JBoss EAP,您需要订阅 Red Hat Enterprise Linux Server 基础软件存储库和次要 JBoss EAP 存储库。

对于 JBoss EAP 存储库,您必须订阅 minor JBoss EAP 存储库。minor 存储库提供 JBoss EAP 7 的特定次要版本及所有适用补丁。这使您可以保持相同的 JBoss EAP 次要版本,同时获得高严重性和安全补丁。

例如,从此存储库的更新包括 JBoss EAP 次版本的补丁和安全更新,但包括从 JBoss EAP 7.4 升级到 JBoss EAP 7.5。

先决条件

流程

  1. 输入 Red Hat Subscription Manager。
  2. EAP_MINOR_VERSION 替换为您预期的 JBoss EAP minor 版本。例如,7.4

    1. 对于 Red Hat Enterprise Linux 6 和 7,根据您的 Red Hat Enterprise Linux 版本,将 RHEL_VERSION 替换为 67

      # subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms
    2. 对于 Red Hat Enterprise Linux 8,使用以下命令:

      # subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-ARCH-rpms

4.2. 在 RHEL 上安装 JBoss EAP RPM 安装

选择红帽数据包管理器(RPM)以安装 JBoss EAP 的次要版本。相反,您可以使用这种方法订阅当前的 JBoss EAP。

JBoss EAP 的次要版本提供特定的次要版本及所有适用补丁。订阅 JBoss EAP 的次版本时,您可以保持高严重性和安全性补丁的最新状态。

先决条件

  • 在红帽客户门户上设置帐户
  • 检查 JBoss EAP 7 支持的配置并确保您的系统受支持。
  • 下载 JBoss EAP 安装软件包。
  • 使用 Red Hat Subscription Manager 注册到 Red Hat Enterprise Linux 服务器。
  • 安装受支持的 Java 开发套件(JDK)。

流程

  1. 安装 JBoss EAP 和 JDK 8.

    # yum groupinstall jboss-eap7
  2. 安装 JBoss EAP 和 JDK 11.JDK 11 适用于 Red Hat Enterprise Linux 7 及更高版本。

    • Red Hat Enterprise Linux 7:

      # yum groupinstall jboss-eap7-jdk11
    • Red Hat Enterprise Linux 8:

      # dnf groupinstall jboss-eap7-jdk11
      注意

      如果系统上没有安装 JDK 版本,则 groupinstall 命令会安装指定的 JDK 版本。如果存在 JDK 的不同版本,则系统会在执行命令后包含多个 JDK。

      如果在 groupinstall 完成后,您的系统上安装了多个 JDK,请检查哪个 JDK 用于 JBoss EAP 执行。默认情况下使用系统默认 JDK。

      您可以通过以下任一方式修改默认值:

      • 使用 alternatives 命令更改系统范围配置:

        # alternatives --config java

        命令显示已安装的 JDK 列表,以及设置特定 JDK 作为默认值的说明。

      • 使用 JAVA_HOME 属性更改 JBoss EAP 使用的 JDK。

        您的安装已完成。RPM 安装的默认 EAP_HOME 路径为 /opt/rh/eap7/root/usr/share/wildfly

        重要

        在使用 RPM 安装程序安装 JBoss EAP 时,不支持在同一计算机上配置多个域或主机控制器。

其他资源

  • 请参阅 JBoss EAP 安装指南中的设置 EAP_HOME 变量。
  • 请参阅 JBoss EAP 安装指南 中的订阅次 JBoss EAP 存储库。
  • 有关更改 JAVA_HOME 属性的更多信息,请参阅《配置指南》中的 RPM 服务配置属性部分

4.3. 更改软件仓库

在 JBoss EAP 安装的生命周期内,您可能希望将软件订阅从一个 JBoss EAP 存储库更改为另一个存储库。支持更改软件仓库,但仅在以下情况下:

  • 如果更改为最新的次存储库,则支持从当前存储库更改为次要存储库。
  • 如果更改为下一个次 JBoss EAP 版本,则支持从 minor 存储库更改为另一个minor 存储库。例如,从 JBoss EAP 7.0 更改为 JBoss EAP 7.1 被支持,但从 JBoss EAP 7.0 更改为 JBoss EAP 7.2 不被支持
重要

从 JBoss EAP 7.3 开始,JBoss EAP current 存储库不再可用。如果您订阅了 JBoss EAP 之前版本的 current 存储库,您必须将您的订阅更改为此 JBoss EAP 版本的 minor 存储库。

先决条件

  • 使用 RPM 安装方式安装 JBoss EAP。
  • 选择一个存储库。
  • 确保 JBoss EAP 安装应用了所有适用的更新。

    • 在终端中运行以下命令以应用更新:
# yum update
  • 遵守上面显示的支持更改条件。

流程

  1. 使用红帽订阅管理器,退出现有存储库并订阅新存储库。在以下命令中,将 EXISTING_REPOSITORYNEW_REPOSITORY 替换为对应的存储库名称。

    # subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY

4.4. 将 JBoss EAP RPM 安装配置为 RHEL 上的服务

您可以配置 Red Hat Packet Manager(RPM)安装,作为 Red Hat Enterprise Linux(RHEL)中的服务运行。JBoss EAP 的 RPM 安装安装所有作为服务运行 JBoss EAP 所需的一切

如此流程中所示,为您的 RHEL 运行适当的 命令。将 EAP_SERVICE_NAME 替换为独立 JBoss EAP 服务器的 eap7-standalone,或者替换为受管域的 eap7-domain

重要

您不能在一台机器上将多个 JBoss EAP 实例配置为服务。

先决条件

  • 将 JBoss EAP 作为 RPM 安装安装.
  • 确保您在服务器上具有管理员特权。

流程

  • Red Hat Enterprise Linux 6:

    chkconfig EAP_SERVICE_NAME on
  • Red Hat Enterprise Linux 7 及更新的版本:

    systemctl enable EAP_SERVICE_NAME.service

其他资源

  • 若要按需启动或停止 JBoss EAP 的 RPM 安装,请参阅 JBoss EAP 配置指南中的 RPM 指令
  • 有关更多详细信息和选项,请参见 JBoss EAP 配置指南中的RPM 服务配置文件附录

4.5. 使用 Jsvc 安装 JBoss EAP RPM 安装

您可以使用 JBoss 核心服务集合中的 Apache Java 服务(Jsvc)组件将 JBoss EAP 作为分离的进程在 Red Hat Enterprise Linux (RHEL) 上运行。您通常使用 Jsvc 在 Windows 或 Solaris 上运行 JBoss EAP。

为获得最佳产品性能,请使用原生方法在您的 RHEL 版本上运行 JBoss EAP 作为服务。

Jsvc 是一组库和应用程序,使 Java 应用程序能够作为后台服务运行。使用 Jsvc 运行的应用程序能够以特权用户身份执行操作,然后将身份切换为非特权用户。

先决条件

  • 将 JBoss EAP 作为 RPM 安装安装.
  • 确保您在服务器上具有管理员特权。

流程

  1. 登录到红帽客户门户
  2. 单击 Subscriber 清单中的 Systems
  3. 为您的操作系统版本和架构订阅 JBoss Core Services CDN 仓库:

    1. Red Hat Enterprise Linux 6:

      jb-coreservices-1-for-rhel-6-server-rpms
    2. Red Hat Enterprise Linux 7 及更新的版本:

      jb-coreservices-1-for-rhel-7-server-rpms
    3. 以 root 用户身份运行以下命令安装 Apache Jsvc:

      # yum groupinstall jbcs-jsvc

其他资源

4.6. 启动或停止 JBoss EAP 作为单机服务器的 Jsvc 命令

使用 Java 服务(Jsvc),您可以输入各种命令来启动或停止 JBoss EAP。下表显示了 JBoss EAP 安装存档命令所需的路径列表。

表 4.1. 路径的文件位置

指令中的文件参考文件位置

JSVC_BIN

/usr/bin/jbcs-jsvc/jsvc

JSVC_JAR

/usr/bin/jbcs-jsvc/commons-daemon.jar

CONF_DIR

/opt/rh/eap7/root/usr/share/wildfly/standalone/configuration

LOG_DIR

/opt/rh/eap7/root/usr/share/wildfly/standalone/log

以下示例演示了使用带有 JSVC_BIN \ 路径的 Jsvc 启动 JBoss EAP 单机服务器:

$ JSVC_BIN \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -D[Standalone] -XX:+UseCompressedOops -Xms1303m \
 -Xmx1303m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true \
 -Dorg.jboss.boot.log.file=LOG_DIR/server.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \
 -Djboss.home.dir=EAP_HOME \
 -Djboss.server.base.dir=EAP_HOME/standalone   \
 @org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules \
 -jaxpmodule javax.xml.jaxp-provider \
 org.jboss.as.standalone

以下示例演示了如何使用带有 JSVC_BIN \ 路径的 Jsvc 来停止 JBoss EAP 单机服务器:

$ JSVC_BIN \
 -stop \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -D[Standalone] -XX:+UseCompressedOops -Xms1303m \
 -Xmx1303m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true \
 -Dorg.jboss.boot.log.file=LOG_DIR/server.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \
 -Djboss.home.dir=EAP_HOME \
 -Djboss.server.base.dir=EAP_HOME/standalone   \
 @org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules \
 -jaxpmodule javax.xml.jaxp-provider \
 org.jboss.as.standalone

4.7. 启动或停止 JBoss EAP 作为受管域的 Jsvc 命令

使用 Java 服务(Jsvc),您可以输入各种命令来启动或停止 JBoss EAP。下表显示了 JBoss EAP 安装存档命令所需的路径列表。

表 4.2. 路径的文件位置

指令中的文件参考文件位置

JSVC_BIN

/usr/bin/jbcs-jsvc/jsvc

JSVC_JAR

/usr/bin/jbcs-jsvc/commons-daemon.jar

CONF_DIR

/opt/rh/eap7/root/usr/share/wildfly/domain/configuration

LOG_DIR

/opt/rh/eap7/root/usr/share/wildfly/domain/log

以下示例演示了使用带有 JSVC_BIN \ 路径的 Jsvc 启动 JBoss EAP 域服务器。在发出以下命令之前,请设置 JAVA_HOME 系统环境变量。

$ JSVC_BIN \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -nodetach -D"[Process Controller]" -server -Xms64m \
 -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true  \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true  \
 -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \
 org.apache.commons.daemon.support.DaemonWrapper \
 -start org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules org.jboss.as.process-controller \
 -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \
 -mp EAP_HOME/modules -- \
 -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \

以下示例演示了如何使用带有 JSVC_BIN \ 路径的 Jsvc 来停止 JBoss EAP 域服务器。

$ JSVC_BIN \
 -stop \
 -outfile LOG_DIR/jsvc.out.log   \
 -errfile LOG_DIR/jsvc.err.log   \
 -pidfile LOG_DIR/jsvc.pid  \
 -user jboss \
 -nodetach -D"[Process Controller]" -server -Xms64m \
 -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true  \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true  \
 -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \
 org.apache.commons.daemon.support.DaemonWrapper \
 -start org.jboss.modules.Main -start-method main \
 -mp EAP_HOME/modules org.jboss.as.process-controller \
 -jboss-home EAP_HOME -jvm $JAVA_HOME/bin/java \
 -mp EAP_HOME/modules -- \
 -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \
 -Dlogging.configuration=file:CONF_DIR/logging.properties \
 -Djboss.modules.policy-permissions \
 -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \
 -Djava.net.preferIPv4Stack=true \
 -Djboss.modules.system.pkgs=org.jboss.byteman \
 -Djava.awt.headless=true -- -default-jvm $JAVA_HOME/bin/java

4.8. 卸载 JBoss EAP RPM 安装

警告

不建议使用 RPM 方法卸载 JBoss EAP 安装。

由于 RPM 软件包管理的性质,无法保证完全删除所有已安装的软件包和依赖项,也不能保证系统不会因缺少软件包依赖项而处于不一致的状态。





更新于 2024-02-08

法律通告

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.