安装指南

过程 3.1. 下载 ZIP 文件

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 并点击 Download 选项。

过程 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 归档文件。

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

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

2. 删除安装目录。

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

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

   如果您创建了初始化脚本或其他依赖于安装在您的机器里的 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 选项。

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

1. 打开终端窗口并进入包含安装程序 JAR 文件的目录。
2. 输入下列命令：

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

   Copy to Clipboard Toggle word wrap
3. 遵循下表中的说明。

过程 3.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 的安装目录，请选择这个复选框。
   

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

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

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

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

   java -jar uninstaller.jar -console

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

过程 3.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 按钮。请看下面的图表。
   

   图 3.2. JBoss EAP 6 PackageKit 安装

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

过程 3.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 安装配置文件”。

过程 3.10. 自动化安装

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

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

  Copy to Clipboard Toggle word wrap

  注意

  当您使用自动化安装脚本（auto.xml）来进行自动化安装时，安装程序默认会生成输入密码的提示。

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

  java -jar jboss-eap-6.x.x-installer.jar http://network-host/auto.xml (对于 HTTP)

  Copy to Clipboard Toggle word wrap

  java -jar jboss-eap-6.x.x-installer.jar ftp://network-host/auto.xml (对于 FTP)

  Copy to Clipboard Toggle word wrap

过程 3.11. 

1. 在变量文件里输入键值

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

   adminPassword = password#2
   vault.keystorepwd = vaultkeystorepw
   ssl.password = user12345

   Copy to Clipboard Toggle word wrap

2. 以 variablefile 文件名为参数运行安装程序来开始自动化安装

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

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

   Copy to Clipboard Toggle word wrap

过程 3.12. 

• 运行带有变量参数的安装程序

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

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

  Copy to Clipboard Toggle word wrap

  注意

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

过程 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)

   Copy to Clipboard Toggle word wrap
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 工具功能。

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

1. 安装 Native 组件和工具

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

   yum install package_name

   Copy to Clipboard Toggle word wrap

   您可以安装这些 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 服务器以应用这些修改

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

1. 安装 JBoss EAP 6

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

2. 启用服务

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

   chkconfig jbossas on

   Copy to Clipboard Toggle word wrap
   要在域模式下设置为服务，请使用下列命令：

   chkconfig jbossas-domain on

   Copy to Clipboard Toggle word wrap

过程 3.17. 设立服务

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. 启动服务

   请使用 Red Hat 企业版 Linux 的下列命令来测试服务是否已正确安装。
   • 对于 Red Hat 企业版 Linux 5 和 6：

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

     Copy to Clipboard Toggle word wrap
   • 对于 Red Hat 企业版 Linux 7：

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

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

   注意

   Red Hat 企业版 Linux 7 里不会出现绿色的 [OK]。

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

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

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

   Copy to Clipboard Toggle word wrap

过程 3.18. 在 Red Hat 企业版 Linux 里将 JBoss EAP 配置为服务（ZIP、安装程序）。

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

   sudo service jboss-as-standalone.sh stop

   Copy to Clipboard Toggle word wrap
2. 从服务器列表里删除 JBoss EAP：

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

   Copy to Clipboard Toggle word wrap
3. 删除系统目录文件。
   1. 删除服务器启动脚本：

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

      Copy to Clipboard Toggle word wrap
   2. 删除服务配置文件：

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

      Copy to Clipboard Toggle word wrap

      重要

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

      sudo rm -rf /etc/jboss-as/

      Copy to Clipboard Toggle word wrap

过程 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 位软件包，并在 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

   表 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 服务。

   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 服务列表里，这个新服务的名称将是：JBossEAP6。你可以从服务控制台启动和停止服务，并修改如何启动和何时启动等设置。

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

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

   net start JBossEAP6

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

   net stop JBossEAP6

   Copy to Clipboard Toggle word wrap

过程 3.20. 从 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

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

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

   yum update

   Copy to Clipboard Toggle word wrap

   来安装补丁。

   重要

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

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

过程 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 目录里的改动，并在新目录里作对应的修改。

   警告

   当前 bin 目录里的文件不应该被之前的版本所覆盖。您应该手动进行修改。
5. 复核前一版本里其他被修改的文件，并将这些文件移至新版本里。这些文件可能包括：
   • welcome-content 目录。
   • modules 目录里的自定义模块。
   • bundles 目录里的自定义束。
6. 可选的：如果我们之前将 JBoss EAP 6 配置为服务，请先删除现有的服务并配置新的服务来升级。

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

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

   [user@host] yum update

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

过程 4.9. 设置 JBoss EAP 群集

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