87
JBoss 企业级应用程序平台 6.4 安装指南 适用于 Red Hat JBoss 企业版应用程序平台 6 Last Updated: 2017-11-20

JBoss 企业级应用程序平台 6 - Red Hat Customer Portal · JBoss 企业级应用程序平台 6.4 安装指南 适用于 Red Hat JBoss 企业版应用程序平台 6

  • Upload
    others

  • View
    37

  • Download
    0

Embed Size (px)

Citation preview

JBoss 企业级应用程序平台 6.4

安装指南

适用于 Red Hat JBoss 企业版应用程序平台 6

Last Updated: 2017-11-20

JBoss 企业级应用程序平台 6.4 安装指南

适用于 Red Hat JBoss 企业版应用程序平台 6

法律通告法律通告

Copyright © 2015 Red Hat, Inc..

This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0Unported License. If you distribute this document, or a modified version of it, you must provideattribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all RedHat trademarks must be removed.

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, JBoss, OpenShift, Fedora, the Infinitylogo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and othercountries.

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 UnitedStates and/or other countries.

MySQL ® is a registered trademark of MySQL AB in the United States, the European Union andother countries.

Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally relatedto 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 marksor trademarks/service marks of the OpenStack Foundation, in the United States and othercountries 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.

摘要摘要

本书是安装 Red Hat JBoss 企业版应用程序平台 6 及其补丁的指南。

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

目录目录

第第 1 章章 产品概述产品概述1.1. 关于 RED HAT JBOSS 企业版应用程序平台 61.2. JBOSS EAP 6 的功能

第第 2 章章 介绍介绍2.1. 关于 RED HAT 客户门户网站

第第 3 章章 安装说明安装说明3.1. JBOSS EAP 6 的安装方法3.2. JBOSS EAP 6 的安装预备条件3.3. ZIP 安装

3.3.1. 下载 JBoss EAP 6(ZIP 安装)3.3.2. 安装 JBoss EAP 6 的 ZIP 安装文件3.3.3. 卸载 JBoss EAP 6(ZIP 安装)

3.4. 安装程序3.4.1. 下载 JBoss EAP 6 的安装程序3.4.2. 运行 JBoss EAP 安装程序3.4.3. 卸载 JBoss EAP 6(使用安装程序)

3.5. RPM 安装3.5.1. 关于 JBoss EAP 6 软件频道3.5.2. JBoss EAP 频道的命名规则3.5.3. 如何订阅 JBoss EAP 6 的 Current 频道3.5.4. 如何订阅 JBoss EAP 6 的 Minor 频道3.5.5. 对修改订阅频道的支持3.5.6. 如何从 Current 频道改为 Minor 频道3.5.7. 安装 JBoss EAP 6(图形化 RPM 安装)3.5.8. 安装 JBoss EAP 6(文本 RPM 安装)

3.6. 自动化安装3.6.1. 安装多个 JBoss EAP 6 实例(使用安装程序)3.6.2. 从不同的来源使用自动化脚本(auto.xml)来安装 JBoss EAP 6

3.7. 自动化安装方法3.7.1. 关于自动化安装方法3.7.2. 在自动化安装变量文件里预设置键/密码值来安装 JBoss EAP 63.7.3. 通过在安装期间指定键值/密码来自动安装 JBoss EAP 6

3.8. 安装 NATIVE 组件和工具3.8.1. 安装 Native 组件和工具(通过 ZIP 方式和安装程序)3.8.2. 安装 Native 组件和工具(通过 RPM 安装)

3.9. 服务配置3.9.1. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(RPM 方法)。3.9.2. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。3.9.3. 在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级4.1. 关于补丁和升级4.2. 为 JBOSS EAP 6 安装补丁

4.2.1. 关于补丁机制4.2.2. 为用 ZIP/安装程序安装的系统安装补丁

4.2.2.1. 补丁管理系统4.2.2.2. 用补丁管理系统安装 ZIP 形式的补丁4.2.2.3. 回滚用补丁管理系统安装 ZIP 形式的补丁4.2.2.4. 清除补丁历史

4.2.3. 以 RPM 安装补丁

444

66

7778899

10101113141415151516161617181819191919

2020202122222325

29292929303031333535

目录目录

1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.2.4. 订阅补丁邮件列表(Patch Mailing List)4.2.5. JBoss 安全补丁的严重性和影响级别

4.3. 升级 JBOSS EAP 64.3.1. 升级 JBoss EAP 6 的 ZIP 安装4.3.2. 升级 JBoss EAP 6 的 PRM 安装4.3.3. 升级 JBoss EAP 群集

附录附录 A. 参考资料参考资料A.1. JBOSS EAP 6 的可用下载A.2. JBOSS EAP 6 的目录结构A.3. JBOSS EAP 6 的 PRM 软件包列表A.4. JBOSS EAP 6 的 PRM 安装配置文件

附录附录 B. 安装程序截屏安装程序截屏B.1. 语言选择B.2. 最终用户许可证协议B.3. 安装路径B.4. 选择要安装的软件包B.5. 管理性用户创建B.6. QUICKSTART 的安装B.7. MAVEN 资料库设置B.8. 套接字绑定设置B.9. 独立服务器模式的自定义套接字绑定B.10. 域模式的自定义套接字绑定B.11. 服务器启动B.12. 配置日志级别B.13. 配置 RUNTIME 环境B.14. 密码库配置B.15. 配置 SSL 安全性B.16. 配置 LDAPB.17. INFINISPAN 配置B.18. 安全域配置B.19. JDBC 驱动设置B.20. 数据源设置B.21. 复查安装组件B.22. 安装进度B.23. 安装过程完成B.24. 创建快捷方式B.25. 生成安装脚本

附录附录 C. 修订记录修订记录

363738383940

4141424445

47474748495051525356606566687071

72737476767778798081

83

安装指南安装指南

2

目录目录

3

第 1 章 产品概述

1.1. 关于 RED HAT JBOSS 企业版应用程序平台 6

Red Hat JBoss 企业版应用程序平台 6(JBoss EAP 6)s是一个构建在开放标准上并和 Java EE 6 规格兼容的中间件平台。它集成了 JBoss Application Server 7 和高可用性的群集、消息系统、分布式缓存以及其他技术。

JBoss EAP 6 使用了新的模块化结构,允许在有需要时才启用服务,从而提高了启动速度。

管理控制台和管理命令行界面使您不需要再编辑 XML 配置文件并增添了使用脚本和自动化任务的能力。

此外,JBoss EAP 6 包含了 API 和开放框架以用于快速开发安全和可扩充的 Java EE 应用程序。

提交 bug 报告

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 快。

安装指南安装指南

4

第 2 章 介绍

2.1. 关于 RED HAT 客户门户网站

Red Hat 客户门户(Customer Portal)是一个用于 Red Hat 知识和订阅资源的集中式平台。你可以使用Red Hat 客户门户来完成:

管理和维护 Red Hat 权利和支持合约。

下载官方支持的软件。

访问产品文档和 Red Hat 知识库。

联系全球支持服务。

报告 Red Hat 产品的程序错误。

客户门户位于:https://access.redhat.com。

提交 bug 报告

安装指南安装指南

6

第 3 章 安装说明

3.1. JBOSS EAP 6 的安装方法

JBoss EAP 6 有几种不同的安装方法,每个方法都适用于某种情形。本节将概述每种安装方法,并提供到相关具体安装过程的链接。

表表 3.1. 安装方法安装方法

方法方法 描述描述 说明说明

ZIP 安装 ZIP 文件安装方法适用于所有被支持的操作系统。如果您想手动解压,您该使用这个过程。

第 3.3.2 节 “安装 JBossEAP 6 的 ZIP 安装文件”

JAR 安装程序 JAR 安装程序可以运行在控制台或图形化向导里。这两种方式都提供了逐步说明来安装和配置服务器实例。安装程序也可以进行其他的设置,如 Quickstart 和 Maven 资料库。这是在所有被支持的平台上安装 JBoss EAP 6 的首选方法。

第 3.4.2 节 “运行 JBossEAP 安装程序”

RPM 安装 JBoss EAP 6 可以用 RPM 软件包图形化安装程序或命令行界面进行安装。这个方法适合被支持的红帽企业版 Linux 5、6 和 7 的安装。

第 3.5.7 节 “安装 JBossEAP 6(图形化 RPM 安装)”

第 3.5.8 节 “安装 JBossEAP 6(文本 RPM 安装)”

提交 bug 报告

3.2. JBOSS EAP 6 的安装预备条件

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/安装程序的预备条件安装程序的预备条件

安装目录的管理权限。

第第 3 章章 安装说明安装说明

7

确保已安装支持的 Java 开发工具。

在 Microsoft Windows 里,确保设置了 JAVA_HOME 和 PATH 环境变量。

在 Hewlett-Packard HP-UX 里,确保已经安装了unzip 工具。

RPM 的预备条件的预备条件

从 Red Hat 企业版 Linux 7 开始,术语 channel 已替代为 repository。

在 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 资料库。

