Red Hat Training
A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform
安装指南
适用于 Red Hat JBoss 企业版应用程序平台 6
Red Hat Customer Content Services
摘要
第 1 章 产品概述
1.1. 关于 Red Hat JBoss 企业版应用程序平台 6
1.2. JBoss EAP 6 的功能
表 1.1. JBoss EAP 6 的功能
功能 | 描述 |
---|---|
Java 认证 | 认证了 Java EE 6 的 Full 和 Web 配置集。 |
受管域 |
|
管理控制台和管理 CLI | 新的域或独立服务器管理界面。您不再需要编辑 XML 配置文件了。管理 CLI 也包括可以用脚本完成和管理任务自动化的批模式。 |
简化的目录格式 | modules 目录现在包括了所有的应用服务器模块。公用的和服务器专有的 lib 目录已被抛弃。domain 和 standalone 目录包含了域和独立部署的 artifact 和配置文件。 |
模块化的类加载机制 | 模块将根据需要来加载和卸载。这将提高性能和增强安全性、以及更快的启动和重启速度。 |
流线型的数据源管理 | 数据库驱动可以像其他服务一样部署。此外,数据源可以在管理控制台和管理 CLI 里直接创建和管理。 |
资源使用更少的且效率更高。 | JBoss EAP 6 使用了更少的系统资源并比以前的版本更高效率地利用资源。JBoss EAP 6 的启动与停止也比 JBoss EAP 5 快。 |
第 2 章 介绍
2.1. 关于 Red Hat 客户门户网站
- 管理和维护 Red Hat 权利和支持合约。
- 下载官方支持的软件。
- 访问产品文档和 Red Hat 知识库。
- 联系全球支持服务。
- 报告 Red Hat 产品的程序错误。
第 3 章 安装说明
3.1. JBoss EAP 6 的安装方法
表 3.1. 安装方法
方法
|
描述
|
说明
|
---|---|---|
ZIP 安装
|
ZIP 文件安装方法适用于所有被支持的操作系统。如果您想手动解压,您该使用这个过程。
| |
JAR 安装程序
|
JAR 安装程序可以运行在控制台或图形化向导里。这两种方式都提供了逐步说明来安装和配置服务器实例。安装程序也可以进行其他的设置,如 Quickstart 和 Maven 资料库。这是在所有被支持的平台上安装 JBoss EAP 6 的首选方法。
| |
RPM 安装
|
JBoss EAP 6 可以用 RPM 软件包图形化安装程序或命令行界面进行安装。这个方法适合被支持的红帽企业版 Linux 5、6 和 7 的安装。
|
3.2. JBoss EAP 6 的安装预备条件
共同的预备条件
- 在 Red Hat Customer Portal https://access.redhat.com 上设立帐号。关于更多的信息,请参考 第 2.1 节 “关于 Red Hat 客户门户网站”
- 请查看受支持的配置以确保您的系统是受支持的:https://access.redhat.com/site/articles/111663。
- 请确保您的系统从 Red Hat 获得了最新的更新和勘误。
ZIP/安装程序的预备条件
- 安装目录的管理权限。
- 确保已安装支持的 Java 开发工具。
- 在 Microsoft Windows 里,确保设置了 JAVA_HOME 和 PATH 环境变量。
- 在 Hewlett-Packard HP-UX 里,确保已经安装了
unzip
工具。
RPM 的预备条件
- 在 Red Hat 网络中注册服务器。
- 确保已安装支持的 Java 开发工具。Java 开发工具的 RPM 必须提供并导出
java
功能。 - 订阅下列频道,这适用于所有 Red Hat 企业版 Linux 版本及架构:
- 适用于您的 Linux 版本的 Red Hat 企业版 Linux 服务器
base
和supplementary
软件频道/资料库。安装 Java 开发工具要求supplementary
频道/资料库。 - JBoss EAP 6 频道或资料库。关于相关的频道或资料库,请参考 第 3.5 节 “RPM 安装”。
- 如果主机架构是 ppc64,请订阅下列频道/服务器。
- Red Hat 企业版 Linux 6,请订阅
rhel-ppc64-server-optional-6
频道。 - Red Hat 企业版 Linux 7,请订阅
rhel-7-for-power-server-optional-rpms-7Server
资料库。
3.3. ZIP 安装
3.3.1. 下载 JBoss EAP 6(ZIP 安装)
JBoss EAP 6 Zip 文件可以在 Red Hat 客户入口下载。这个 ZIP 文件是平台独立的。本节涵盖了下载这个归档文件的步骤。
过程 3.1. 下载 ZIP 文件
- 打开浏览器并登录客户门户: https://access.redhat.com。
- 点击 Downloads。
- 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform。
- 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。
- 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x 并点击 Download 选项。
JBoss EAP 6 已经成功下载到目标主机,可以开始安装了。
3.3.2. 安装 JBoss EAP 6 的 ZIP 安装文件
本节涵盖使用下载的 ZIP 文件安装 JBoss EAP 6 的步骤。
过程 3.2. 用 ZIP 文件安装
将 ZIP 归档移至到所需的位置。
将 ZIP 文件移至您计划安装 EAP 6 的服务器和目录。将启动和停止平台的用户必须有这个目录的读和写权限。使用合适的应用程序以解压 ZIP 归档文件到所选位置。
在 Red Hat 企业版 Linux 环境下,请使用unzip
工具来解压 ZIP 归档文件。在 Microsoft Windows 环境里,右击文件并选择 Extract All。在 Hewlett-Packard HP-UX 环境下,请使用unzip
工具来解压 ZIP 归档文件。
JBoss EAP 6 安装已经成功安装。解压 ZIP 归档创建的目录是服务器的顶层目录,通常被称为 EAP_HOME/
。
3.3.3. 卸载 JBoss EAP 6(ZIP 安装)
备份任何已修改的配置文件和在以后实例里可以重用的部署。
本节涵盖卸载 JBoss EAP 6 ZIP 安装所需的步骤。
过程 3.3. 卸载 JBoss EAP 6(ZIP 安装)
- 进入您从 ZIP 文件解压的 JBoss EAP 6 的目录。
删除安装目录。
当您使用 ZIP 安装方法时,JBoss EAP 6 安装在单个目录里。删除这个安装目录以卸载 JBoss EAP 6。可选:删除您创建的任何初始化脚本。
如果您创建了初始化脚本或其他依赖于安装在您的机器里的 JBoss EAP 6 的脚本,请删除它们。
从服务器里卸载了 JBoss EAP 6。
3.4. 安装程序
3.4.1. 下载 JBoss EAP 6 的安装程序
JBoss EAP 6 安装程序归档文件可以在 Red Hat 客户入口里下载。.jar
文件可以通过图形化界面或基于文本的安装程序来运行。安装程序是在所有支持的平台上安装 JBoss EAP 6 的首选方法。本节涵盖了下载这个归档文件的步骤。
过程 3.4. 下载安装程序
- 打开浏览器并登录客户门户: https://access.redhat.com。
- 点击 Downloads。
- 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform。
- 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。
- 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x Installer 并点击 Download 选项。
JBoss EAP 6 已经成功下载到目标主机,可以开始安装了。
3.4.2. 运行 JBoss EAP 安装程序
过程 3.5. 运行 JBoss EAP 安装程序
- 打开终端窗口并进入包含安装程序 JAR 文件的目录。
- 输入下列命令:
java -jar jboss-eap-6.x.x-installer.jar
- 遵循下表中的说明。
表 3.2. JBoss EAP 安装程序屏幕
屏幕名称
|
何时出现
|
描述
|
---|---|---|
总是
|
选择安装程序的语言并点击 OK。
| |
总是
|
用于 RED HAT JBOSS 中间件的 EULA。
选择 "I accept the terms of this license agreement" 并点击 Next。
| |
总是
|
选择安装路径并点击 Next。系统会提示您创建新的目录,或者是否覆盖已存在的目录。
| |
总是
|
选择要安装的软件包。必需的软件包是禁止取消的。
| |
总是
|
创建一个管理用户并设置密码。密码必须至少有 8 个字符,其中有一个字母、数字和一个非字母数字符号。然后点击Next。
| |
总是
|
安装 Quickstart 例程。如果您要安装这些例程,请选择 Yes 以及安装路径。如果您不想安装,请选择 No。然后点击 Next。
| |
如果您选择安装 Quickstart 例程
|
Quickstart 例程要使用公共的 Maven 资料库。默认的选项会自动配置您的安装来使用这个资料库。这是运行 Quickstart 最容易的途径。如果您愿意,可以指定路径为本地安装的资料库。如果 Maven 设置文件不在默认的位置,也请指定它的路径。
| |
总是
|
确定安装过程使用默认的端口绑定、自定义端口绑定还是为默认绑定配置端口偏移量。如果您选择自定义绑定,请选择配置独立模式或域模式的端口,还是两者都配置。如果您选择配置端口偏移量,则选择偏移量配置。然后点击『下一步』。
| |
如果您选择在独立模式下配置自定义端口绑定
|
请根据不同的独立模式配置端口和系统属性,然后点击 Next。
| |
如果您选择在域模式下配置自定义端口绑定
|
请根据不同的域模式配置端口和系统属性,然后点击 Next。
| |
总是
|
选择完成安装过程后的首选启动选项。然后点击 Next。
| |
总是
|
选择 Yes 来配置日志级别,或者 No 跳过这个配置。然后点击 Next。
| |
总是
|
选择 Perform default configuration 来安装默认配置。通过 Perform advanced configuration 从列表里选择高级配置选项。高级选项可以在安装后进行配置。然后点击 Next。
| |
如果您选择在运行环境的高级配置里安装密码库
|
配置密码库(Password Vault)用加密的密钥库来存储所有敏感性密码并点击 Next。更多信息请参考《管理和配置指南》里的 "Mask the Keystore Password and Initialize the Password Vault" 章节。
| |
如果您选择在运行环境的高级配置里启用 SSL 安全性
|
配置用于保护 EAP 管理接口的 SSL 密钥库。然后点击 Next。更多信息请参考《安全指南》里的 "Generate a SSL Encryption Key and Certificate" 章节。
警告
Red Hat 推荐您在所有受影响的软件包里显性地禁用 TLSv1.1 或 TLSv1.2 上的 SSL。
| |
如果您选择在运行环境的高级配置里启用 LDAP 配置
|
启用 LDAP 验证以将 LDAP 目录服务器用作管理控制台、管理 CLI 或 API 的验证源。完成后请点击 Next。更多信息请参考《管理和配置指南》里的 "Use LDAP to Authenticate to the Management Interfaces"。
| |
如果您选择在运行环境的高级配置里安装 Infinispan 缓存
|
创建一个用于管理缓存数据的 Infinispan 缓存。指定 Infinispan 的名称,配置其他字段并点击 Next。更多信息请参考《管理和配置指南》的 "Chapter 14 Infinispan" 章节。
| |
如果您选择在运行环境的高级配置里添加安全域
|
配置一个安全域将 PicketBox 提供的服务集成到 JBoss EAP 实例里。多数字段都已经用默认值进行了填充,您不需要进行修改。完成后请点击 Next。更多信息请参考《管理和配置指南》里的 "Security Domains" 章节。
| |
如果您选择在运行环境的高级配置里安装 JDBC 驱动
|
安装和设置 JDBC 驱动来将您的应用程序代码转换为相关的数据库语言。从 "Driver Vendor" 下拉列表里选择合适的驱动。更多的信息请参考《管理和配置指南》里的 "Chapter 6 Datasource Management" 章节。
| |
如果您选择在运行环境的高级配置里安装数据源
|
配置应用程序使用的数据源。指定数据源名称,配置其他字段并点击 Next。更多的信息请参考《管理和配置指南》的 "Datasource Configuration" 章节。
| |
总是
|
复查您的选择并点击 Next。
| |
总是
|
当安装过程完成时,请点击 Next。
| |
总是
|
处理结束后,请点击 Next。
| |
总是
|
选择是否创建快捷键及如何配置。除了字母和数字外,只允许 '-' 和 '_' 字符。而只有在 Windows 上允许 '/' 和 '\' 字符。然后请点击 Next。
| |
总是
|
如果您想保存所选的安装选项,请点击 Generate installation script and properties file。然后点击 Done。
安装现已完成。
|
安装完成,JBoss EAP 6 已安装在目标主机上。
3.4.3. 卸载 JBoss EAP 6(使用安装程序)
本节详述了卸载用图形化或文本安装程序安装的 JBoss EAP 6 实例的步骤。
过程 3.6. 卸载 JBoss EAP 6(图形化安装程序)
- 在 JBoss EAP 6 的安装过程中会在您安装 JBoss EAP 6 的目录里创建一个名为
Uninstaller
的目录。这个目录包含一个名为uninstaller.jar
的文件。请通过终端窗口进入这个目录。 - 用下列命令启动图形化卸载程序:
java -jar uninstaller.jar
- 执行这个命令将启动下面图表里显示的图形化卸载程序。如果您想删除 JBoss EAP 6 的安装目录,请选择这个复选框。
图 3.1. 用图形化安装程序卸载 JBoss EAP 6
- 按 Uninstall 按钮以启动卸载过程。
- 当卸载程序完成后,按 Quit 按钮退出卸载程序。
- 在成功卸载后,您可能想手动删除启动卸载程序的
Uninstaller
目录。
过程 3.7. 基于文本的卸载过程
- 在控制台里,进入在安装过程中创建的
Uninstaller
目录,它可以在 EAP_HOME 的上一级目录里找到。 - 用下列命令启动基于文本的卸载程序:
java -jar uninstaller.jar -console
- 按照这些步骤来卸载 JBoss EAP 6。
从服务器里卸载了 JBoss EAP 6。
3.5. RPM 安装
3.5.1. 关于 JBoss EAP 6 软件频道
注意
channel
。
3.5.2. JBoss EAP 频道的命名规则
jbappplatform-6-<ARCHITECTURE>-server-6-rpm
。在 x86_64 架构和 Red Hat 企业版 Linux 6 上安装 JBoss EAP 6.3.2 要求订阅 jbappplatform-6-x86_64-server-6-rpm
频道。
jbappplatform-<EAP_VERSION>-<ARCHITECTURE>-server-<RHEL_VERSION>-rpm
。
jb-eap-<EAP_VERSION>-for-rhel-7-server-rpms
(x86_64 架构)及 jb-eap-<EAP_VERSION>-for-rhel-7-for-power-rpms
(ppc64 架构)。
- EAP_VERSION
- 这是 JBoss EAP 的主要和次要版本。EAP_VERSION 值为
6.3
将安装 JBoss EAP 6.3,而6
将安装 JBoss EAP 6。 - ARCHITECTURE
- 它的值为
i386
、x86_64
或ppc
。 - RHEL_VERSION
- 它的值为
5
(Red Hat 企业版 Linux 5)、6
(Red Hat 企业版 Linux 6)7
(Red Hat 企业版 Linux 7)。
3.5.3. 如何订阅 JBoss EAP 6 的 Current 频道
rhn-channel --add -c jbappplatform-6-x86_64-server-6-rpm
subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms
3.5.4. 如何订阅 JBoss EAP 6 的 Minor 频道
rhn-channel --add -c jbappplatform-6.3-x86_64-server-6-rpm
subscription-manager repos --enable=jb-eap-6.3-for-rhel-6-server-rpms
3.5.5. 对修改订阅频道的支持
- 从 Current 频道改为 Minor 频道
- 支持修改为最新的 Minor 频道。
- 从 Minor Current 频道改为其他的 Minor 频道
- 支持改为下一个次要 JBoss EAP 版本。例如,从 JBoss EAP 6.3 改为 JBoss EAP 6.4 是被支持的,但从JBoss EAP 6.3 改为 JBoss EAP 6.5 则不被支持。
- 从 Minor 频道改为 Current 频道
- 支持从最新的 Minor 频道改为 Current 频道。
3.5.6. 如何从 Current 频道改为 Minor 频道
current
频道而您想切换到 minor
频道,请使用这个过程。这样可以确保系统只接收 JBoss EAP 6.3 RPM 的更新且不会更新到以后的版本。
current
频道取消订阅并订阅 minor
频道。
rhn-channel --remove -c jbappplatform-6-x86_64-server-6-rpm
rhn-channel --add -c jbappplatform-6.3-x86_64-server-6-rpm
current
频道取消订阅并订阅 minor
频道。
subscription-manager repos --disable=jb-eap-6-for-rhel-6-server-rpms --enable=jb-eap-6.3-for-rhel-6-server-rpms
3.5.7. 安装 JBoss EAP 6(图形化 RPM 安装)
图形化 RPM 安装方法适用于 Red Hat 企业版 Linux 5 和 6。本节涵盖完成安装所需的步骤。
过程 3.8. 安装 JBoss EAP 6(图形化 RPM 安装)
启动 PackageKit
PackageKit 是一个作为 RHEL 的一部分安装的开源软件包管理软件。您可以选择 System → Administration → Add/Remove Software 在目标主机上启动 PackageKit。- 类型
jboss-eap6
到搜索框里并点击 Find 按钮。您将在结果框里看到 JBoss EAP 6 软件包。 - 选择 JBoss EAP 6 软件包并点击 Apply 按钮。请看下面的图表。
图 3.2. JBoss EAP 6 PackageKit 安装
- 按照余下的步骤在您的目标主机上安装 JBoss EAP 6。
安装完成,JBoss EAP 6 已安装在目标主机上。
3.5.8. 安装 JBoss EAP 6(文本 RPM 安装)
用 RPM 安装 JBoss EAP 6 的方法适用于 Red Hat 企业版 Linux 5 、6 和 7。本节涵盖用命令行完成安装所需的步骤。
过程 3.9. 基于文本的安装步骤
使用 YUM 和 RHN 并安装 RPM 软件包。
您可以使用 YUM 的groupinstall
命令来安装默认的 JBoss EAP 6 组软件包。[user@host ~]$ yum groupinstall jboss-eap6
配置 init 选项。
RPM 安装包含启动服务器的 init 脚本。这个 init 脚本的配置包含在几个其他的文件里。关于这些文件和选项的细节,请参考 第 A.4 节 “JBoss EAP 6 的 PRM 安装配置文件”。
安装完成。默认的 RPM 安装的 EAP_HOME
路径是 /usr/share/jbossas
。关于安装的软件包的完整列表,请参考 第 A.3 节 “JBoss EAP 6 的 PRM 软件包列表”。
3.6. 自动化安装
3.6.1. 安装多个 JBoss EAP 6 实例(使用安装程序)
先决条件
- 用图形化或基于文本的安装程序生成自动化安装脚本:
您可以使用图形化或基于文本的安装程序在安装过程中生成自动化脚本来安装多个相等的 JBoss EAP 6 实例。本节涵盖了使用生成的脚本来安装 JBoss EAP 6 所需的步骤。
过程 3.10. 自动化安装
- 在终端窗口里,运行下列命令通过自动化脚本来安装 JBoss EAP 6:
java -jar jboss-eap-6.x.x-installer.jar
auto.xml
注意
当您使用自动化安装脚本(auto.xml)来进行自动化安装时,安装程序默认会生成输入密码的提示。
通过于自动生成的脚本安装了相等的 JBoss EAP 6 实例。
3.6.2. 从不同的来源使用自动化脚本(auto.xml)来安装 JBoss EAP 6
auto.xml
)而不用管它在哪里运行。因此,安装程序(jboss-eap-6.x.x-installer.jar
)和自动化安装脚本(auto.xml
)可以定位到不同的主机上。本节介绍了从不同网络位置自动安装 JBoss EAP 6.3 的步骤。
- 在终端窗口里,输入下列命令中任意一个来指定自动化脚本(目前位于不同的网络位置)到当前的网络位置:
java -jar
jboss-eap-6.x.x-installer.jar
http://network-host/auto.xml (对于 HTTP)java -jar
jboss-eap-6.x.x-installer.jar
ftp://network-host/auto.xml (对于 FTP)
JBoss EAP 6 已安装在目标主机上。
3.7. 自动化安装方法
3.7.1. 关于自动化安装方法
运行安装程序并用图形化或基于文本的安装程序生成自动化安装脚本:第 3.4.2 节 “运行 JBoss EAP 安装程序”
您可以使用两种方法通过安装程序生成的自动安装脚本自动安装 JBoss EAP 6:
- 第一个方法是在自动安装变量文件里指定自动化安装所需的全部键/密码值
- 第二个方法是在安装期间指定键/密码值
3.7.2. 在自动化安装变量文件里预设置键/密码值来安装 JBoss EAP 6
过程 3.11.
在变量文件里输入键值
JBoss EAP 6 安装程序会创建一个自动化安装脚本以及一个变量文件。这个自动化安装变量文件包含一个自动化安装所需的键/密码参数的列表。要输入键值,您可以打开变量文件,为每个键填写有效的键/密码值。例如:adminPassword = password#2 vault.keystorepwd = vaultkeystorepw ssl.password = user12345
以 variablefile 文件名为参数运行安装程序来开始自动化安装
您可以用auto.xml.variables
参数运行安装程序来开始全自动安装 JBoss EAP 6。这个参数为安装程序提供变量文件的键/密码值(步骤 1)。要开始全自动安装,打开一个终端窗口并输入下列带有相关文件名参数的命令:java -jar
jboss-eap-6.x.x-installer.jar
auto.xml
-variablefileauto.xml.variables
JBoss EAP 6 已安装在目标主机上。
3.7.3. 通过在安装期间指定键值/密码来自动安装 JBoss EAP 6
过程 3.12.
运行带有变量参数的安装程序
您可以运行带有变量参数的安装程序再指定变量列表来初始化自动化安装。这个变量参数将帮助您在安装期间定义变量以及键/密码值。要初始化安装过程,请打开终端窗口并输入下列带有相关文件名参数的命令:java -jar
jboss-eap-6.x.x-installer.jar
auto.xml
-variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345注意
指定变量名称(adminPassword、keystorepwd 和 ssl.password)、不留空值对于安装成功是很重要的。
3.8. 安装 Native 组件和工具
3.8.1. 安装 Native 组件和工具(通过 ZIP 方式和安装程序)
前提条件
- 使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:
- 对 JBoss EAP 6 服务器的管理 CLI 或管理控制台的访问。请参考《管理和配置指南》里的 《登陆管理 CLI》或《登陆管理控制台》。
- 对于 Native 组件
- 在 Red Hat Enterprise Linux 6 / 7 环境里,请确保安装了 Apache Portability Runtime (APR) 和 OpenSSL 库。如果您希望使用 JBoss EAP Native 组件里的 Tomcat Native Library,在安装之前您必须先删除操作系统软件包
tomcatjss
。 - 在 HP-UX 环境里,必须已安装 OpenSSL。
过程 3.13. 下载和安装 Native 组件
- 请从 Red Hat 客户入口下载适合您的操作系统和架构的 Native 组件。您可以在 第 3.3.1 节 “下载 JBoss EAP 6(ZIP 安装)” 里指定的相同位置里下载软件包。
- 在 JBoss EAP 6 安装目录里解压下载的 Native 组件 ZIP 归档文件。您可以检查在
EAP_HOME/modules/system/layers/base/org/jboss/as/web/main/lib/
下是否存在适合您的操作系统和架构的新文件夹来来验证解压是否成功。 - 请用下列管理 CLI 命令为 web 子系统激活 Native 组件:
[standalone@localhost:9999 /]
/subsystem=web:write-attribute(name=native,value=true)
- 重启 JBoss EAP 6 服务器以应用这些修改。
过程 3.14. 下载和安装 Native 工具
- 请从 Red Hat 客户入口下载适合您的操作系统和架构的 Native 工具。您可以在 第 3.3.1 节 “下载 JBoss EAP 6(ZIP 安装)” 里指定的相同位置里下载软件包。
- 在 JBoss EAP 6 安装目录里解压下载的 Native 组件 ZIP 归档文件。您可以检查在
EAP_HOME/modules/system/layers/base/
下是否存在native
目录来验证解压是否成功。 - 请参考 JBoss EAP 文档套件和 Red Hat 客户入口里描述的过程来配置专有的 Native 工具功能。
3.8.2. 安装 Native 组件和工具(通过 RPM 安装)
过程 3.15. 安装 Native 组件和工具
安装 Native 组件和工具
要在 Red Hat 企业版 Linux 5/6/7 里安装 Native 组件和工具(以及依赖关系),请用您的值帐号运行下列命令(用您要安装的 Native 组件替换package_name
):yum install
您可以安装这些 Native 组件:package_name
mod_cluster-native
、mod_jk
、mod_rt
、mod_snmp
、apache-commons-daemon-jsvc-eap6
、httpd
、httpd-devel
、jbossas-hornetq-native
、jbossas-jbossweb-native
。重要
当您运行yum groupinstall jboss-eap6
命令来安装 JBoss EAP 6 软件包组时,默认是会安装 Native 组件jbossas-hornetq-native
和jbossas-jbossweb-native
。如果您已经使用了 第 3.5.7 节 “安装 JBoss EAP 6(图形化 RPM 安装)” 或 第 3.5.8 节 “安装 JBoss EAP 6(文本 RPM 安装)” 进行安装,您不需要再安装jbossas-hornetq-native
和jbossas-jbossweb-native
。注意
使用正确的软件包名来安装专有的 Native 组件是很重要的。软件包名称是区分大小写的。在 Red Hat 企业版 Linux 7 里,httpd
软件包的名称是httpd22
。因此,当您运行yum install
命令在 Red Hat 企业版 Linux 7 里安装 Apache HTTP 服务器时,package_name
httpd
必须用httpd22
替换。重启服务器
重启 JBoss EAP 6 服务器以应用这些修改
3.9. 服务配置
3.9.1. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(RPM 方法)。
前提条件
- 使用 RPM 方法(图形化或基于文本)安装 JBoss EAP 6。
- 要求对服务器有管理员权限。
当安装已通过 RHN(RPM)方法完成时,使用下列步骤在 Red Hat 企业版 Linux 里将 JBoss EAP 6 安装为服务。
过程 3.16. 使用 RPM 方法将 JBoss EAP 安装为 Red Hat 企业版 Linux 里的服务。
安装 JBoss EAP 6
通过 RPM 方法使用上面的预备条件部分里列出的步骤来安装 JBoss EAP 6。启用服务
RPM 安装方法在正确的位置安装必要的服务文件。要设置它为服务,您需要执行下列命令:chkconfig jbossas on
要在域模式下设置为服务,请使用下列命令:chkconfig jbossas-domain on
JBoss EAP 6 会在当 Red Hat 企业版 Linux 进入默认的运行级别时自动启动,且在操作系统完成关闭过程时会自动停止。
3.9.2. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。
先决条件
- 使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:
- 要求对服务器有管理员权限。
当安装已通过 ZIP 方法、图形化界面或基于文本安装程序完成时,使用下列步骤在 Red Hat 企业版 Linux 里将 EAP 6 安装为服务。如果安装是用 RHN(RPM)完成,这个过程不适用。
过程 3.17. 设立服务
注意
jboss-as-domain.sh
替代 jboss-as-standalone.sh
。
找到 start-up 脚本和配置文件
start-up 脚本和相关的配置文件位于EAP_HOME/bin/init.d/
目录。打开配置文件jboss-as.conf
来编辑它。自定义
jboss-as.conf
文件里的 start-up 选项。jboss-as.conf
文件里有几个选项。您最少要指定正确的JBOSS_HOME
和JBOSS_USER
变量的值。如果缺少这些变量,请添加它们。复制文件到系统目录里
- 复制已修改的配置文件到
/etc/jboss-as
目录里。[user@host init.d]$
sudo mkdir /etc/jboss-as
[user@host init.d]$
sudo cp jboss-as.conf /etc/jboss-as
- 复制 start-up 脚本到
/etc/init.d
目录里。[user@host init.d]$
sudo cp jboss-as-standalone.sh /etc/init.d
添加启动脚本为服务。
请使用chkconfig
管理命令添加新的jboss-as-standalone.sh
服务到自动启动服务的列表。[user@host init.d]$
sudo chkconfig --add jboss-as-standalone.sh
启动服务
请使用 Red Hat 企业版 Linux 的下列命令来测试服务是否已正确安装。- 对于 Red Hat 企业版 Linux 5 和 6:
[user@host bin]$
sudo service jboss-as-standalone.sh start
- 对于 Red Hat 企业版 Linux 7:
[user@host bin]$
sudo service jboss-as-standalone start
如果一切正常,您应该看到一个绿色的 [OK]。如果您遇到错误,请检查错误日志并确保配置文件里的路径是正确的。注意
Red Hat 企业版 Linux 7 里不会出现绿色的 [OK]。使服务在服务器重启时自动启动。
要在服务器重启时自动启动的服务列表里添加服务,请使用以下命令:[user@host init.d]$
sudo chkconfig jboss-as-standalone.sh on
JBoss EAP 6 会在当 Red Hat 企业版 Linux 进入默认的运行级别时自动启动,且在操作系统完成关闭过程时会自动停止。
过程 3.18. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(ZIP、安装程序)。
注意
jboss-as-domain.sh
替代 jboss-as-standalone.sh
。
- 如果服务正在运行,请首先打开一个终端窗口并执行
stop
(加上服务的名称)来停止服务:sudo service jboss-as-standalone.sh stop
- 从服务器列表里删除 JBoss EAP:
sudo chkconfig --del jboss-as-standalone.sh
- 删除系统目录文件。
- 删除服务器启动脚本:
sudo rm /etc/init.d/jboss-as-standalone.sh
- 删除服务配置文件:
sudo rm /etc/jboss-as/jboss-as.conf
重要
/etc/jboss-as
不是标准的系统目录。只有目录里没有其他文件时才删除这个目录:sudo rm -rf /etc/jboss-as/
从服务器里卸载了 JBoss EAP 6 服务。
3.9.3. 在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。
先决条件
- 使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:
- 要求对服务器有管理员权限。
- 必须设置
JAVA_HOME
系统环境变量。 - JBoss EAP 6 服务器实例不能正在运行。
重要
set
命令并不能永久地设置环境变量。您必须使用 setx
命令或 Control Panel 里的 System 界面。
使用下列步骤在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务。
过程 3.19. 在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务
创建系统环境变量
创建两个系统环境变量:- 指向 JBoss EAP 6 安装目录的
JBOSS_HOME
NOPAUSE=1
如果还未配置,请下载适合您的系统架构的 Native Utilities 软件包。
如果用于 Windows 服务器的 Native Utilities 软件包没有作为 JBoss EAP 6 的一部分被安装,请从 Red Hat 客户门户 https://access.redhat.com 下载相关的 32 或 64 位软件包,并在 JBoss EAP 6 里解压 Native Utilities ZIP 文件。这会在 JBoss EAP 6 的下列位置创建一个native
目录:EAP_HOME\modules\system\layers\base\
安装服务
打开一个终端窗口并进入EAP_HOME\modules\system\layers\base\native\sbin
您可以用service install
创建新的服务,且可以使用下表里的选项。表 3.3.
service install
选项参数或开关 描述 /startup 指定服务自动启动。如果没有指定,服务将设为手动启动。/controller HOST:PORT 管理接口的主机和端口。如果忽略,默认是localhost:9999
。/host [DOMAIN_HOST] 表示使用域模式,也可选择指定域控制器的名称。如果忽略域控制器的名称,默认值将是master
。/loglevel LEVEL 服务的日志级别,为ERROR
、INFO
、WARN
或DEBUG
。如果忽略,默认值是INFO
。/name SERVICE_NAME 要创建的服务的名称,它不能包含空格。如果忽略,默认值是JBossEAP6
。/desc "DESCRIPTION" 服务的描述。如果忽略,默认值是"JBoss Enterprise Application Platform 6"
。/serviceuser DOMAIN\USERNAME 指定运行服务的帐号名。请使用 DOMAIN\USERNAME 格式。如果忽略,服务将用 Local System 帐号来运行。/servicepass PASSWORD /serviceuser 帐号的密码。/jbossuser USERNAME 可选项,用于 shutdown 命令的 JBoss EAP 6 用户名。/jbosspass PASSWORD /jbossuser 帐号的密码,如果指定了 /jbossuser 它就是必需的。/config XML_FILE 指定要使用的服务器配置。默认值是standalone.xml
或domain.xml
。/hostconfig XML_FILE 指定仅以域模式使用的主机配置。默认值是host.xml
。/base directory 指定服务器/域内容的基础目录的全限定目录。默认值是%JBOSS_HOME%\standalone
或%JBOSS_HOME%\domain
。/logpath path 指定日志文件的路径。当没有指定/logpath
时使用/base
。默认值根据域模式或独立模式分别是:%JBOSS_HOME%\domain\log
或%JBOSS_HOME%\standalone\log
。/debug 以调试模式运行 install 服务。下面是用install
命令在独立或域模式下创建新服务的基本示例。执行下列命令,按需要调整服务的日志级别:- 独立模式:
service.bat install /loglevel INFO
- 域模式:如果对于 JBoss EAP 6 域控制器您没有使用默认的 master,请用正确的主机名或 JBoss EAP 6 域控制的别名来替换 master。
service.bat install /host master /loglevel INFO
名为JBossEAP6
的新 Windows 服务将被创建。在服务控制台里检验这个新的服务
在终端窗口里执行下列命令来打开 Windows 服务控制台:services.msc
如果使用了默认的服务名称,那么在 Windows 服务列表里,这个新服务的名称将是:JBossEAP6
。你可以从服务控制台启动和停止服务,并修改如何启动和何时启动等设置。通过终端窗口启动和停止 JBoss EAP 6 服务
要从终端窗口启动服务,使用下列命令,有需要的话可以修改服务名称:net start JBossEAP6
在终端窗口里使用下列命令停止这个服务,有需要的话可以修改服务名称:net stop JBossEAP6
在 Microsoft Windows 服务器里配置了 JBoss EAP 6 服务。
过程 3.20. 从 Microsoft Windows 服务器卸载 JBoss EAP 6 服务。
- 如果服务正在运行,请首先打开一个终端窗口并执行
net stop
(加上服务的名称)来停止服务:net stop JBossEAP6
打开终端窗口并进入EAP_HOME\modules\system\layers\base\native\sbin
,执行下列命令:service uninstall
已从 Microsoft Windows 服务器里删除了 JBoss EAP 6 服务。
第 4 章 为 JBoss EAP 6 安装补丁和升级
4.1. 关于补丁和升级
4.2. 为 JBoss EAP 6 安装补丁
4.2.1. 关于补丁机制
重要
- 异步更新(Asynchronous update):作为单独的补丁,它在现有产品的常规更新周期之外发布。它可能包含安全补丁、Red Hat 全球支持服务(GSS)提供的用以修复特定问题的其他单独补丁。
- 计划中的更新(Planned update):现有产品的累积补丁,它包括之前为该产品版本开发的所有更新。
重要
EAP_HOME/modules/system/layers/base/.overlays/$PATCH_ID/$MODULE
目录里提取。原来的文件将留在 EAP_HOME/modules/system/layers/base/$MODULE
。补丁机制出于安全原因会将原来的 JAR 文件损坏。这意味着如果您应用了一个更新模块的补丁,模块原来的 JAR 文件将被修改为不可用的。如果补丁回滚,原来的文件将会恢复至可用的状态。这也意味着必须使用正确的回滚过程来回滚任何已应用的补丁。关于正确的回滚过程,请参考 第 4.2.2.3 节 “回滚用补丁管理系统安装 ZIP 形式的补丁”。
4.2.2. 为用 ZIP/安装程序安装的系统安装补丁
4.2.2.1. 补丁管理系统
patch
命令或管理控制台来访问。它无法在整个受管域里自动应用补丁,而只能对其中单独的服务器实例应用补丁。
重要
注意
patch
命令的参数和选项。
表 4.1. patch
命令的参数和开关
参数或开关 | 描述 |
---|---|
apply | 应用补丁。 |
--override-all | 如果有冲突,补丁操作将覆盖任何用户所作的修改。 |
--override-modules | 如果任何已修改的模块有冲突,这将用补丁操作里的内容覆盖这些修改。 |
--override=path(,path) | 只用于指定的杂项文件,它经用补丁操作里的文件覆盖有冲突的已修改的文件。 |
--preserve=path(,path) | 只用于指定的杂项文件,它保存有冲突的已修改的文件。 |
--host=HOST_NAME | 用于受管域服务器,它指定执行 patch 操作的主机。 |
info |
返回当前安装的补丁的信息。
您可以通过
--patch-id=PATCH_ID -v 提供专有补丁(包括 layer/add-on)的详细信息。
|
inspect | 检查下载的补丁文件并返回关于它的重要信息。 |
history | 返回补丁的历史信息。 |
rollback | 回滚应用程序的补丁。 |
--patch-id=PATCH_ID | 要回滚的补丁的 ID,必需的参数。 |
--reset-configuration=TRUE|FALSE | 进行回滚必须设置的选项,它指定是否将回复服务器配置文件作为回滚操作的一部分。 |
--rollback-to | 如果要回滚的补丁时一个单独(一次性)补丁,使用这个参数来指定回滚操作将回滚所有已应用在指定补丁上的其他一次性补丁。 |
4.2.2.2. 用补丁管理系统安装 ZIP 形式的补丁
ZIP 格式的补丁可以用 JBoss EAP 6 补丁管理系统通过管理 CLI 或管理控制台来安装。
重要
先决条件
- 对 Red Hat 客户门户的有效访问和订阅。
- 对以 ZIP 形式安装的 JBoss 产品的当前订阅。
- 更新了对 JBoss EAP 6 服务器的管理 CLI 或管理控制台的访问。关于访问这些界面的说明,请参考《管理和配置指南》里的『登录管理控制台』 或 『启动管理 CLI』 章节。
警告
过程 4.1. 使用管理 CLI 应用 ZIP 补丁到 JBoss EAP 6 服务器实例。
- 从 Red Hat 客户入口 https://access.redhat.com/downloads/ 下载补丁 ZIP 文件。
- 从管理 CLI 里用下列命令并包含合适的路径应用补丁:
[standalone@localhost:9999 /]
patch apply /path/to/downloaded-patch.zip
- 重启 JBoss EAP 6 服务器以使补丁生效:
[standalone@localhost:9999 /]
shutdown --restart=true
过程 4.2. 使用管理控制台应用 ZIP 补丁到 JBoss EAP 6 服务器实例。
- 从 Red Hat 客户入口 https://access.redhat.com/downloads/ 下载补丁 ZIP 文件。
- 在管理控制台里:
- 对于独立服务器:点击屏幕顶部的 Runtime 标签页并点击 Patch Management。
- 对于受管域:点击屏幕顶部的 Domain 标签,从 Host 下拉菜单选择您要打补丁的主机,然后点击 Patch Management。
- 点击 Apply a New Patch。
- 如果您对受管域主机应用补丁,在下一个屏幕请选择是否关闭主机上的服务器,并点击 Next。
- 点击 Browse 按钮,选择已下载的您要应用的补丁,然后点击 Next。
- 如果在试图应用补丁时出现冲突,就会出现警告。点击 View error details 来查看冲突的细节。如果由冲突存在,您可以取消操作或者选择 Override all conflicts 复选框并点击 Next。覆盖冲突会导致补丁的内容覆盖任何用户的修改。
- 在成功应用补丁后,选择是否重启 JBoss EAP 6 服务器以使补丁生效,并点击 Finish。
JBoss EAP 6 服务器实例更新了最新的补丁。
4.2.2.3. 回滚用补丁管理系统安装 ZIP 形式的补丁
JBoss EAP 6 补丁管理系统可以通过管理 CLI 或管理控制台回滚之前应用的 ZIP 补丁。
警告
重要
前提条件
- 之前使用 JBoss EAP 6 补丁管理系统应用的补丁。
- 对 JBoss EAP 6 服务器的管理 CLI 或管理控制台的访问。请参考《管理和配置指南》里的 《登陆管理 CLI》或《登陆管理控制台》。
警告
Reset Configuration
选项的值时请务必小心:
TRUE
,补丁回滚过程也会将 JBoss EAP 6 服务器配置文件回复到应用补丁之前的状态。在应用补丁之后对配置文件的修改都会丢失。
FALSE
,服务器配置文件不会被回滚。在这种情况下,服务器可能在回滚后无法启动,因为补丁可能已经修改了配置文件(如命名空间)而导致它不再有效,您需要手动进行修复。
过程 4.3. 使用管理 CLI 从 JBoss EAP 6 服务器实例回滚补丁
- 在管理 CLI 里,用
patch info
命令来找到要回滚的补丁的 ID。- 对于累积补丁,补丁 ID 是
patch info
输出里的第一个cumulative-patch-id
的值。 - 单独安全补丁或程序错误修复补丁的 ID 会显示为
patch info
输出里的第一个patches
的值,而最近应用的单独补丁将首先列出。
- 在管理 CLI 里,用前面步骤里得到的补丁 ID 来进行回滚。
[standalone@localhost:9999 /]
patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE
- 重启 JBoss EAP 6 服务器以使补丁回滚生效:
[standalone@localhost:9999 /]
shutdown --restart=true
过程 4.4. 使用管理控制台从 JBoss EAP 6 服务器实例回滚补丁
- 在管理控制台里:
- 对于独立服务器:点击屏幕顶部的 Runtime 标签页并点击 Patch Management。
- 对于受管域:点击屏幕顶部的 Domain 标签,从 Host 下拉菜单选择相关的主机,然后点击 Patch Management。
- 在 Recent Patch History 表里,选择您要回滚的补丁,然后点击 Rollback。
- 对于受管域主机,在下一个屏幕请选择是否关闭主机上的服务器,并点击 Next。
- 选择回滚过程中的选项,然后点击 Next。
- 确认选项和要回滚的补丁,然后点击 Next。
- 如果没有指定 Override all 选项,在试图回滚补丁时出现冲突,就会出现警告。点击 View error details 来查看冲突的细节。如果有冲突存在,您可以取消操作或者点击 Choose Options 以及 Override all 复选框再次尝试。覆盖冲突会导致回滚操作覆盖任何用户的修改。
- 在成功回滚补丁后,选择是否重启 JBoss EAP 6 服务器以使修改生效,并点击 Finish。
JBoss EAP 6 服务器实例已回滚了补丁及服务器配置文件(可选)。
4.2.2.4. 清除补丁历史
/core-service=patching:ageout-history
重要
4.2.3. 以 RPM 安装补丁
JBoss 补丁以两种形式发布:ZIP(用于所有产品)和 RPM(用于产品的子集)。本节描述了使用 RPM 形式安装补丁的步骤。
前提条件
- 对 Red Hat 网络的有效订阅。
- 对以 RPM 形式安装的 JBoss 产品的当前订阅。
过程 4.5. 通过 RPM 方式对 JBoss 产品应用补丁
yum
来安装。
警告
- 通过订阅 JBoss Watch 邮件列表或浏览 JBoss Watch 邮件列表归档来获得安全补丁的通知。
- 阅读安全补丁的勘误并确认它可以应用于您的 JBoss 产品。
- 如果安全补丁适用于您的 JBoss 产品,请用这个链接从 Red Hat 客户门户下载包含在勘误里的 PRM 软件包。
- 请使用
来安装补丁。yum update
重要
在更新 RPM 安装时,您的 JBoss 产品将用发布的所有 RPM 补丁进行累积更新。
JBoss 产品用 RPM 软件包方式更新了最新的补丁。
4.2.4. 订阅补丁邮件列表(Patch Mailing List)
Red Hat 的 JBoss 团队维护了一个用于中间件安全通知的邮件列表。本节涵盖订阅这个列表所需的步骤。
前提条件
- 无
过程 4.6. 订阅 JBoss Watch List
- 点击下列链接进入 JBoss Watch 邮件列表页面:JBoss Watch Mailing List。
- 在 Subscribing to Jboss-watch-list 部分输入您的电子邮件地址。
- [您可能也想输入您的名字和密码。这是可选的,但我们不推荐这么做。]
- 点击 Subscribe 按钮启动订阅过程。
- 您可以访问 JBoss Watch Mailing List Archives 来浏览邮件列表的归档。
在确认您的电子邮件账号之后,您将订阅 JBoss 补丁邮件列表来接收安全相关的通知。
4.2.5. JBoss 安全补丁的严重性和影响级别
表 4.2. JBoss 安全补丁的严重性级别
严重性 | 描述 |
---|---|
严重(Critical) |
这个级别是容易被未授权的远程攻击者利用的漏洞,它可能导致系统破解(任意代码执行)而无需用户干预。这些漏洞易受蠕虫病毒利用。要求经验证的远程用户、本地用户或不太可能的配置的漏洞不会被归类于严重(Critical)影响级别。
|
重要(Important) |
这个级别的漏洞可以轻易地破解资源的机密性、完整性或能力。这些漏洞允许本地用户获取权限,允许未验证的远程用户查看本应该被验证保护的资源、执行任意的代码,或者允许本地或远程用户导致服务拒绝问题。
|
中等(Moderate) |
这个级别的漏洞可能更难被利用,但仍然会导致资源的机密性、完整性或能力某种程度的破解。这些漏洞可能产生严重或重要的影响,但根据技术评估,会较不容易被利用或影响不太可能的配置。
|
低(Low) |
其他具有安全性影响的漏洞都归类于这个级别。这些漏洞在不太可能的情况下才会被利用,或者即使被利用也只会造成最小的后果。
|
例 4.1. CVSS v2 影响分数
C:N/I:P/A:C
4.3. 升级 JBoss EAP 6
4.3.1. 升级 JBoss EAP 6 的 ZIP 安装
前提条件
- 确保基本操作系统是最新的。
- 确定在 EAP 6 之后哪些文件已经被修改。
- 备份任何已修改的配置文件、部署和所有的用户数据。
这个过程涵盖了在次要版本(如 JBoss EAP 6.1 到 6.2)间升级 ZIP 安装。关于为专门的次要版本安装补丁,请参考 Patch Installation 章节。升级到最新的 JBoss EAP 6 版本要求进行一些初始的工作来备份现有的安装。
警告
过程 4.7. 升级到最新的 JBoss EAP 6 版本
- 将下载的 ZIP 归档移至想要的位置。我们推荐您使用不同于现有 JBoss EAP 6 安装的位置。
重要
如果您想将最新的 JBoss 6 安装到与现有版本年相同的位置,在安装之前,您需要将现有的安装移至其他位置。这可以防止有改动的配置文件、部署在升级时丢失。 - 解压这个归档。这个步骤将安装一个干净的最新版本的 JBoss EAP 6。
- 复制前一版本里的 EAP_HOME/domain/ 和 EAP_HOME/standalone/ 目录到新版本里。
注意
如果配置文件从旧版的 JBoss EAP 6 复制,新版本里的新功能(如新的子系统)将无法激活。要使用这些功能,将旧的配置文件和新版本进行比较并更新是有必要的。 - 复核前一版本里
bin
目录里的改动,并在新目录里作对应的修改。警告
当前bin
目录里的文件不应该被之前的版本所覆盖。您应该手动进行修改。 - 复核前一版本里其他被修改的文件,并将这些文件移至新版本里。这些文件可能包括:
welcome-content
目录。modules
目录里的自定义模块。bundles
目录里的自定义束。
- 可选的:如果我们之前将 JBoss EAP 6 配置为服务,请先删除现有的服务并配置新的服务来升级。
JBoss EAP 6 ZIP 安装已经成功地升级到了最新的版本。
4.3.2. 升级 JBoss EAP 6 的 PRM 安装
前提条件
- 请确保基础操作系统是最新的,且系统已订阅并启用了基础 OS 频道。
- 请确保启用了正确的 JBoss EAP 6 RHN 频道。例如,在 x86, 64 位架构上,这应该是 JBoss Application Platform (v 6) for 6Server x86_64 channel (
jbappplatform-6-x86_64-server-6-rpm
)。 - 备份任何已修改的配置文件、部署和所有的用户数据。
升级到 EAP 6 的最新版本要求一些准备工作来备份现有的 6.0.0 安装。本主题涵盖了通过 RHN 升级 RPM 安装。
警告
过程 4.8. 升级到最新的 JBoss EAP 6 版本
- 在终端窗口运行下列命令来升级安装:
[user@host] yum update
- 手动合并包含对产品配置文件的修改的
*.rpmnew
文件。
JBoss EAP 6 已成功升级。
4.3.3. 升级 JBoss EAP 群集
先决条件
- 无
JBoss EAP 6 不支持创建由不同版本的 JBoss EAP 服务器组成的群集。系统不支持基于不同版本的混合群集,群集里的所有节点都必须是相同的 6.x 版本。
警告
过程 4.9. 设置 JBoss EAP 群集
- 关于在 6.4 版本里如何设立 JBoss EAP 群集,请参考《JBoss EAP 6.4 管理和配置指南》里的《HTTP 群集和负载平衡》章节。
- 使用《JBoss EAP 6.4 管理和配置指南》里的《在群集间移植流量》章节里的步骤将所有流量移植到新的群集里。
您的 JBoss EAP 6.3 群集已经移植到基于 6.4 的群集。
附录 A. 参考资料
A.1. JBoss EAP 6 的可用下载
表 A.1. 可用的下载
名称 | 描述 | 操作系统 |
---|---|---|
Apache HTTP 服务器 |
适用于每种被支持的操作系统和架构的独立 Apache HTTP 服务器实例。这个 HTTP 服务器已经通过测试和验证,可以和 JBoss EAP 6 一起使用。
|
Red Hat 企业版 Linux 5、 Red Hat 企业版 Linux 6、Microsoft Windows Server 2008、Solaris 10 和 11
|
Native 组件 |
已经针对特定平台进行优化的已编译的组件。例如,DLL 是为 Microsoft Windows Server 环境提供的。在某些情况下,原生组件可以提高性能。
|
Red Hat 企业版 Linux 5、 Red Hat 企业版 Linux 6、Microsoft Windows Server 2008、Solaris 10 和 11、Hewlett-Packard HP-UX
|
Native 工具 |
被支持的操作系统和架构所专有的工具,如脚本和将 JBoss EAP 作为服务安装在操作系统里并生成 SSL 加密密钥和证书的工具。
|
Red Hat 企业版 Linux 5、 Red Hat 企业版 Linux 6、Microsoft Windows Server 2008、Solaris 10 和 11、Hewlett-Packard HP-UX
|
Webserver Connector Natives |
用于 Apache、Microsoft 和 Oracle iPlanet web 服务器和 HTTP 负载平滑和高可用性能力的预编译的模块。这些二进制文件经过了严格测试,可以和 JBoss EAP 6 一起运行。
|
Red Hat 企业版 Linux 5、 Red Hat 企业版 Linux 6、Microsoft Windows Server 2008、Solaris 10 和 11、Hewlett-Packard HP-UX
|
Javadocs |
JBoss EAP 6 开放的所有公共 API 的文档。您可以将其安装在本地的 HTTP 服务器或 IDE 里,您也可以在本地机器上进行查看。
|
平台独立的
|
安装程序 |
JBoss EAP 6 的 Java 图形化安装程序,包含安装 Quickstarts 和 Maven Repository 的步骤。
|
平台独立的
|
Maven 资料库 |
您可以下载 Maven repository 并使其在本地开发环境里可用,它包含 JBoss EAP 6 上构建的应用程序公用的 artifact。Maven Repository 也可通过 JBoss EAP 6 安装程序安装。
|
平台独立的
|
Quickstarts |
帮助您用 JBoss EAP 6 提供的 API 开发 Java EE 应用程序的范例程序。它也可通过 JBoss EAP 6 安装程序安装。
|
平台独立的
|
源代码 |
JBoss EAP 6 的 Java 源代码,您可以在自己的环境里重新编译或进行审计。
|
平台独立的
|
应用程序平台 |
ZIP 格式的安装软件包可以安装和运行任何被支持的平台上。这是安装 JBoss EAP 6 的最常见的方式。
|
平台独立的
|
重要
A.2. JBoss EAP 6 的目录结构
JBoss EAP 6 包含一个相对于之前版本更简化的目录结构。下面是这个目录结构的列表,以及对它们包含的内容的描述。
standalone/
和 domain/
文件夹。
表 A.2. 顶级目录和文件
Name | 目的 |
---|---|
appclient/ | 包含应用程序客户容器的配置细节。 |
bin/ | 包含 Red Hat 企业版 Linux 和微软 Windows 上 JBoss EAP 的启动脚本。 |
bundles/ | 包含和 JBoss EAP 6 内部功能相关的 OSGi Bundle。 |
docs/ | 许可证文件、schema 和示例。 |
domain/ | 配置文件、部署内容和 JBoss EAP 6 以受管域运行时使用的可写入区域。 |
modules/ | 当有服务请求时 JBoss EAP 6 动态加载的模块。 |
standalone/ | 配置文件、部署内容和 JBoss EAP 6 以独立服务器运行时使用的可写入区域。 |
welcome-content/ | 包含默认安装里 8080 端口上的 Welcome 应用程序使用的内容。 |
.installation/ | 包含补丁机制的元数据。这个目录的内容不需要进行修改。 |
jboss-modules.jar
| 加载模块的引导机制。 |
JBossEULA.txt
| 包含许可证协议细节。 |
LICENSE.txt
| 包含许可证细节。 |
version.txt
| 包含版本细节。 |
表 A.3. domain/
里的目录
Name | 目的 |
---|---|
configuration/ | 用于受管域的配置文件。这些文件是通过管理控制台和 CLI 进行修改的,不能直接进行编辑。 |
data/ | 关于已部署服务的信息。服务是用管理控制台或管理 CLI,而不是通过部署扫描器来部署的。因此,请不要手动在这个目录里放入文件。 |
log/ | 包含运行在本地实例上的主机和进程控制器的运行时日志文件。 |
servers/ | 包含某个域里的每个服务器实例的 data/ 、log/ 和 tmp/ 目录,其中包含的数据和顶层的 domain/ 目录的相同目录里的数据类似。 |
tmp/ | 包含临时数据,如针对受管域检验本地用户的管理 CLI 使用的共享密钥机制相关的文件。 |
表 A.4. standalone/
里的目录
Name | 目的 |
---|---|
configuration/ | 用于独立服务器的配置文件。这些文件是通过管理控制台和 CLI 进行修改的,不能直接进行编辑。 |
data/ | 关于已部署服务的信息。服务是用管理控制台或管理 CLI,而不是通过部署扫描器来部署的。因此,请不要手动在这个目录里放入文件。 |
deployments/ | 关于已部署服务的信息。独立服务器包含一个部署扫描器,您可以在这个目录里放入要部署的归档文件。然而,我们推荐的方法是用管理控制台或管理 CLI 来管理部署。 |
lib/ | 附属于独立服务器模式的外部库。默认为空。 |
log/ | 包含运行在本地实例上的主机和进程控制器的运行时日志文件。 |
tmp/ | 包含临时数据,如针对服务器检验本地用户的管理 CLI 使用的共享密钥机制相关的文件。 |
A.3. JBoss EAP 6 的 PRM 软件包列表
JBoss EAP 6 is 是使用 YUM 软件包组 JBoss EAP 6
来安装的。这个组由下列软件包组成。
表 A.5. 软件包列表
软件包 | 描述 |
---|---|
jbossas-appclient | JEE 应用程序客户容器 |
jbossas-bundles | OSGi 束 |
jbossas-core | 核心组件。它是所有配置所必需的。 |
jbossas-domain | 域配置 |
jbossas-hornetq-native | 用于 JBoss AS HornetQ 文件的容器 |
jbossas-jbossweb-native | JBoss 企业级 Web 平台 |
jbossas-modules-eap | JBoss EAP 模块 |
jbossas-product-eap | 产品配置组件。它定制产品的执行。 |
jbossas-standalone | 独立服务器的配置 |
jbossas-welcome-content-eap | 启动信息和控制台页面里使用的欢迎页面内容 |
重要
jbossas-hornetq-native
软件包作为实现高可用性的方法包含在 JBoss EAP 6 里但默认是没有激活的。
A.4. JBoss EAP 6 的 PRM 安装配置文件
JBoss EAP 6 的 PRM 安装配置文件比 ZIP 安装方式多了三个配置文件。服务器的初始脚本使用这些文件来指定应用服务器的启动环境。其中一个文件应用在所有的 JBoss EAP 6 实例上,而另外两个则用于独立和域模式的服务器。
表 A.6. 其他 RPM 配置文件
文件 | 描述 |
---|---|
/etc/jbossas/jbossas.conf | 这个文件将首先被读取并应用到所有的 JBoss EAP 6 实例上。 |
/etc/sysconfig/jbossas | 独立服务器专有的设置。在作为独立服务器运行时,这里指定的值将覆盖 jbossas.conf 里的值。 |
/etc/sysconfig/jbossas-domain | 域模式服务器专有的设置。当作为域模式服务器运行时,这里指定的值将覆盖 jbossas.conf 里的值。 |
表 A.7. RPM 安装配置属性
属性 | 描述 |
---|---|
JBOSS_USER |
运行 JBoss EAP 6 的系统用户帐号。这个用户也具有这些文件的所有权。
默认值:
jboss
|
JBOSS_GROUP |
JBoss EAP 6 文件所属的系统用户组。
默认值:
jboss
|
JBOSS_STARTUP_WAIT |
init 脚本在接到
start 或 restart 命令之后确认服务器已经成功启动前等待的秒数。
默认值:
60
|
JBOSS_SHUTDOWN_WAIT |
init 脚本在接到
start 或 restart 命令之后等待服务器关闭的秒数。
默认值:
20
|
JBOSS_CONSOLE_LOG |
CONSOLE 日志处理程序将重定向的文件。
默认值:
/var/log/jbossas/$JBOSSCONF/console.log
|
JAVA_HOME |
安装 Java 运行环境的目录。
默认值:
/usr/lib/jvm/jre
|
JBOSS_HOME |
安装应用服务器文件的目录。
默认值:
/usr/share/jbossas
|
JAVAPTH |
安装 Java 可执行文件的位置。
默认值:
$JAVA_HOME/bin
|
JBOSSCONF |
以
standalone 或 domain 模式启动这个服务器。
默认值:
standalone 或 domain 。
|
JBOSSSH |
用来启动服务器的脚本。
默认值:
$JBOSS_HOME/bin/$JBOSSCONF.sh
|
JBOSS_SERVER_CONFIG |
要使用的服务器配置文件。
这个属性没有默认值。
standalone.xml 或 domain.xml 可以在启动时定义。
|
JBOSS_HOST_CONFIG | 这个属性允许用户指定主机属性(如 host.xml )。它没有默认值。 |
附录 B. 安装程序截屏
B.8. 套接字绑定设置

