第 3 章 安装 JBoss EAP

下载 JBoss EAP 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 7.x.x 并点击 Download 链接。

1. 如果有必要，请将 ZIP 文件移至服务器里 JBoss EAP 应该安装的位置。

   • 运行 JBoss EAP 的用户必须具有对该目录的读和写权限。

2. 解压 ZIP 归档文件。

   $ unzip jboss-eap-7.x.x.zip

   Copy to Clipboard Toggle word wrap
   注意

   对于 Windows 服务器，右击 ZIP 文件并选择 Extract All。

下载 JBoss EAP ZIP 安装程序

1. 打开浏览器并登录客户门户网站：https://access.redhat.com。
2. 点击 Downloads。
3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application。
4. 从 Version 下拉菜单里选择正确的 JBoss EAP 版本。
5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 7.x.x Installer 并点击 Download 链接。

运行 JBoss EAP 图形化安装程序

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

2. 通过下列命令运行图形化安装程序：

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

   Copy to Clipboard Toggle word wrap
   注意

   在 Hewlett-Packard HP-UX 或 Solaris 环境里，您可以用 -d32 或 -d64 选项指定所需的架构。请用下列命令来启动安装程序：

   java -jar -d32 jboss-eap-7.x.x-installer.jar

   Copy to Clipboard Toggle word wrap

   或

   java -jar -d64 jboss-eap-7.x.x-installer.jar

   Copy to Clipboard Toggle word wrap