提交 bug 报告

3.3. ZIP 安装

3.3.1. 下载 JBoss EAP 6(ZIP 安装)

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

概况概况

JBoss EAP 6 Zip 文件可以在 Red Hat 客户入口下载。这个 ZIP 文件是平台独立的。本节涵盖了下载这个归档文件的步骤。

过程过程 3.1. 下载下载 ZIP 文件文件

1. 打开浏览器并登录客户门户: https://access.redhat.com。

2. 点击 Downloads。

3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform。

4. 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。

安装指南安装指南

8

5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x 并点击 Download 选项。

结果结果

JBoss EAP 6 已经成功下载到目标主机,可以开始安装了。

ZIP 安装安装 中的下一步中的下一步

第 3.3.2 节 “安装 JBoss EAP 6 的 ZIP 安装文件”

提交 bug 报告

3.3.2. 安装 JBoss EAP 6 的 ZIP 安装文件

ZIP 安装安装 中的上一步中的上一步

第 3.3.1 节 “下载 JBoss EAP 6(ZIP 安装)”

概述概述

本节涵盖使用下载的 ZIP 文件安装 JBoss EAP 6 的步骤。

过程过程 3.2. 用用 ZIP 文件安装文件安装

1. 将将 ZIP 归档移至到所需的位置。归档移至到所需的位置。将 ZIP 文件移至您计划安装 EAP 6 的服务器和目录。将启动和停止平台的用户必须有这个目录的读和写权限。

2. 使用合适的应用程序以解压使用合适的应用程序以解压 ZIP 归档文件到所选位置。归档文件到所选位置。在 Red Hat 企业版 Linux 环境下,请使用 unzip 工具来解压 ZIP 归档文件。

在 Microsoft Windows 环境里,右击文件并选择 Extract All。

在 Hewlett-Packard HP-UX 环境下,请使用 unzip 工具来解压 ZIP 归档文件。

结果结果

JBoss EAP 6 安装已经成功安装。解压 ZIP 归档创建的目录是服务器的顶层目录,通常被称为 EAP_HOME/。

ZIP 安装安装 中的下一步中的下一步

第 3.3.3 节 “卸载 JBoss EAP 6(ZIP 安装)”

提交 bug 报告

3.3.3. 卸载 JBoss EAP 6(ZIP 安装)

ZIP 安装安装 中的上一步中的上一步

第 3.3.2 节 “安装 JBoss EAP 6 的 ZIP 安装文件”

前提条件前提条件

备份任何已修改的配置文件和在以后实例里可以重用的部署。

第第 3 章章 安装说明安装说明

9

概述概述

本节涵盖卸载 JBoss EAP 6 ZIP 安装所需的步骤。

过程过程 3.3. 卸载卸载 JBoss EAP 6((ZIP 安装)安装)

1. 进入您从 ZIP 文件解压的 JBoss EAP 6 的目录。

2. 删除安装目录。删除安装目录。当您使用 ZIP 安装方法时,JBoss EAP 6 安装在单个目录里。删除这个安装目录以卸载 JBossEAP 6。

3. 可选:删除您创建的任何初始化脚本。可选:删除您创建的任何初始化脚本。如果您创建了初始化脚本或其他依赖于安装在您的机器里的 JBoss EAP 6 的脚本,请删除它们。

结果结果

从服务器里卸载了 JBoss EAP 6。

提交 bug 报告

3.4. 安装程序

3.4.1. 下载 JBoss EAP 6 的安装程序

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

概况概况

JBoss EAP 6 安装程序归档文件可以在 Red Hat 客户入口里下载。.jar 文件可以通过图形化界面或基于文本的安装程序来运行。安装程序是在所有支持的平台上安装 JBoss EAP 6 的首选方法。本节涵盖了下载这个归档文件的步骤。

过程过程 3.4. 下载安装程序下载安装程序

1. 打开浏览器并登录客户门户: https://access.redhat.com。

2. 点击 Downloads。

3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform。

4. 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。

5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x Installer 并点击 Download 选项。

结果结果

JBoss EAP 6 已经成功下载到目标主机,可以开始安装了。

安装程序安装程序 中的下一步中的下一步

第 3.4.3 节 “卸载 JBoss EAP 6(使用安装程序)”

安装指南安装指南

10

提交 bug 报告

3.4.2. 运行 JBoss EAP 安装程序

JBoss EAP 安装程序可以以图形化或文本模式进行。本节介绍以图形模式运行安装程序的命令。

过程过程 3.5. 运行运行 JBoss EAP 安装程序安装程序

1. 打开终端窗口并进入包含安装程序 JAR 文件的目录。

2. 输入下列命令:

java -jar jboss-eap-6.x.x-installer.jar

3. 遵循下表中的说明。

表表 3.2. JBoss EAP 安装程序屏幕安装程序屏幕

屏幕名称屏幕名称 何时出现何时出现 描述描述

第 B.1 节 “语言选择” 总是 选择安装程序的语言并点击 OK。

第 B.2 节 “最终用户许可证协议”

总是 用于 RED HAT JBOSS 中间件的 EULA。

选择 "I accept the terms of this license agreement"并点击 Next。

第 B.3 节 “安装路径” 总是 选择安装路径并点击 Next。系统会提示您创建新的目录,或者是否覆盖已存在的目录。

第 B.4 节 “选择要安装的软件包”

总是 选择要安装的软件包。必需的软件包是禁止取消的。

第 B.5 节 “管理性用户创建”

总是 创建一个管理用户并设置密码。密码必须至少有 8 个字符,其中有一个字母、数字和一个非字母数字符号。然后点击Next。

第 B.6 节 “Quickstart 的安装”

总是 安装 Quickstart 例程。如果您要安装这些例程,请选择 Yes 以及安装路径。如果您不想安装,请选择 No。然后点击 Next。

第 B.7 节 “Maven 资料库设置”

如果您选择安装Quickstart 例程

Quickstart 例程要使用公共的 Maven 资料库。默认的选项会自动配置您的安装来使用这个资料库。这是运行 Quickstart 最容易的途径。如果您愿意,可以指定路径为本地安装的资料库。如果 Maven 设置文件不在默认的位置,也请指定它的路径。

第 B.8 节 “套接字绑定设置”

总是 确定安装过程使用默认的端口绑定、自定义端口绑定还是为默认绑定配置端口偏移量。如果您选择自定义绑定,请选择配置独立模式或域模式的端口,还是两者都配置。如果您选择配置端口偏移量,则选择偏移量配置。然后点击『下一步』。

第第 3 章章 安装说明安装说明

11

第 B.9 节 “独立服务器模式的自定义套接字绑定”

如果您选择在独立模式下配置自定义端口绑定

请根据不同的独立模式配置端口和系统属性,然后点击 Next。

第 B.10 节 “域模式的自定义套接字绑定”

如果您选择在域模式下配置自定义端口绑定

请根据不同的域模式配置端口和系统属性,然后点击 Next。

第 B.11 节 “服务器启动” 总是 选择完成安装过程后的首选启动选项。然后点击 Next。

第 B.12 节 “配置日志级别”

总是 选择 Yes 来配置日志级别,或者 No 跳过这个配置。然后点击 Next。

第 B.13 节 “配置Runtime 环境”

总是 选择 Perform default configuration 来安装默认配置。通过 Perform advanced configuration 从列表里选择高级配置选项。高级选项可以在安装后进行配置。然后点击 Next。

第 B.14 节 “密码库配置” 如果您选择在运行环境的高级配置里安装密码库

配置密码库(Password Vault)用加密的密钥库来存储所有敏感性密码并点击 Next。更多信息请参考《管理和配置指南》里的 "Mask the KeystorePassword and Initialize the Password Vault" 章节。

第 B.15 节 “配置 SSL 安全性”

如果您选择在运行环境的高级配置里启用 SSL 安全性

配置用于保护 EAP 管理接口的 SSL 密钥库。然后点击Next。更多信息请参考《安全指南》里的 "Generatea SSL Encryption Key and Certificate" 章节。

警告警告

Red Hat 推荐您在所有受影响的软件包里显性地禁用 TLSv1.1 或TLSv1.2 上的 SSL。

第 B.16 节 “配置 LDAP” 如果您选择在运行环境的高级配置里启用 LDAP 配置

启用 LDAP 验证以将 LDAP 目录服务器用作管理控制台、管理 CLI 或 API 的验证源。完成后请点击 Next。更多信息请参考《管理和配置指南》里的"Use LDAP to Authenticate to the ManagementInterfaces"。

第 B.17 节 “Infinispan 配置”

如果您选择在运行环境的高级配置里安装Infinispan 缓存

创建一个用于管理缓存数据的 Infinispan 缓存。指定Infinispan 的名称,配置其他字段并点击 Next。更多信息请参考《管理和配置指南》的 "Chapter 14Infinispan" 章节。

第 B.18 节 “安全域配置” 如果您选择在运行环境的高级配置里添加安全域