图 B.8. JBoss EAP 安装程序的默认套接字绑定

图 B.9. JBoss EAP 安装程序的自定义端口套接字绑定

图 B.10. JBoss EAP 安装程序为默认套接字绑定配置偏移量
B.9. 独立服务器模式的自定义套接字绑定

图 B.11. JBoss EAP 安装程序 Standalone 套接字绑定配置

图 B.12. JBoss EAP 安装程序 HA Standalone 套接字绑定配置

图 B.13. JBoss EAP 安装程序 Full Standalone 套接字绑定配置

图 B.14. JBoss EAP 安装程序 Full HA Standalone 套接字绑定配置
B.10. 域模式的自定义套接字绑定

图 B.15. JBoss EAP 安装程序 Domain Host 套接字绑定配置

图 B.16. JBoss EAP 安装程序 Default Domain 套接字绑定配置

图 B.17. JBoss EAP 安装程序 HA Domain 套接字绑定配置

图 B.18. JBoss EAP 安装程序 Full Domain 套接字绑定配置

图 B.19. JBoss EAP 安装程序 Full HA Domain 套接字绑定配置
B.13. 配置 Runtime 环境

图 B.23. JBoss EAP 安装程序配置 Runtime 环境 - 默认

图 B.24. JBoss EAP 安装程序配置 Runtime 环境 - 高级
附录 C. 修订记录
修订历史 | |||
---|---|---|---|
修订 6.4.0-11 | Tuesday April 14 2015 | Lucas Costi | |
|