安装指南

过程 4.1. 下载 ZIP 文件

1. 登录 https://access.redhat.com。
2. 选择 Downloads → JBoss Enterprise Middleware → Downloads 菜单选项。
3. 从 Product 下拉菜单选择 Application Platform。
4. 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。
5. 点击 Application Platform 6.1.0 选项后面的 Download。

过程 4.2. ZIP 文件安装

1. 将 ZIP 归档移至到所需的位置。

   将 ZIP 文件移至你想安装 EAP 6 的服务器和目录。将启动和停止平台的用户必须有这个目录的读和写权限。

2. 使用合适的应用程序以解压 ZIP 归档文件到所选位置。

   在红帽企业版 Linux 环境下，请使用 unzip 工具来解压 ZIP 归档文件。
   在 Microsoft Windows 环境里，右击文件并选择 Extract All。
   在 Hewlett-Packard HP-UX 环境下，请使用 unzip 工具来解压 ZIP 归档文件。

过程 4.3. 卸载 JBoss EAP 6（ZIP 安装）

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

2. 删除安装目录。

   当你使用 ZIP 安装方法时，JBoss EAP 6 安装在单个目录里。删除这个安装目录以卸载 JBoss EAP 6。

3. 可选：删除你创建的任何初始化脚本。

   如果你创建了初始化脚本或其他依赖于安装在你的机器里的 JBoss EAP 6 的脚本，请删除它们。

过程 4.4. 下载安装程序

1. 登录 https://access.redhat.com。
2. 选择 Downloads → JBoss Enterprise Middleware → Downloads 菜单选项。
   

   View larger image

   

   图 4.1. 

3. 在下一屏里从 Product 下拉菜单选择 Application Platform。
4. 选择 Application Platform 6.1.0 Installer。
5. 点击 Download.

过程 4.5. 启动安装程序

1. 运行下列命令来启动安装过程：

   • 图形模式

     java -jar jboss-eap-6.1.1.ER4-installer.jar

     Copy to Clipboard Toggle word wrap

   • 文本模式

     java -jar jboss-eap-6.1.1.ER4-installer.jar -console

     Copy to Clipboard Toggle word wrap
2. 按照屏幕提示进行安装。

过程 4.6. 卸载 JBoss EAP 6（图形化安装程序）

1. 在 JBoss EAP 6 的安装过程中会在你安装 JBoss EAP 6 的目录里创建一个名为 Uninstaller 的目录。这个目录包含一个名为 uninstaller.jar 的文件。请通过终端窗口进入这个目录。
2. 用下列命令启动图形化卸载程序：

   java -jar uninstaller.jar

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

   View larger image

   

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

4. 按 Uninstall 按钮以启动卸载过程。
5. 当卸载程序完成后，按 Quit 按钮退出卸载程序。
6. 在成功卸载后，你可能想手动删除启动卸载程序的 Uninstaller 目录。

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

1. 在控制台里，进入在安装过程中创建的 Uninstaller 目录，它可以在 EAP_HOME 的上一级目录里找到。
2. 用下列命令启动基于文本的卸载程序：

   java -jar uninstaller.jar -console

   Copy to Clipboard Toggle word wrap
3. 按照这些步骤来卸载 JBoss EAP 6。

过程 4.8. 安装 JBoss EAP 6（图形化 RPM 安装）

1. 启动 PackageKit

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

   jboss-eap6

   Copy to Clipboard Toggle word wrap

   到搜索框里并点击 Find 按钮。你将在结果框里看到 JBoss EAP 6 软件包。
3. 选择 JBoss EAP 6 软件包并点击 Apply 按钮。请看下面的图表。
   

   View larger image

   

   图 4.3. JBoss EAP 6 PackageKit 安装

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

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

1. 使用 YUM 和 RHN 并安装 RPM 软件包。

   你可以使用 YUM 的 groupinstall 命令来安装默认的 JBoss EAP 6 组软件包。

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

   Copy to Clipboard Toggle word wrap

2. 配置 init 选项。

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

过程 4.10. 自动化安装

• 在终端窗口里，运行下列命令通过自动化脚本来安装 JBoss EAP 6：

  java -jar jboss-eap-6.1.0-installer.jar SCRIPT_NAME.xml

  Copy to Clipboard Toggle word wrap

过程 4.11. 使用 RPM 方法将 JBoss EAP 安装为红帽企业版 Linux 里的服务。

1. 安装 JBoss EAP 6

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

2. 启用服务

   RPM 安装方法在正确的位置安装必要的服务文件。要设置它为服务，你需要执行下列命令：

   chkconfig jbossas on

   Copy to Clipboard Toggle word wrap

过程 4.12. 设置服务

1. 找到 start-up 脚本和配置文件

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

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

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

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

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

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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap
   2. 复制 start-up 脚本到 /etc/init.d 目录里。

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

      Copy to Clipboard Toggle word wrap

4. 添加启动脚本为服务。

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

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

   Copy to Clipboard Toggle word wrap