配置一个安全域将 PicketBox 提供的服务集成到JBoss EAP 实例里。多数字段都已经用默认值进行了填充,您不需要进行修改。完成后请点击 Next。更多信息请参考《管理和配置指南》里的 "SecurityDomains" 章节。

屏幕名称屏幕名称 何时出现何时出现 描述描述

安装指南安装指南

12

第 B.19 节 “JDBC 驱动设置”

如果您选择在运行环境的高级配置里安装 JDBC 驱动

安装和设置 JDBC 驱动来将您的应用程序代码转换为相关的数据库语言。从 "Driver Vendor" 下拉列表里选择合适的驱动。更多的信息请参考《管理和配置指南》里的 "Chapter 6 Datasource Management" 章节。

第 B.20 节 “数据源设置” 如果您选择在运行环境的高级配置里安装数据源

配置应用程序使用的数据源。指定数据源名称,配置其他字段并点击 Next。更多的信息请参考《管理和配置指南》的 "Datasource Configuration" 章节。

第 B.21 节 “复查安装组件”

总是 复查您的选择并点击 Next。

第 B.22 节 “安装进度” 总是 当安装过程完成时,请点击 Next。

第 B.23 节 “安装过程完成”

总是 处理结束后,请点击 Next。

第 B.24 节 “创建快捷方式”

总是 选择是否创建快捷键及如何配置。除了字母和数字外,只允许 '-' 和 '_' 字符。而只有在 Windows 上允许'/' 和 '\' 字符。然后请点击 Next。

第 B.25 节 “生成安装脚本”

总是 如果您想保存所选的安装选项,请点击 Generate installation script and properties file。然后点击 Done。

安装现已完成。

屏幕名称屏幕名称 何时出现何时出现 描述描述

结果结果

安装完成,JBoss EAP 6 已安装在目标主机上。

提交 bug 报告

3.4.3. 卸载 JBoss EAP 6(使用安装程序)

安装程序安装程序 中的上一步中的上一步

第 3.4.1 节 “下载 JBoss EAP 6 的安装程序”

概述概述

本节详述了卸载用图形化或文本安装程序安装的 JBoss EAP 6 实例的步骤。

过程过程 3.6. 卸载卸载 JBoss EAP 6(图形化安装程序)(图形化安装程序)

1. 在 JBoss EAP 6 的安装过程中会在您安装 JBoss EAP 6 的目录里创建一个名为 Uninstaller的目录。这个目录包含一个名为 uninstaller.jar 的文件。请通过终端窗口进入这个目录。

2. 用下列命令启动图形化卸载程序:

java -jar uninstaller.jar

第第 3 章章 安装说明安装说明

13

3. 执行这个命令将启动下面图表里显示的图形化卸载程序。如果您想删除 JBoss EAP 6 的安装目录,请选择这个复选框。

图图 3.1. 用图形化安装程序卸载用图形化安装程序卸载 JBoss EAP 6

4. 按 Uninstall 按钮以启动卸载过程。

5. 当卸载程序完成后,按 Quit 按钮退出卸载程序。

6. 在成功卸载后,您可能想手动删除启动卸载程序的 Uninstaller 目录。

过程过程 3.7. 基于文本的卸载过程基于文本的卸载过程

1. 在控制台里,进入在安装过程中创建的 Uninstaller 目录,它可以在 EAP_HOME 的上一级目录里找到。

2. 用下列命令启动基于文本的卸载程序:

java -jar uninstaller.jar -console

3. 按照这些步骤来卸载 JBoss EAP 6。

结果:结果:

从服务器里卸载了 JBoss EAP 6。

提交 bug 报告

3.5. RPM 安装

3.5.1. 关于 JBoss EAP 6 软件频道

通过 RPM 安装 JBoss EAP 6 要求订阅几个 RHN 软件频道。其中包括 Red Hat Enterprise Linux Server 基础软件频道和专有的 JBoss EAP 6 频道。

注意注意

从 Red Hat 企业版 Linux 7 开始,术语频道(channel)已替代为资料库(repository)。在本书里我们仍使用 channel。

安装指南安装指南

14

到 JBoss EAP 6.3.2 为止,JBoss EAP 频道的选择仅由 Red Hat 企业版 Linux 版本和硬件架构决定。current 频道的订阅提供了最新的 JBoss EAP 版本。

从 JBoss EAP 6.3.2 开始,您可以订阅 current 频道或提供专有次要版本和所有适用补丁的 minor 频道。这允许您保持相同的 JBoss EAP 6 的次要版本,同时仍然应用最新的高严重性和安全性补丁。

提交 bug 报告

3.5.2. JBoss EAP 频道的命名规则

Current 频道命名规则是 jbappplatform-6-<ARCHITECTURE>-server-6-rpm。在 x86_64 架构和Red Hat 企业版 Linux 6 上安装 JBoss EAP 6.3.2 要求订阅 jbappplatform-6-x86_64-server-6-rpm 频道。

Red Hat 企业版 Linux 5 和 6 的次要版本频道命名规则是 jbappplatform-<EAP_VERSION>-<ARCHITECTURE>-server-<RHEL_VERSION>-rpm。

Red Hat 企业版 Linux 7 的次要版本频道命名规则是 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 企业版 Linux7)。

提交 bug 报告

3.5.3. 如何订阅 JBoss EAP 6 的 Current 频道

订阅命令取决于注册方法 - Red Hat Network Classic 或 Red Hat Subscription Manager。

对于 RHN Classic,请输入下列命令:

rhn-channel --add -c jbappplatform-6-x86_64-server-6-rpm

对于 Red Hat Subscription Manager,请输入下列命令:

subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

提交 bug 报告

3.5.4. 如何订阅 JBoss EAP 6 的 Minor 频道

订阅命令取决于注册方法 - Red Hat Network Classic 或 Red Hat Subscription Manager。

第第 3 章章 安装说明安装说明

15

对于 RHN Classic,请输入下列命令:

rhn-channel --add -c jbappplatform-6.3-x86_64-server-6-rpm

对于 Red Hat Subscription Manager,请输入下列命令:

subscription-manager repos --enable=jb-eap-6.3-for-rhel-6-server-rpms

提交 bug 报告

3.5.5. 对修改订阅频道的支持

在 JBoss EAP 6.3.3(或更高版本)的有效期内,您可能希望修改软件订阅的频道。频道改变是被允许的,但有着下列条件限制。

从从 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 频道。

提交 bug 报告

3.5.6. 如何从 Current 频道改为 Minor 频道

如果您的 Red Hat 企业版 Linux 系统订阅了 current 频道而您想切换到 minor 频道,请使用这个过程。这样可以确保系统只接收 JBoss EAP 6.3 RPM 的更新且不会更新到以后的版本。

对于 Red Hat Classic,请输入下列命令从 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

对于 Red Hat Subscription Manager,请输入下列命令从 current 频道取消订阅并订阅 minor 频道。

subscription-manager repos --disable=jb-eap-6-for-rhel-6-server-rpms --enable=jb-eap-6.3-for-rhel-6-server-rpms

提交 bug 报告

3.5.7. 安装 JBoss EAP 6(图形化 RPM 安装)

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

安装指南安装指南

16

介绍介绍

图形化 RPM 安装方法适用于 Red Hat 企业版 Linux 5 和 6。本节涵盖完成安装所需的步骤。

过程过程 3.8. 安装安装 JBoss EAP 6(图形化(图形化 RPM 安装)安装)

使用 PackageKit 在您的目标主机上用图形化方式安装 JBoss EAP 6。

1. 启动启动 PackageKitPackageKit 是一个作为 RHEL 的一部分安装的开源软件包管理软件。您可以选择 System →Administration → Add/Remove Software 在目标主机上启动 PackageKit。

2. 类型

jboss-eap6

到搜索框里并点击 Find 按钮。您将在结果框里看到 JBoss EAP 6 软件包。

3. 选择 JBoss EAP 6 软件包并点击 Apply 按钮。请看下面的图表。

图图 3.2. JBoss EAP 6 PackageKit 安装安装

4. 按照余下的步骤在您的目标主机上安装 JBoss EAP 6。

结果结果

安装完成,JBoss EAP 6 已安装在目标主机上。

提交 bug 报告

3.5.8. 安装 JBoss EAP 6(文本 RPM 安装)

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

概述概述

第第 3 章章 安装说明安装说明

17

用 RPM 安装 JBoss EAP 6 的方法适用于 Red Hat 企业版 Linux 5 、6 和 7。本节涵盖用命令行完成安装所需的步骤。

过程过程 3.9. 基于文本的安装步骤基于文本的安装步骤

通过 RHN 使用 YUM install 访问并安装 RPM 软件包。

1. 使用使用 YUM 和和 RHN 并安装并安装 RPM 软件包。软件包。您可以使用 YUM 的 groupinstall 命令来安装默认的 JBoss EAP 6 组软件包。

[user@host ~]$ yum groupinstall jboss-eap6

2. 配置配置 init 选项。选项。RPM 安装包含启动服务器的 init 脚本。这个 init 脚本的配置包含在几个其他的文件里。关于这些文件和选项的细节,请参考 第 A.4 节 “JBoss EAP 6 的 PRM 安装配置文件”。