3. 遵循下表中的说明。

   Expand

   表 3.1. JBoss EAP 安装程序屏幕

   屏幕名称	何时出现	描述
   语言选择	总是	选择安装程序的语言并点击 OK。
   许可证协议	总是	用于 RED HAT JBOSS 中间件的 EULA。 选择 "I accept the terms of this license agreement" 并点击 Next。
   安装路径	总是	选择 JBoss EAP 的安装路径并点击 Next。
   组件选择	总是	选择要安装的组件。必需的组件是不能取消选择的。
   管理用户创建	总是	创建一个管理用户并设置密码。然后点击 Next。
   安装概述	总是	复查您的安装选项，然后点击 Next。
   组件安装	总是	当安装过程完成时，请点击 Next。
   配置 Runtime 环境	总是	您可以为您的 JBoss EAP 安装选择默认配置，或者用安装程序执行高级配置。请注意，即使您选择了默认配置，之后您还可以用 JBoss EAP 的管理界面来修改配置。 选择 Perform default configuration 或 Perform advanced configuration，然后选择要配置的项目并点击 Next。
   配置密码库	如果您选择在运行环境的高级配置里安装密码库。	配置密码库（Password Vault）以加密的密钥库来存储所有敏感性密码，然后点击 Next。更多信息请参考『如何配置服务器安全性』里的密码库文档。
   SSL 安全性	如果您选择在运行环境的高级配置里启用 SSL 安全性。	指定 SSL 密钥库和密钥库密码来保护 JBoss EAP 管理界面，然后点击 Next。详情请参考 How To Configure Server Security 里的 securing the management interfaces。 警告 Red Hat 推荐您在所有受影响的软件包里显性地禁用 SSLv2、SSLv3 和 TLSv1.0 而使用 TLSv1.1 或 TLSv1.2。
   LDAP 配置	如果您选择在运行环境的高级配置里启用 LDAP 验证。	启用 LDAP 验证以将 LDAP 目录服务器用作管理控制台、管理 CLI 或 API 的验证源。完成后请点击 Next。更多信息请参考『如何配置身份管理』 里的 LDAP 文档。
   LDAP 安全区的配置	如果您选择在运行环境的高级配置里启用 LDAP 验证。	新的安全区将使用之前步骤里定义的 LDAP 连接来创建并和管理界面关联。 指定 LDAP 环境的值，然后点击 Next。更多信息请参考『如何配置身份管理』里的 LDAP 文档。
   Infinispan 配置	如果您选择在运行环境的高级配置里安装 Infinispan 缓存。	创建一个用于管理缓存数据的 Infinispan 缓存。指定 Infinispan 的名称，配置其他字段并点击 Next。更多信息请参考《配置指南》的 Infinispan documentation 章节。
   安全域配置	如果您选择在运行环境的高级配置里添加安全域。	为 JBoss EAP 服务器实例配置一个安全域。多数字段都已经用默认值进行了填充，您不需要进行修改。完成后请点击 Next。更多信息请参考《安全架构指南》里的 Security Domains 章节。
   JSSE 配置	如果您选择在运行环境的高级配置里添加安全域。	使用密钥库或信任库为之前步骤里定义的安全域配置 Java Secure Socket Extension(JSSE）。完成后点击 Next。
   Quickstarts	如果您选择在运行环境的高级配置里安装 Quickstarts。	选择 Quickstart 的安装路径并点击 Next。
   Maven 资料库设置	如果您选择在运行环境的高级配置里安装 Quickstarts。	选择 Maven 资料库和设置文件。
   套接字绑定	如果您选择在运行环境的高级配置里配置服务器端口绑定。	请确定安装是否使用默认的端口绑定、为所有默认绑定配置端口偏移或配置自定义端口绑定。 如果您选择配置端口偏移，请选择偏移量。 如果您选择配置自定义绑定，请选择是否配置独立模式、域模式还是两者的端口。 如果主机仅配置 IPv6，请选择 Enable pure IPv6 configuration，安装程序将进行所需的配置修改。 点击 Next。
   独立服务器模式的自定义套接字绑定	如果您选择在独立模式下配置自定义端口绑定。	为每个独立模式的配置（standalone、standalone ha、standalone full、standalone full-ha）配置端口和系统属性，然后点击 Next。
   域模式的自定义套接字绑定	如果您选择在域模式下配置自定义端口绑定。	为主机配置（domain host）和每种域模式配置（domain default、domain ha、domain full、domain full-ha）配置端口和系统属性，然后点击 Next。
   日志选项	如果您选择在运行环境的高级配置里配置日志级别。	选择想要的日志级别，然后点击 Next。
   JDBC 驱动设置	如果您选择在运行环境的高级配置里安装 JDBC 驱动。	安装和设置 JDBC 驱动。从下拉列表里选择合适的驱动供应商并指定驱动 JAR 位置。完成后点击 Next。更多信息请参考《配置指南》里的『数据源 JDBC 驱动』 章节。
   数据源设置	如果您选择在运行环境的高级配置里安装 JDBC 驱动及数据源。	配置应用程序使用的数据源。指定数据源名称，配置其他字段并点击 Next。更多的信息请参考《配置指南》 里的『数据源管理』章节。
   配置服务器	总是	当配置过程完成时，请点击 Next。
   快捷键配置	总是	勾选 Create shortcuts in the Start-Menu 来创建快捷键。只允许字母数字、破折号（-）、下划线（_）。在 Microsoft Windows 上，斜杠（/）和反斜杠（\）也是允许的。点击 Next。
   安装完成	总是	如果您想保存安装选项以用于将来的自动化安装，请点击 Generate installation script and properties file，然后点击 Done。 安装已完成。按程序创建的目录是服务器的顶层目录，它被称为 EAP_HOME。

   Show more

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

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

2. 通过下列命令运行基于文本的安装程序：

   java -jar jboss-eap-7.x.x-installer.jar -console

   Copy to Clipboard Toggle word wrap
3. 安装提示安装 JBoss EAP。安装程序创建的目录是服务器的顶层目录，它被称为 EAP_HOME。

1. 用下列命令从您订阅的资料库安装 JBoss EAP：

   yum groupinstall jboss-eap7

   Copy to Clipboard Toggle word wrap

修改 JBoss EAP 资料库

1. 在修改资料库之前，请确保 JBoss EAP 已应用了所有适用的更新：

   yum update

   Copy to Clipboard Toggle word wrap

2. 使用 Red Hat 订阅管理者，从现有的资料库取消订阅并订阅您需要的资料库。在下面的命令行里，用实际的资料库名称分别替换 EXISTING_REPOSITORY 和 NEW_REPOSITORY。

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

   Copy to Clipboard Toggle word wrap

使用变量文件进行无人值守自动化安装

1. 在文本编辑器里打开 .variables 文件，为每个关键字提供一个密码值。例如：

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

   Copy to Clipboard Toggle word wrap

2. 用自动化安装脚本运行安装次序。如果完整的变量文件位于与安装脚本相同的目录且您未修改其名称，安装程序会自动检测到变量文件。

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

   Copy to Clipboard Toggle word wrap

   或者，您可以用 -variablefile 参数指定变量文件的路径：

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

   Copy to Clipboard Toggle word wrap

使用 -variables 参数进行无人值守自动化安装

1. 用自动化安装脚本运行安装次序，并使用 -variables 参数以关键字/密码对指定所需的密码。例如：

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

   Copy to Clipboard Toggle word wrap
   注意

   当指定 -variables 关键字/密码对时，请确保中间没有空格。