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

流程

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

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

   例如：

   [...]
   jws_version: 5.7.0

   Copy to Clipboard Toggle word wrap
   注意

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

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

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

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

   例如：

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

   Copy to Clipboard Toggle word wrap

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

   注意

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

   如果您希望手动下载存档文件，或者已以某种方式获得这些文件，您可以强制完全离线安装。有关强制离线安装的更多信息，请参阅启用 JBoss Web 服务器产品补丁更新的自动安装。

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

   例如：

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

   Copy to Clipboard Toggle word wrap

   在前面的示例中，将 < 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。

   例如：

   [...]
   jws_version: 5.7.0
   [...]
   jws_apply_patches: True

   Copy to Clipboard Toggle word wrap
   注意

   确保将 jws_version 变量设置为相应产品版本（如 5.7.0）的基础版本。

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

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

   例如：

   [...]
   jws_apply_patches: True
   jws_patch_version: 5.7.2

   Copy to Clipboard Toggle word wrap

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

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

   例如：

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

   Copy to Clipboard Toggle word wrap

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

   注意

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

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

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

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

   例如：

   [...]
   jws_offline_install: True

   Copy to Clipboard Toggle word wrap
   注意

   如果您的 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. 运行以下命令来创建密钥存储：

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

      Copy to Clipboard Toggle word wrap

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

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

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

      • 密钥存储密码（默认为，更改 它）
      • 有关证书的一般信息
      • 证书的密钥密码（默认为 密钥存储密码）
   注意

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

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

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

   2. 将 jws_listen_https_enabled 变量设置为 True。

      例如：

      [...]
      jws_listen_https_enabled: True

      Copy to Clipboard Toggle word wrap

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

      例如：

      [...]
      jws_listen_https_keystore_file: <keystore_path>

      Copy to Clipboard Toggle word wrap

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

      注意

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

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

      例如：

      [...]
      jws_listen_https_keystore_password: <keystore_password>

      Copy to Clipboard Toggle word wrap

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

      注意

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

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

流程

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

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

   例如：

   [...]
   jws_modcluster_enabled: True

   Copy to Clipboard Toggle word wrap

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

   例如：

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

   Copy to Clipboard Toggle word wrap

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

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

流程

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

2. 要将 vault.keystore、VAULT.dat 和 vault.properties 文件的路径指定为预备步骤的一部分，请将以下变量设置为适当的值：

   例如：

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

   Copy to Clipboard Toggle word wrap

1. 要启用 vault 功能，将 jws_tomcat_vault_enabled 变量设置为 True。

   例如：

   [...]
   jws_tomcat_vault_enabled: True

   Copy to Clipboard Toggle word wrap

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

   例如：

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

   Copy to Clipboard Toggle word wrap

   在前面的示例中，确保指定您配置为预备步骤中的相应值。

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