结果结果

安装完成。默认的 RPM 安装的 EAP_HOME 路径是 /usr/share/jbossas。关于安装的软件包的完整列表,请参考 第 A.3 节 “JBoss EAP 6 的 PRM 软件包列表”。

提交 bug 报告

3.6. 自动化安装

3.6.1. 安装多个 JBoss EAP 6 实例(使用安装程序)

先决条件先决条件

用图形化或基于文本的安装程序生成自动化安装脚本:

. 第 3.4.2 节 “运行 JBoss EAP 安装程序”

概况概况

您可以使用图形化或基于文本的安装程序在安装过程中生成自动化脚本来安装多个相等的 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 实例。

提交 bug 报告

安装指南安装指南

18

3.6.2. 从不同的来源使用自动化脚本(auto.xml)来安装 JBoss EAP 6

安装程序可以使用任何网络位置上的自动化安装脚本(auto.xml)而不用管它在哪里运行。因此,安装程序(jboss-eap-6.x.x-installer.jar)和自动化安装脚本(auto.xml)可以定位到不同的主机上。本节介绍了从不同网络位置自动安装 JBoss EAP 6.3 的步骤。

在终端窗口里,输入下列命令中任意一个来指定自动化脚本(目前位于不同的网络位置)到当前的网络位置:

结果结果

JBoss EAP 6 已安装在目标主机上。

提交 bug 报告

3.7. 自动化安装方法

3.7.1. 关于自动化安装方法

前提条件前提条件

运行安装程序并用图形化或基于文本的安装程序生成自动化安装脚本:第 3.4.2 节 “运行 JBoss EAP 安装程序”

概述概述

您可以使用两种方法通过安装程序生成的自动安装脚本自动安装 JBoss EAP 6:

第一个方法是在自动安装变量文件里指定自动化安装所需的全部键/密码值

第二个方法是在安装期间指定键/密码值

提交 bug 报告

3.7.2. 在自动化安装变量文件里预设置键/密码值来安装 JBoss EAP 6

在自动化安装变量文件里预设置键/密码值并使用下列过程自动安装 JBoss EAP 6。

过程过程 3.11.

1. 在变量文件里输入键值在变量文件里输入键值JBoss EAP 6 安装程序会创建一个自动化安装脚本以及一个变量文件。这个自动化安装变量文件包含一个自动化安装所需的键/密码参数的列表。要输入键值,您可以打开变量文件,为每个键填写有效的键/密码值。例如:

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)

adminPassword = password#2vault.keystorepwd = vaultkeystorepwssl.password = user12345

第第 3 章章 安装说明安装说明

19

2. 以以 variablefile 文件名为参数运行安装程序来开始自动化安装文件名为参数运行安装程序来开始自动化安装您可以用 auto.xml.variables 参数运行安装程序来开始全自动安装 JBoss EAP 6。这个参数为安装程序提供变量文件的键/密码值(步骤 1)。要开始全自动安装,打开一个终端窗口并输入下列带有相关文件名参数的命令:

结果结果

JBoss EAP 6 已安装在目标主机上。

提交 bug 报告

3.7.3. 通过在安装期间指定键值/密码来自动安装 JBoss EAP 6

通过指定安装时的键值/密码,使用下列过程自动化安装 JBoss EAP 6。

过程过程 3.12.

运行带有变量参数的安装程序运行带有变量参数的安装程序您可以运行带有变量参数的安装程序再指定变量列表来初始化自动化安装。这个变量参数将帮助您在安装期间定义变量以及键/密码值。要初始化安装过程,请打开终端窗口并输入下列带有相关文件名参数的命令:

注意注意

指定变量名称(adminPassword、keystorepwd 和 ssl.password)、不留空值对于安装成功是很重要的。

提交 bug 报告

3.8. 安装 NATIVE 组件和工具

Native 组件是可选的组件,它编译时已针对特定的操作系统和架构进行了优化。在某些情况下,使用Native 组件可能会提高性能。Native 组件包含对 HornetQ (AIO) 和 Tomcat Native Library 的原生支持。详情请参考 第 3.9.2 节 “在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。”和《管理和配置指南》的 Jsvc 章节。

Native 工具是每个被支持的操作系统和架构所专有的可选工具。它包含将 JBoss EAP 6 安装为服务、生成 SSL 加密密钥和证书的脚本和工具。

除了 Native 组件和 Native 工具,我们也将 Webserver Connector Natives 用于负载平衡和群集。关于配置 Webserver Connector Natives 的详情,请参考《管理和配置指南》。

提交 bug 报告

3.8.1. 安装 Native 组件和工具(通过 ZIP 方式和安装程序)

java -jar jboss-eap-6.x.x-installer.jar auto.xml -variablefile auto.xml.variables

java -jar jboss-eap-6.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

安装指南安装指南

20

前提条件前提条件

使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:

第 3.3.2 节 “安装 JBoss EAP 6 的 ZIP 安装文件” .

第 3.4.2 节 “运行 JBoss EAP 安装程序”

对 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 组件组件

1. 请从 Red Hat 客户入口下载适合您的操作系统和架构的 Native 组件。您可以在 第 3.3.1 节 “下载JBoss EAP 6(ZIP 安装)” 里指定的相同位置里下载软件包。

2. 在 JBoss EAP 6 安装目录里解压下载的 Native 组件 ZIP 归档文件。

您可以检查在 EAP_HOME/modules/system/layers/base/org/jboss/as/web/main/lib/ 下是否存在适合您的操作系统和架构的新文件夹来来验证解压是否成功。

3. 请用下列管理 CLI 命令为 web 子系统激活 Native 组件:

[standalone@localhost:9999 /] /subsystem=web:write-attribute(name=native,value=true)

4. 重启 JBoss EAP 6 服务器以应用这些修改。

过程过程 3.14. 下载和安装下载和安装 Native 工具工具

1. 请从 Red Hat 客户入口下载适合您的操作系统和架构的 Native 工具。您可以在 第 3.3.1 节 “下载JBoss EAP 6(ZIP 安装)” 里指定的相同位置里下载软件包。

2. 在 JBoss EAP 6 安装目录里解压下载的 Native 组件 ZIP 归档文件。

您可以检查在 EAP_HOME/modules/system/layers/base/ 下是否存在 native 目录来验证解压是否成功。

3. 请参考 JBoss EAP 文档套件和 Red Hat 客户入口里描述的过程来配置专有的 Native 工具功能。

提交 bug 报告

3.8.2. 安装 Native 组件和工具(通过 RPM 安装)

您只有在使用了 RPM 方法安装了 JBoss EAP 时,您才可以用 RPM 安装方法来安装 Native 组件、工具和所有相应的依赖关系。对于 Red Hat 企业版 Linux 5/6/7 来说,用RPM 软件包来安装 Natives 是合适的选择。本节介绍了用命令行安装 Native 组件和工具的步骤。

第第 3 章章 安装说明安装说明

21

前提条件前提条件

第 3.2 节 “JBoss EAP 6 的安装预备条件”

过程过程 3.15. 安装安装 Native 组件和工具组件和工具

1. 安装安装 Native 组件和工具组件和工具要在 Red Hat 企业版 Linux 5/6/7 里安装 Native 组件和工具(以及依赖关系),请用您的值帐号运行下列命令(用您要安装的 Native 组件替换package_name):

您可以安装这些 Native 组件: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 package_name 命令在 Red Hat 企业版 Linux 7 里安装 Apache HTTP 服务器时,httpd 必须用 httpd22 替换。

2. 重启服务器重启服务器重启 JBoss EAP 6 服务器以应用这些修改

提交 bug 报告

3.9. 服务配置

3.9.1. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(RPM 方法)。

前提条件前提条件

使用 RPM 方法(图形化或基于文本)安装 JBoss EAP 6。

第 3.5.7 节 “安装 JBoss EAP 6(图形化 RPM 安装)”

第 3.5.8 节 “安装 JBoss EAP 6(文本 RPM 安装)”

要求对服务器有管理员权限。

介绍介绍

yum install package_name

安装指南安装指南

22

当安装已通过 RHN(RPM)方法完成时,使用下列步骤在 Red Hat 企业版 Linux 里将 JBoss EAP 6 安装为服务。

过程过程 3.16. 使用使用 RPM 方法将方法将 JBoss EAP 安装为安装为 Red Hat 企业版企业版 Linux 里的服务。里的服务。

1. 安装安装 JBoss EAP 6通过 RPM 方法使用上面的预备条件部分里列出的步骤来安装 JBoss EAP 6。

2. 启用服务启用服务RPM 安装方法在正确的位置安装必要的服务文件。要设置它为服务,您需要执行下列命令:

要在域模式下设置为服务,请使用下列命令:

结果结果

JBoss EAP 6 会在当 Red Hat 企业版 Linux 进入默认的运行级别时自动启动,且在操作系统完成关闭过程时会自动停止。

提交 bug 报告

