使用 Red Hat Ansible 认证的内容集合安装 JBoss Web Server

流程

1. 在 Ansible 控制节点上，打开 vars.yml 文件。

2. 要指定要安装的 JBoss Web Server 版本，请将 jws_version 变量设置为适当的基本版本。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_version: 6.1.0

   注意

   确保您为 jws_version 变量指定的值与您要安装的产品存档文件的版本匹配。例如，若要为 JBoss Web Server 6.1 安装存档文件，可指定值 6.1.0。

   默认情况下，JBoss Web 服务器集合配置为同时安装主应用服务器存档和您指定的产品版本的原生存档。如果将 jws_native 变量设置为 False，JBoss Web Server 集合无法安装原生存档，这会导致需要安装原生存档文件的功能（如 SELinux 策略）出现问题。

   如果您没有指定自动文件下载的凭证，如 第 3 步 所述，请确保已将指定产品版本的存档文件复制到 Ansible 控制节点。在这种情况下，请确保复制的原生存档文件与目标主机上安装的操作系统版本匹配。

3. 如果您的 Ansible 控制中没有 JBoss Web Server 归档文件的副本，则集合默认联系红帽客户门户网站来自动下载存档文件。要确保使用红帽客户门户网站成功联系，请设置 rhn_username 和 rhn_password 变量来指定您的红帽服务帐户凭证。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   rhn_username: <client_ID>
   rhn_password: <client_secret>

   在上例中，将 &lt ;client_ID& gt ; 和 <client_secret > 替换为与您的红帽服务帐户关联的客户端 ID 和 secret。

   注意

   默认情况下，集合会自动决定与目标主机上安装的操作系统版本匹配的原生存档文件。如果 Ansible 控制节点上已存在相应存档文件的副本，则集合不会再次下载这些存档文件。

   如果您希望手动下载存档文件，或者您已经以其他方式获取这些文件，则可以强制进行完全离线安装。有关强制离线安装的更多信息，请参阅启用 JBoss Web Server 产品补丁更新的自动化安装。

4. 如果您更改了 Ansible 控制节点上下载的存档文件的名称，请设置 zipfile_name 和 jws_native_zipfile 变量，以指定您要安装的文件。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   zipfile_name: <application_server_file>
   jws_native_zipfile: <native_file>

   在前面的示例中，将 < application_server_file> 和 <native_file > 替换为适当的归档文件名。

   注意

   如果您没有更改文件名，则不需要设置 zipfile_name 和 jws_native_zipfile 变量。JBoss Web 服务器集合使用 jws_version 变量的值自动确定默认的文件名。

5. 将更改保存到 vars.yml 文件。

流程

1. 在 Ansible 控制节点上，打开 vars.yml 文件。

2. 将 jws_apply_patches 变量设置为 True。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_version: 6.1.0
   [...]
   jws_apply_patches: True

   注意

   确保将 jws_version 变量设置为适当的产品版本（如 6.1.0）的基础发行版本。

   JBoss Web 服务器集合配置为默认安装最新的补丁更新。集合联系红帽客户门户网站以确定要安装的正确补丁。

3. 如果您希望集合安装指定的补丁版本，而不是最新的补丁更新，请将 jws_patch_version 变量设置为您要安装的补丁版本。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_apply_patches: True
   jws_patch_version: 6.1.2

   根据前面的示例，集合仅安装累积 6.1.2 补丁，即使后续补丁也可用。

4. 当 jws_apply_patches 变量设为 True 时，JBoss Web 服务器集合默认联系红帽客户门户网站，以检查是否有新的补丁更新。如果需要，集合还会下载补丁更新。要确保使用红帽客户门户网站成功联系，请设置 rhn_username 和 rhn_password 变量来指定您的红帽服务帐户凭证。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   rhn_username: <client_ID>
   rhn_password: <client_secret>

   在上例中，将 &lt ;client_ID& gt ; 和 <client_secret > 替换为与您的红帽服务帐户关联的客户端 ID 和 secret。

   注意

   默认情况下，集合会自动决定与目标主机上安装的操作系统版本匹配的原生存档文件。如果 Ansible 控制节点上已存在相应存档文件的副本，则集合不会再次下载这些存档文件。

   如果 jws_patch_version 变量设为特定的补丁版本，则集合将仅下载指定的补丁版本，即使后续补丁也可用。

   如果您希望手动下载存档文件，或者您已经以其他方式获取这些文件，则可以强制进行完全离线安装，如 第 5 步 所述。

5. 如果要强制完全离线安装，并防止集合联系红帽客户门户网站，将 jws_offline_install 变量设置为 True。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_offline_install: True

   注意

   如果您的 Ansible 控制节点无法访问互联网，或者您希望集合以避免联系红帽客户门户网站以进行文件下载，则 jws_offline_install 变量很有用。在这种情况下，您必须将 jws_patch_version 变量设置为您要安装的补丁版本。

   确保您已将用于适当补丁更新的存档文件复制到 Ansible 控制节点。在这种情况下，请确保复制的原生存档文件与目标主机上安装的操作系统版本匹配。

   如果将 jws_offline_install 变量设置为 True，则集合不会尝试联系红帽客户门户网站，即使您还设置了 rhn_username 和 rhn_password 变量来允许自动下载文件。