5. 启动服务

   用标准的启动红帽企业版 Linux 服务的语法来测试已安装的服务。

   [user@host bin]$sudo service jboss-as-standalone.sh start

   Copy to Clipboard Toggle word wrap
   如果一切正常，你应该看到一个绿色的 [OK]。如果你遇到错误，请检查错误日志并确保配置文件里的路径是正确的。

6. 使服务在服务器重启时自动启动。

   要在服务器重启时自动启动的服务列表里添加服务，请使用以下命令：

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

   Copy to Clipboard Toggle word wrap

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

1. 创建系统环境变量

   创建两个系统环境变量：
   • 指向 JBoss EAP 6 安装目录的 JBOSS_HOME
   • NOPAUSE=1

2. 如果还未配置，请下载适合你的系统架构的 Native Utilities 软件包。

   如果用于 Windows 服务器的 Native Utilities 软件包没有作为 JBoss EAP 6 的一部分被安装，请从红帽客户门户 https://access.redhat.com 下载相关的 32 或 64 位软件包，并在 JBoss EAP 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 创建新的服务，且可以使用下表里的选项。
   Expand

   表 4.3. service install 选项

   参数或开关	描述
   /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 它就是必需的。

   Show more
   下面是用 install 命令在独立或域模式下创建新服务的基本示例。执行下列命令，按需要调整服务的日志级别：
   • 独立模式：

     service.bat install /loglevel INFO

     Copy to Clipboard Toggle word wrap
   • 域模式：
     如果对于 JBoss EAP 6 域控制器你没有使用默认的 master，请用正确的主机名或 JBoss EAP 6 域控制的别名来替换 master。

     service.bat install /host master /loglevel INFO

     Copy to Clipboard Toggle word wrap
   名为 JBossEAP6 的新 Windows 服务将被创建。

4. 在服务控制台里检验这个新的服务

   在终端窗口里执行下列命令来打开 Windows 服务控制台：

   services.msc

   Copy to Clipboard Toggle word wrap
   如果使用了默认的服务名称，那么在 Windows 服务列表里，这个新服务的名称将是：JBoss Enterprise Application Platform 6。你可以从服务控制台启动和停止服务，并修改如何启动和何时启动等设置。

5. 通过终端窗口启动和停止 JBoss EAP 6 服务

   要从终端窗口启动服务，使用下列命令，有需要的话可以修改服务名称：

   net start JBossEAP6

   Copy to Clipboard Toggle word wrap
   在终端窗口里使用下列命令停止这个服务，有需要的话可以修改服务名称：

   net stop JBossEAP6

   Copy to Clipboard Toggle word wrap

过程 4.14. 从 Microsoft Windows 服务器卸载 JBoss EAP 6 服务。

• 如果服务正在运行，请首先打开一个终端窗口并执行 net stop（加上服务的名称）来停止服务：

  net stop JBossEAP6

  Copy to Clipboard Toggle word wrap
  打开终端窗口并进入 EAP_HOME\modules\system\layers\base\native\sbin，执行下列命令：

  service uninstall

  Copy to Clipboard Toggle word wrap

过程 5.1. 订阅 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 来浏览邮件列表的归档。

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

1. 通过订阅 JBoss Watch 邮件列表或浏览 JBoss Watch 邮件列表归档来获得安全补丁的通知。
2. 阅读安全补丁的勘误并确认它可以应用于你的 JBoss 产品。
3. 如果安全补丁适用于你的 JBoss 产品，请用这个链接从红帽客户门户下载包含在勘误里的 PRM 软件包。
4. 请使用

   yum update

   Copy to Clipboard Toggle word wrap

   来安装补丁。

   重要

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

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

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

   重要

   如果你想将最新的 JBoss 6 安装到与现有版本年相同的位置，在安装之前，你需要将现有的安装移至其他位置。这可以防止有改动的配置文件、部署在升级时丢失。
2. 解压这个归档。这个步骤将安装一个干净的最新版本的 JBoss EAP 6。
3. 手动将以前版本的 EAP_HOME/domain/ 和 EAP_HOME/standalone/ 目录合并到新的安装里。

   警告

   配置文件不应该从以前的版本里复制。你应该手动进行修改。
4. 复核前一版本里 bin 目录里的改动，并在新目录里作对应的修改。

   警告

   当前 bin 目录里的文件不应该被之前的版本所覆盖。你应该手动进行修改。
5. 复核前一版本里其他被修改的文件，并将这些文件移至新版本里。这些文件可能包括：
   • welcome-content 目录。
   • modules 目录里的自定义模块。
   • bundles 目录里的自定义束。

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

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

   [user@host] yum update

   Copy to Clipboard Toggle word wrap
2. 手动合并包含对产品配置文件的修改的 *.rpmnew 文件。

过程 5.7. 设置 JBoss EAP 群集 6.1

1. 关于在 6.1 版本里如何设立 JBoss EAP 群集，请参考《JBoss EAP 6.1 管理和配置指南》里的《HTTP 群集和负载平衡》章节。
2. 使用《JBoss EAP 6.1 管理和配置指南》里的《在群集间移植流量》章节里的步骤将所有流量移植到新的群集里。