3.9.2. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。

先决条件先决条件

使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:

第 3.3.2 节 “安装 JBoss EAP 6 的 ZIP 安装文件” .

第 3.4.2 节 “运行 JBoss EAP 安装程序” .

要求对服务器有管理员权限。

概况概况

当安装已通过 ZIP 方法、图形化界面或基于文本安装程序完成时,使用下列步骤在 Red Hat 企业版 Linux里将 EAP 6 安装为服务。如果安装是用 RHN(RPM)完成,这个过程不适用。

过程过程 3.17. 设立服务设立服务

注意注意

下面的步骤描述了在独立模式里以服务方式运行 JBoss EAP 6。为了在域模式下以服务方式运行 JBoss EAP 6,请使用相同的步骤但需要用 jboss-as-domain.sh 替代 jboss-as-standalone.sh。

1. 找到找到 start-up 脚本和配置文件脚本和配置文件start-up 脚本和相关的配置文件位于 EAP_HOME/bin/init.d/ 目录。打开配置文件 jboss-as.conf 来编辑它。

2. 自定义自定义 jboss-as.conf 文件里的文件里的 start-up 选项。选项。

chkconfig jbossas on

chkconfig jbossas-domain on

第第 3 章章 安装说明安装说明

23

jboss-as.conf 文件里有几个选项。您最少要指定正确的 JBOSS_HOME 和 JBOSS_USER 变量的值。如果缺少这些变量,请添加它们。

3. 复制文件到系统目录里复制文件到系统目录里

a. 复制已修改的配置文件到 /etc/jboss-as 目录里。

[user@host init.d]$ sudo mkdir /etc/jboss-as

[user@host init.d]$ sudo cp jboss-as.conf /etc/jboss-as

b. 复制 start-up 脚本到 /etc/init.d 目录里。

[user@host init.d]$ sudo cp jboss-as-standalone.sh /etc/init.d

4. 添加启动脚本为服务。添加启动脚本为服务。请使用 chkconfig 管理命令添加新的 jboss-as-standalone.sh 服务到自动启动服务的列表。

[user@host init.d]$ sudo chkconfig --add jboss-as-standalone.sh

5. 启动服务启动服务请使用 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]。

6. 使服务在服务器重启时自动启动。使服务在服务器重启时自动启动。要在服务器重启时自动启动的服务列表里添加服务,请使用以下命令:

[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、安装程序)。、安装程序)。

安装指南安装指南

24

注意注意

下面的步骤描述了在独立模式里以服务方式卸载 JBoss EAP 6。为了在域模式下以服务方式卸载 JBoss EAP 6,请使用相同的步骤但需要用 jboss-as-domain.sh 替代 jboss-as-standalone.sh。

1. 如果服务正在运行,请首先打开一个终端窗口并执行 stop(加上服务的名称)来停止服务:

sudo service jboss-as-standalone.sh stop

2. 从服务器列表里删除 JBoss EAP:

sudo chkconfig --del jboss-as-standalone.sh

3. 删除系统目录文件。

a. 删除服务器启动脚本:

sudo rm /etc/init.d/jboss-as-standalone.sh

b. 删除服务配置文件:

sudo rm /etc/jboss-as/jboss-as.conf

重要重要

/etc/jboss-as 不是标准的系统目录。只有目录里没有其他文件时才删除这个目录:

sudo rm -rf /etc/jboss-as/

结果结果

从服务器里卸载了 JBoss EAP 6 服务。

提交 bug 报告

3.9.3. 在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务(ZIP、安装程序方法)。

先决条件先决条件

使用 ZIP 方式、图形化或基于文本的安装程序安装 JBoss EAP 6:

第 3.3.2 节 “安装 JBoss EAP 6 的 ZIP 安装文件” .

第 3.4.2 节 “运行 JBoss EAP 安装程序”

要求对服务器有管理员权限。

必须设置 JAVA_HOME 系统环境变量。

第第 3 章章 安装说明安装说明

25

JBoss EAP 6 服务器实例不能正在运行。

重要重要

在设置系统环境变量时,在 Windows 服务器命令行提示下请使用 set 命令并不能永久地设置环境变量。您必须使用 setx 命令或 Control Panel 里的 System 界面。

概况概况

使用下列步骤在 Microsoft Windows 服务器里将 JBoss EAP 配置为服务。

过程过程 3.19. 在在 Microsoft Windows 服务器里将服务器里将 JBoss EAP 配置为服务配置为服务

1. 创建系统环境变量创建系统环境变量创建两个系统环境变量:

指向 JBoss EAP 6 安装目录的 JBOSS_HOME

NOPAUSE=1

2. 如果还未配置,请下载适合您的系统架构的如果还未配置,请下载适合您的系统架构的 Native Utilities 软件包。软件包。如果用于 Windows 服务器的 Native Utilities 软件包没有作为 JBoss EAP 6 的一部分被安装,请从 Red Hat 客户门户 https://access.redhat.com 下载相关的 32 或 64 位软件包,并在 JBossEAP 6 里解压 Native Utilities ZIP 文件。

这会在 JBoss EAP 6 的下列位置创建一个 native 目录:EAP_HOME\modules\system\layers\base\

3. 安装服务安装服务打开一个终端窗口并进入 EAP_HOME\modules\system\layers\base\native\sbin

您可以用 service install 创建新的服务,且可以使用下表里的选项。

表表 3.3. service install 选项选项

参数或开关参数或开关 描述描述

/startup 指定服务自动启动。如果没有指定,服务将设为手动启动。

/controllerHOST:PORT

管理接口的主机和端口。如果忽略,默认是 localhost:9999。

/host[DOMAIN_HOST]

表示使用域模式,也可选择指定域控制器的名称。如果忽略域控制器的名称,默认值将是 master。

/loglevel LEVEL 服务的日志级别,为 ERROR、INFO、WARN 或DEBUG。如果忽略,默认值是 INFO。

/nameSERVICE_NAME

要创建的服务的名称,它不能包含空格。如果忽略,默认值是 JBossEAP6。

安装指南安装指南

26

/desc "DESCRIPTION" 服务的描述。如果忽略,默认值是 "JBoss Enterprise Application Platform 6"。

/serviceuserDOMAIN\USERNAME

指定运行服务的帐号名。请使用 DOMAIN\USERNAME 格式。如果忽略,服务将用 Local System 帐号来运行。

/servicepassPASSWORD

/serviceuser 帐号的密码。

/jbossuserUSERNAME

可选项,用于 shutdown 命令的 JBoss EAP 6 用户名。

/jbosspassPASSWORD

/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,请用正确的主机名或 JBossEAP 6 域控制的别名来替换 master。

service.bat install /host master /loglevel INFO

名为 JBossEAP6 的新 Windows 服务将被创建。

4. 在服务控制台里检验这个新的服务在服务控制台里检验这个新的服务在终端窗口里执行下列命令来打开 Windows 服务控制台:

第第 3 章章 安装说明安装说明

27

services.msc

如果使用了默认的服务名称,那么在 Windows 服务列表里,这个新服务的名称将是:JBossEAP6。你可以从服务控制台启动和停止服务,并修改如何启动和何时启动等设置。

5. 通过终端窗口启动和停止通过终端窗口启动和停止 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 服务。

提交 bug 报告

安装指南安装指南

28

第 4 章 为 JBOSS EAP 6 安装补丁和升级

4.1. 关于补丁和升级

JBoss EAP 6 里的补丁应用于专有的 '次要' 版本的更新,如 JBoss EAP 6.2。补丁可以包含单独或积累的更新。

升级(Upgrading)是移至更新的主要版本(如从 5.0 到 6.0)或更新的次要版本的过程,它是无法通过打补丁来完成的。

还可查看:还可查看:

第 4.2 节 “为 JBoss EAP 6 安装补丁”

第 4.3 节 “升级 JBoss EAP 6 ”

提交 bug 报告

4.2. 为 JBOSS EAP 6 安装补丁

4.2.1. 关于补丁机制

JBoss 产品的补丁以两种形式发布:ZIP(对于所有产品)和 RPM(对于产品的子集)。

重要重要

JBoss 产品必须一直使用同一种补丁方法来更新:ZIP 或 PRM。只有安全性和积累补丁可以通过 RPM 进行,而用 RPM 完成的安装无法用 ZIP 补丁进行更新。

JBoss 补丁可以是异步更新或有计划地更新:

异步更新(Asynchronous update):作为单独的补丁,它在现有产品的常规更新周期之外发布。它可能包含安全补丁、Red Hat 全球支持服务(GSS)提供的用以修复特定问题的其他单独补丁。

计划中的更新(Planned update):现有产品的累积补丁,它包括之前为该产品版本开发的所有更新。

决定是否以计划中更新或异步更新发布补丁取决于要修复的漏洞的严重性。影响低的漏洞通常会推迟到下一个累积补丁或次要版本里解决。而中等或影响更严重的漏洞则通常按照严重性在只包含相应解决方法的异步更新里解决。