6. 将更改保存到 vars.yml 文件。

流程

1. 如果要创建 Java 密钥存储，请执行以下步骤：

   1. 登录您要创建密钥存储的 目标主机。

      注意

      确保已安装 JDK，并且目标主机上已设置了 JAVA_HOME 变量。

   2. 运行以下命令来创建密钥存储：

      Copy to Clipboard Toggle word wrap

      $JAVA_HOME/bin/keytool -genkeypair -alias tomcat -keyalg RSA -keystore <path_to_keystore>

      在前面的命令中，将 & lt;path_to_keystore > 替换为您要创建的密钥存储文件的完整路径。如果没有指定 the -keystore 选项，该命令会在一些默认位置创建 keystore 文件，具体取决于您安装的 JDK 版本。例如，如果您使用红帽构建的 OpenJDK，密钥存储的默认位置为 /etc/ssl/keystore.jks。

      前面的命令生成密钥存储文件，其中包含一对公钥和私钥，以及用于服务器身份验证的单一自签名证书。密钥对和自签名证书存储在由 alias 选项标识的单个密钥存储条目中（如 tomcat）。

   3. 当 keytool 命令提示您输入以下信息时，为您的设置输入适当的值：

      • Keystore password （默认情况下，changeit）
      • 有关证书的一般信息
      • 证书的密钥密码（默认为密钥存储密码）
   注意

   或者，您也可以使用 Linux scp 命令在不同的主机之间复制现有的密钥存储文件，而不是创建新密钥存储文件。

2. 要启用对 HTTPS 连接的支持，请执行以下步骤：

   1. 在 Ansible 控制节点 上，打开 vars.yml 文件。

   2. 将 jws_listen_https_enabled 变量设置为 True。

      例如：

      Copy to Clipboard Toggle word wrap

      [...]
      jws_listen_https_enabled: True

   3. 如果每个目标主机上的 Java 密钥存储位于 /etc/ssl/keystore.jks 以外的路径中，请将 jws_listen_https_keystore_file 变量设置为适当的值。

      例如：

      Copy to Clipboard Toggle word wrap

      [...]
      jws_listen_https_keystore_file: <keystore_path>

      在前面的示例中，将 <keystore_path > 替换为每个目标主机上密钥存储文件的完整路径。

      注意

      如果您没有设置 jws_listen_https_keystore_file 变量，JBoss Web Server 集合会自动在 server.xml 文件中配置 certificateKeystoreFile 设置，其值为 /etc/ssl/keystore.jks。

   4. 如果每个目标主机上的 Java 密钥存储使用 changeit 以外的密码，请将 jws_listen_https_keystore_password 变量设置为适当的值。

      例如：

      Copy to Clipboard Toggle word wrap

      [...]
      jws_listen_https_keystore_password: <keystore_password>

      在前面的示例中，将 & lt;keystore_password > 替换为每个目标主机上 Java 密钥存储的正确密码。

      注意

      如果您没有设置 jws_listen_https_keystore_password 变量，JBoss Web 服务器集合会自动在 server.xml 中使用 changeit 值配置 certificateKeystorePassword 设置。

   5. 将更改保存到 vars.yml 文件。

流程

1. 在 Ansible 控制节点上，打开 vars.yml 文件。

2. 要启用 mod_cluster 侦听器，请将 jws_modcluster_enabled 变量设置为 True。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_modcluster_enabled: True

3. 要指定 mod_cluster 实例的 IP 地址和端口，请将 jws_modcluster_ip 和 jws_modcluster_port 变量设置为适当的值。默认 IP 地址为 127.0.0.1。默认端口为 6666。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_modcluster_ip: <ip_address>
   jws_modcluster_port: <port>

   在前面的示例中，将 & lt;ip_address > 替换为目标主机上 mod_cluster 实例的适当绑定地址，并将 & lt;port > 替换为 mod_cluster 实例用于侦听传入请求的适当端口。

4. 将更改保存到 vars.yml 文件。

流程

1. 在 Ansible 控制节点上，打开 vars.yml 文件。

2. 要指定到 vault.keystore、VAULT.dat 的路径以及您创建的 vault.properties 文件的路径，请将以下变量设置为适当的值。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_vault_name: ./vault_files/vault.keystore
   jws_vault_data: ./vault_files/VAULT.dat
   jws_vault_properties: ./vault_files/vault.properties

1. 要启用密码库功能，请将 jws_tomcat_vault_enabled 变量设置为 True。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_tomcat_vault_enabled: True

2. 要指定您为密码库配置的密钥存储别名、密钥存储密码、迭代计数和 salt 值，请将以下变量设置为适当的值。

   例如：

   Copy to Clipboard Toggle word wrap

   [...]
   jws_tomcat_vault_alias: <keystore_alias>
   jws_tomcat_vault_storepass: <keystore_password>
   jws_tomcat_vault_iteration: <iteration_count>
   jws_tomcat_vault_salt: <salt>

   在前面的示例中，确保指定您配置为先决条件步骤一部分的适当值。

3. 将更改保存到 vars.yml 文件。