JBoss 产品的安全更新是由勘误(ZIP 和 RPM 方法皆可)提供的。勘误封装了要解决的漏洞的列表、严重性级别、受影响的产品、漏洞的文本描述、对补丁的引用。程序错误修复的更新是不通过勘误来通知的。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

29

重要重要

请注意,在应用补丁后,运行时提取的 JAR 将从 EAP_HOME/modules/system/layers/base/.overlays/$PATCH_ID/$MODULE 目录里提取。原来的文件将留在 EAP_HOME/modules/system/layers/base/$MODULE。补丁机制出于安全原因会将原来的 JAR 文件损坏。这意味着如果您应用了一个更新模块的补丁,模块原来的 JAR 文件将被修改为不可用的。如果补丁回滚,原来的文件将会恢复至可用的状态。这也意味着必须使用正确的回滚过程来回滚任何已应用的补丁。关于正确的回滚过程,请参考第 4.2.2.3 节 “回滚用补丁管理系统安装 ZIP 形式的补丁”。

关于 Red Hat 对 JBoss 安全漏洞评级的更多信息,请点击:第 4.2.5 节 “JBoss 安全补丁的严重性和影响级别”

Red Hat 还维护了一个通知订阅者安全漏洞的电子邮件列表。 第 4.2.4 节 “订阅补丁邮件列表(PatchMailing List)”

提交 bug 报告

4.2.2. 为用 ZIP/安装程序安装的系统安装补丁

4.2.2.1. 补丁管理系统补丁管理系统

JBoss EAP 6 补丁管理系统用来将下载的 ZIP 补丁应用到单个 JBoss EAP 6 服务器实例。它可以通过管理 CLI 的 patch 命令或管理控制台来访问。它无法在整个受管域里自动应用补丁,而只能对其中单独的服务器实例应用补丁。

重要重要

用 RPM 方法安装的 JBoss EAP 6 服务器实例无法使用补丁管理系统进行更新。关于更新用 RPM 安装的 JBoss EAP 6 服务器,请参考 第 4.2.3 节 “以 RPM 安装补丁”。

注意注意

补丁管理系统只能用于针对 JBoss EAP 6.2 和更高版本生成的补丁。对于 6.2 版以前的补丁,您应该参考相关版本的文档:https://access.redhat.com/site/documentation/。

除了应用补丁,补丁管理系统可以给出安装的补丁状态的基本信息,并提供立即回滚应用程序补丁的途径。

在应用或回滚补丁时,补丁管理系统将检查它根据用户修改而更新的模块和其他杂项文件。如果检测到用户的修改,且没有指定 conflict-handling 开关,补丁管理系统将中止操作并发出冲突警告。这个警告将包括一个有冲突的模块和其他文件的列表。要完成这个操作,补丁管理系统必须带有指定如何解决冲突的开关来重新运行:要么保留用户的修改,要么进行覆盖。

下表列出了管理 CLI 的 patch 命令的参数和选项。

表表 4.1. patch 命令的参数和开关命令的参数和开关

参数或开关参数或开关 描述描述

apply 应用补丁。

安装指南安装指南

30

--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 如果要回滚的补丁时一个单独(一次性)补丁,使用这个参数来指定回滚操作将回滚所有已应用在指定补丁上的其他一次性补丁。

参数或开关参数或开关 描述描述

提交 bug 报告

4.2.2.2. 用补丁管理系统安装用补丁管理系统安装 ZIP 形式的补丁形式的补丁

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

概况概况

ZIP 格式的补丁可以用 JBoss EAP 6 补丁管理系统通过管理 CLI 或管理控制台来安装。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

31

重要重要

补丁管理系统是 JBoss EAP 6.2 里添加的功能。对于 6.2 之前的版本,安装 ZIP 格式的补丁的过程是不一样的,您可以参考相关版本的文档:https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/。

先决条件先决条件

对 Red Hat 客户门户的有效访问和订阅。

对以 ZIP 形式安装的 JBoss 产品的当前订阅。

更新了对 JBoss EAP 6 服务器的管理 CLI 或管理控制台的访问。关于访问这些界面的说明,请参考《管理和配置指南》里的『登录管理控制台』 或 『启动管理 CLI』 章节。

警告警告

在安装补丁之前,您应该备份 JBoss 产品以及所有自定义的配置文件。

过程过程 4.1. 使用管理使用管理 CLI 应用应用 ZIP 补丁到补丁到 JBoss EAP 6 服务器实例。服务器实例。

1. 从 Red Hat 客户入口 https://access.redhat.com/downloads/ 下载补丁 ZIP 文件。

2. 从管理 CLI 里用下列命令并包含合适的路径应用补丁:

[standalone@localhost:9999 /] patch apply /path/to/downloaded-patch.zip

如果在试图应用补丁时有冲突,patch 工具将显示警告。关于使用 patch 命令开关重新运行命令以解决冲突的信息,请参考 第 4.2.2.1 节 “补丁管理系统”。

3. 重启 JBoss EAP 6 服务器以使补丁生效:

[standalone@localhost:9999 /] shutdown --restart=true

过程过程 4.2. 使用管理控制台应用使用管理控制台应用 ZIP 补丁到补丁到 JBoss EAP 6 服务器实例。服务器实例。

1. 从 Red Hat 客户入口 https://access.redhat.com/downloads/ 下载补丁 ZIP 文件。

2. 在管理控制台里:

对于独立服务器:点击屏幕顶部的 Runtime 标签页并点击 Patch Management。

对于受管域:点击屏幕顶部的 Domain 标签,从 Host 下拉菜单选择您要打补丁的主机,然后点击 Patch Management。

3. 点击 Apply a New Patch。

安装指南安装指南

32

a. 如果您对受管域主机应用补丁,在下一个屏幕请选择是否关闭主机上的服务器,并点击 Next。

4. 点击 Browse 按钮,选择已下载的您要应用的补丁,然后点击 Next。

a. 如果在试图应用补丁时出现冲突,就会出现警告。点击 View error details 来查看冲突的细节。如果由冲突存在,您可以取消操作或者选择 Override all conflicts 复选框并点击 Next。覆盖冲突会导致补丁的内容覆盖任何用户的修改。

5. 在成功应用补丁后,选择是否重启 JBoss EAP 6 服务器以使补丁生效,并点击 Finish。

结果结果

JBoss EAP 6 服务器实例更新了最新的补丁。

提交 bug 报告

4.2.2.3. 回滚用补丁管理系统安装回滚用补丁管理系统安装 ZIP 形式的补丁形式的补丁

介绍介绍

JBoss EAP 6 补丁管理系统可以通过管理 CLI 或管理控制台回滚之前应用的 ZIP 补丁。

警告警告

用补丁管理系统回滚补丁不是用作一个普通的卸载功能。它只是在应用补丁后出现意外后果时立即使用的。

重要重要

补丁管理系统是 JBoss EAP 6.2 里添加的功能。对于 6.2 之前的版本,回滚 ZIP 格式的补丁的过程是不一样的,您可以参考相关版本的文档:https://access.redhat.com/site/documentation/。

前提条件前提条件

之前使用 JBoss EAP 6 补丁管理系统应用的补丁。

对 JBoss EAP 6 服务器的管理 CLI 或管理控制台的访问。请参考《管理和配置指南》里的 《登陆管理 CLI》或《登陆管理控制台》。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

33

警告警告

在指定 Reset Configuration 选项的值时请务必小心:

如果设置为 TRUE,补丁回滚过程也会将 JBoss EAP 6 服务器配置文件回复到应用补丁之前的状态。在应用补丁之后对配置文件的修改都会丢失。

如果为 FALSE,服务器配置文件不会被回滚。在这种情况下,服务器可能在回滚后无法启动,因为补丁可能已经修改了配置文件(如命名空间)而导致它不再有效,您需要手动进行修复。

过程过程 4.3. 使用管理使用管理 CLI 从从 JBoss EAP 6 服务器实例回滚补丁服务器实例回滚补丁

1. 在管理 CLI 里,用 patch info 命令来找到要回滚的补丁的 ID。

对于累积补丁,补丁 ID 是 patch info 输出里的第一个 cumulative-patch-id 的值。

单独安全补丁或程序错误修复补丁的 ID 会显示为 patch info 输出里的第一个 patches 的值,而最近应用的单独补丁将首先列出。

2. 在管理 CLI 里,用前面步骤里得到的补丁 ID 来进行回滚。

[standalone@localhost:9999 /] patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE

如果在试图回滚补丁时有冲突,patch 工具将显示警告。关于使用 patch 命令开关重新运行命令以解决冲突的信息,请参考 第 4.2.2.1 节 “补丁管理系统”。

3. 重启 JBoss EAP 6 服务器以使补丁回滚生效:

[standalone@localhost:9999 /] shutdown --restart=true

过程过程 4.4. 使用管理控制台从使用管理控制台从 JBoss EAP 6 服务器实例回滚补丁服务器实例回滚补丁

1. 在管理控制台里:

对于独立服务器:点击屏幕顶部的 Runtime 标签页并点击 Patch Management。

对于受管域:点击屏幕顶部的 Domain 标签,从 Host 下拉菜单选择相关的主机,然后点击 Patch Management。

2. 在 Recent Patch History 表里,选择您要回滚的补丁,然后点击 Rollback。

a. 对于受管域主机,在下一个屏幕请选择是否关闭主机上的服务器,并点击 Next。

3. 选择回滚过程中的选项,然后点击 Next。

4. 确认选项和要回滚的补丁,然后点击 Next。

a. 如果没有指定 Override all 选项,在试图回滚补丁时出现冲突,就会出现警告。点击

安装指南安装指南

34

View error details 来查看冲突的细节。如果有冲突存在,您可以取消操作或者点击 Choose Options 以及 Override all 复选框再次尝试。覆盖冲突会导致回滚操作覆盖任何用户的修改。

5. 在成功回滚补丁后,选择是否重启 JBoss EAP 6 服务器以使修改生效,并点击 Finish。

结果结果

JBoss EAP 6 服务器实例已回滚了补丁及服务器配置文件(可选)。

提交 bug 报告

4.2.2.4. 清除补丁历史清除补丁历史

当在 JBoss EAP 6 服务器里应用补丁时,补丁的内容和历史将被保留以用于以后的回滚操作。如果应用了多个累计补丁,补丁历史可能占用大量的磁盘空间。

您可以使用下面的管理 CLI 命令来删除所有目前没使用的旧补丁。在使用这些命令时,只有 GA 版本附带的最新累计补丁会保留。如果已经应用了多个累计补丁,这只能用于清理磁盘空间。

/core-service=patching:ageout-history

重要重要

如果您清除了补丁历史,您将无法回滚之前应用的补丁。

提交 bug 报告

4.2.3. 以 RPM 安装补丁

前提条件:前提条件:

第 3.2 节 “JBoss EAP 6 的安装预备条件”

介绍介绍

JBoss 补丁以两种形式发布:ZIP(用于所有产品)和 RPM(用于产品的子集)。本节描述了使用 RPM形式安装补丁的步骤。

前提条件前提条件

对 Red Hat 网络的有效订阅。

对以 RPM 形式安装的 JBoss 产品的当前订阅。

过程过程 4.5. 通过通过 RPM 方式对方式对 JBoss 产品应用补丁产品应用补丁

JBoss 产品的安全更新是由勘误(ZIP 和 RPM 方法皆可)提供的。勘误封装了要解决的漏洞的列表、严重性级别、受影响的产品、漏洞的文本描述、对补丁的引用。

对于 JBoss 产品的 RPM 发行版本,勘误包含了对要更新的 RPM 软件包的引用。这个补丁可以通过 yum来安装。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

35

警告警告

在安装补丁以前,您必需备份您的 JBoss 产品以及所有自定义的配置文件。

1. 通过订阅 JBoss Watch 邮件列表或浏览 JBoss Watch 邮件列表归档来获得安全补丁的通知。

2. 阅读安全补丁的勘误并确认它可以应用于您的 JBoss 产品。

3. 如果安全补丁适用于您的 JBoss 产品,请用这个链接从 Red Hat 客户门户下载包含在勘误里的PRM 软件包。

4. 请使用

yum update

来安装补丁。

重要重要

在更新 RPM 安装时,您的 JBoss 产品将用发布的所有 RPM 补丁进行累积更新。

结果结果

JBoss 产品用 RPM 软件包方式更新了最新的补丁。

提交 bug 报告

4.2.4. 订阅补丁邮件列表(Patch Mailing List)

介绍介绍

Red Hat 的 JBoss 团队维护了一个用于中间件安全通知的邮件列表。本节涵盖订阅这个列表所需的步骤。

前提条件前提条件

过程过程 4.6. 订阅订阅 JBoss Watch List

1. 点击下列链接进入 JBoss Watch 邮件列表页面:JBoss Watch Mailing List。

2. 在 Subscribing to Jboss-watch-list 部分输入您的电子邮件地址。

3. [您可能也想输入您的名字和密码。这是可选的,但我们不推荐这么做。]

4. 点击 Subscribe 按钮启动订阅过程。

5. 您可以访问 JBoss Watch Mailing List Archives 来浏览邮件列表的归档。

结果结果

安装指南安装指南

36

在确认您的电子邮件账号之后,您将订阅 JBoss 补丁邮件列表来接收安全相关的通知。

提交 bug 报告

4.2.5. JBoss 安全补丁的严重性和影响级别

为了评估每个 JBoss 安全性漏洞的风险, Red Hat 使用四个安全级别,分别为低(Low)、中等(Moderate)、重要(Important)、严重(Critical),以及通用缺陷评估系统(Common VulnerabilityScoring System,CVSS)v2 来确定漏洞产生的影响。

表表 4.2. JBoss 安全补丁的严重性级别安全补丁的严重性级别

严重性严重性 描述描述

严重(Critical) 这个级别是容易被未授权的远程攻击者利用的漏洞,它可能导致系统破解(任意代码执行)而无需用户干预。这些漏洞易受蠕虫病毒利用。要求经验证的远程用户、本地用户或不太可能的配置的漏洞不会被归类于严重(Critical)影响级别。

重要(Important) 这个级别的漏洞可以轻易地破解资源的机密性、完整性或能力。这些漏洞允许本地用户获取权限,允许未验证的远程用户查看本应该被验证保护的资源、执行任意的代码,或者允许本地或远程用户导致服务拒绝问题。

中等(Moderate) 这个级别的漏洞可能更难被利用,但仍然会导致资源的机密性、完整性或能力某种程度的破解。这些漏洞可能产生严重或重要的影响,但根据技术评估,会较不容易被利用或影响不太可能的配置。

低(Low) 其他具有安全性影响的漏洞都归类于这个级别。这些漏洞在不太可能的情况下才会被利用,或者即使被利用也只会造成最小的后果。

CVSS v2 分数的影响构成基于对三个潜在影响的联合评估:Confidentiality (C)、Integrity (I) 和Availability (A)。每种影响都评级为:None (N)、Partial (P) 或 Complete (C)。

因为 JBoss 服务器进程是以无特权的用户运行的,且和主机操作系统是隔离的,JBoss 安全漏洞只会被评级为 None(N) 或 Partial (P)。

例例 4.1. CVSS v2 影响分数影响分数

下面的例子展示了一个 CVSS v2 影响分数,对漏洞的利用不会影响系统的保密性(confidentiality),部分影响系统完整性(integrity),而完全影响系统的可用性(availability)(也就是说,系统将完全无法使用,例如内核崩溃)。

C:N/I:P/A:C

综合安全性评级和 CVSS 分数,机构可以根据漏洞对每个环境产生的风险来作出决定,并相应地安排系统升级。

关于 CVSS2 的更多信息,请参考:CVSS2 Guide。

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

37

提交 bug 报告

4.3. 升级 JBOSS EAP 6

4.3.1. 升级 JBoss EAP 6 的 ZIP 安装

前提条件前提条件

确保基本操作系统是最新的。

确定在 EAP 6 之后哪些文件已经被修改。

备份任何已修改的配置文件、部署和所有的用户数据。

第 3.3.1 节 “下载 JBoss EAP 6(ZIP 安装)” .

概述概述

这个过程涵盖了在次要版本(如 JBoss EAP 6.1 到 6.2)间升级 ZIP 安装。关于为专门的次要版本安装补丁,请参考 Patch Installation 章节。升级到最新的 JBoss EAP 6 版本要求进行一些初始的工作来备份现有的安装。

警告警告

对于受管域,在升级每个主机控制器之前,您应该先升级主主机控制器(或域控制器)实例。

过程过程 4.7. 升级到最新的升级到最新的 JBoss EAP 6 版本版本

1. 将下载的 ZIP 归档移至想要的位置。我们推荐您使用不同于现有 JBoss EAP 6 安装的位置。

重要重要

如果您想将最新的 JBoss 6 安装到与现有版本年相同的位置,在安装之前,您需要将现有的安装移至其他位置。这可以防止有改动的配置文件、部署在升级时丢失。

2. 解压这个归档。这个步骤将安装一个干净的最新版本的 JBoss EAP 6。

3. 复制前一版本里的 EAP_HOME/domain/ 和 EAP_HOME/standalone/ 目录到新版本里。

注意注意

如果配置文件从旧版的 JBoss EAP 6 复制,新版本里的新功能(如新的子系统)将无法激活。要使用这些功能,将旧的配置文件和新版本进行比较并更新是有必要的。

4. 复核前一版本里 bin 目录里的改动,并在新目录里作对应的修改。

安装指南安装指南

38

警告警告

当前 bin 目录里的文件不应该被之前的版本所覆盖。您应该手动进行修改。

5. 复核前一版本里其他被修改的文件,并将这些文件移至新版本里。这些文件可能包括:

welcome-content 目录。

modules 目录里的自定义模块。

bundles 目录里的自定义束。

6. 可选的:可选的:如果我们之前将 JBoss EAP 6 配置为服务,请先删除现有的服务并配置新的服务来升级。

结果结果

JBoss EAP 6 ZIP 安装已经成功地升级到了最新的版本。

提交 bug 报告

4.3.2. 升级 JBoss EAP 6 的 PRM 安装

前提条件前提条件

请确保基础操作系统是最新的,且系统已订阅并启用了基础 OS 频道。

请确保启用了正确的 JBoss EAP 6 RHN 频道。例如,在 x86, 64 位架构上,这应该是 JBossApplication 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 版本版本

1. 在终端窗口运行下列命令来升级安装:

第第 4 章章 为为 JBOSS EAP 6 安装补丁和升级安装补丁和升级

39

[user@host] yum update

2. 手动合并包含对产品配置文件的修改的 *.rpmnew 文件。

结果结果

JBoss EAP 6 已成功升级。

提交 bug 报告

4.3.3. 升级 JBoss EAP 群集

先决条件先决条件

概况概况

JBoss EAP 6 不支持创建由不同版本的 JBoss EAP 服务器组成的群集。系统不支持基于不同版本的混合群集,群集里的所有节点都必须是相同的 6.x 版本。

警告警告

将 6.3 群集的流量移植到 6.4 群集的升级过程需要传输所有的流量到 6.4 群集然后关闭 6.3 群集里的服务器或节点。

过程过程 4.9. 设置设置 JBoss EAP 群集群集

1. 关于在 6.4 版本里如何设立 JBoss EAP 群集,请参考《JBoss EAP 6.4 管理和配置指南》里的《HTTP 群集和负载平衡》章节。

2. 使用《JBoss EAP 6.4 管理和配置指南》里的《在群集间移植流量》章节里的步骤将所有流量移植到新的群集里。

结果结果

您的 JBoss EAP 6.3 群集已经移植到基于 6.4 的群集。

提交 bug 报告

安装指南安装指南

40

附录 A. 参考资料

A.1. JBOSS EAP 6 的可用下载

JBoss EAP 6 包含了大量的安装类型和可选组件,它们可以在 Red Hat 的 Customer Portalhttps://access.redhat.com/ 里下载。下表解释了不同的选项。一些组件只适用于某些操作系统或架构,因此只可用于特定的系统版本。

表表 A.1. 可用的下载可用的下载

名称名称 描述描述 操作系统操作系统

Apache HTTP 服务器 适用于每种被支持的操作系统和架构的独立 Apache HTTP 服务器实例。这个 HTTP 服务器已经通过测试和验证,可以和 JBoss EAP 6 一起使用。

Red Hat 企业版 Linux 5、 Red Hat企业版 Linux 6、MicrosoftWindows Server 2008、Solaris10 和 11

Native 组件 已经针对特定平台进行优化的已编译的组件。例如,DLL 是为Microsoft Windows Server 环境提供的。在某些情况下,原生组件可以提高性能。

Red Hat 企业版 Linux 5、 Red Hat企业版 Linux 6、MicrosoftWindows Server 2008、Solaris10 和 11、Hewlett-Packard HP-UX

Native 工具 被支持的操作系统和架构所专有的工具,如脚本和将 JBoss EAP 作为服务安装在操作系统里并生成SSL 加密密钥和证书的工具。

Red Hat 企业版 Linux 5、 Red Hat企业版 Linux 6、MicrosoftWindows Server 2008、Solaris10 和 11、Hewlett-Packard HP-UX

Webserver Connector Natives 用于 Apache、Microsoft 和Oracle iPlanet web 服务器和HTTP 负载平滑和高可用性能力的预编译的模块。这些二进制文件经过了严格测试,可以和 JBoss EAP6 一起运行。

Red Hat 企业版 Linux 5、 Red Hat企业版 Linux 6、MicrosoftWindows Server 2008、Solaris10 和 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。MavenRepository 也可通过 JBoss EAP 6安装程序安装。

平台独立的

Quickstarts 帮助您用 JBoss EAP 6 提供的 API开发 Java EE 应用程序的范例程序。它也可通过 JBoss EAP 6 安装程序安装。

平台独立的

附录附录 A. 参考资料参考资料

41

源代码 JBoss EAP 6 的 Java 源代码,您可以在自己的环境里重新编译或进行审计。

平台独立的

应用程序平台 ZIP 格式的安装软件包可以安装和运行任何被支持的平台上。这是安装 JBoss EAP 6 的最常见的方式。

平台独立的

名称名称 描述描述 操作系统操作系统

重要重要

RPM 安装方式的下载在 Customer Portal 上没有,但它可以通过 RHN 进行。

提交 bug 报告

A.2. JBOSS EAP 6 的目录结构

概况概况

JBoss EAP 6 包含一个相对于之前版本更简化的目录结构。下面是这个目录结构的列表,以及对它们包含的内容的描述。

它也包含 standalone/ 和 domain/ 文件夹。

表表 A.2. 顶级目录和文件顶级目录和文件

Name 目的目的

appclient/ 包含应用程序客户容器的配置细节。

bin/ 包含 Red Hat 企业版 Linux 和微软 Windows 上 JBossEAP 的启动脚本。

bundles/ 包含和 JBoss EAP 6 内部功能相关的 OSGi Bundle。

docs/ 许可证文件、schema 和示例。

domain/ 配置文件、部署内容和 JBoss EAP 6 以受管域运行时使用的可写入区域。

modules/ 当有服务请求时 JBoss EAP 6 动态加载的模块。

standalone/ 配置文件、部署内容和 JBoss EAP 6 以独立服务器运行时使用的可写入区域。

welcome-content/ 包含默认安装里 8080 端口上的 Welcome 应用程序使用的内容。

安装指南安装指南

42

.installation/ 包含补丁机制的元数据。这个目录的内容不需要进行修改。

jboss-modules.jar 加载模块的引导机制。

JBossEULA.txt 包含许可证协议细节。

LICENSE.txt 包含许可证细节。

version.txt 包含版本细节。

Name 目的目的

表表 A.3. domain/ 里的目录里的目录

Name 目的目的

configuration/ 用于受管域的配置文件。这些文件是通过管理控制台和 CLI 进行修改的,不能直接进行编辑。

data/ 关于已部署服务的信息。服务是用管理控制台或管理CLI,而不是通过部署扫描器来部署的。因此,请不要手动在这个目录里放入文件。

log/ 包含运行在本地实例上的主机和进程控制器的运行时日志文件。

servers/ 包含某个域里的每个服务器实例的 data/、log/ 和 tmp/ 目录,其中包含的数据和顶层的 domain/ 目录的相同目录里的数据类似。

tmp/ 包含临时数据,如针对受管域检验本地用户的管理CLI 使用的共享密钥机制相关的文件。

表表 A.4. standalone/ 里的目录里的目录

Name 目的目的

configuration/ 用于独立服务器的配置文件。这些文件是通过管理控制台和 CLI 进行修改的,不能直接进行编辑。

data/ 关于已部署服务的信息。服务是用管理控制台或管理CLI,而不是通过部署扫描器来部署的。因此,请不要手动在这个目录里放入文件。

附录附录 A. 参考资料参考资料

43

deployments/ 关于已部署服务的信息。独立服务器包含一个部署扫描器,您可以在这个目录里放入要部署的归档文件。然而,我们推荐的方法是用管理控制台或管理 CLI 来管理部署。

lib/ 附属于独立服务器模式的外部库。默认为空。

log/ 包含运行在本地实例上的主机和进程控制器的运行时日志文件。

tmp/ 包含临时数据,如针对服务器检验本地用户的管理CLI 使用的共享密钥机制相关的文件。

Name 目的目的

提交 bug 报告

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 启动信息和控制台页面里使用的欢迎页面内容

安装指南安装指南

44

重要重要

jbossas-hornetq-native 软件包作为实现高可用性的方法包含在 JBoss EAP 6 里但默认是没有激活的。

提交 bug 报告

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

附录附录 A. 参考资料参考资料

45

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)。它没有默认值。

属性属性 描述描述

提交 bug 报告

安装指南安装指南

46

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

安装指南安装指南

54

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

附录附录 B. 安装程序截屏安装程序截屏

55

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

附录附录 B. 安装程序截屏安装程序截屏

57

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

安装指南安装指南

58

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

附录附录 B. 安装程序截屏安装程序截屏

59

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

附录附录 B. 安装程序截屏安装程序截屏

61

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

安装指南安装指南

62

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

附录附录 B. 安装程序截屏安装程序截屏

63

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

安装指南安装指南

64

图图 B.21. JBoss EAP 安装程序跳过了日志级别的配置安装程序跳过了日志级别的配置

附录附录 B. 安装程序截屏安装程序截屏

67

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

附录附录 B. 安装程序截屏安装程序截屏

69

附录附录 B. 安装程序截屏安装程序截屏

75

附录 C. 修订记录

修订修订 6.4.0-11 Tuesday April 14 2015 Lucas CostiRed Hat JBoss 企业级应用程序平台 6.4.0.GA

附录附录 C. 修订记录修订记录

83