Red Hat Ansible Certified Content Collection を使用した 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 6.0 のアーカイブファイルをインストールするには、値 6.0.0 を指定します。

   デフォルトでは、JBoss Web Server コレクションは、メインアプリケーションサーバーアーカイブと、指定した製品バージョンのネイティブアーカイブの両方をインストールするように設定されています。jws_native 変数を False に設定すると、JBoss Web Server コレクションはネイティブアーカイブをインストールできないため、ネイティブアーカイブファイルのインストールを必要とする SELinux ポリシーなどの機能で問題が発生します。

   ステップ 3 で説明されているように、自動ファイルダウンロードの認証情報を指定しない場合は、指定した製品バージョンのアーカイブファイルを Ansible コントロールノードにコピーしていることを確認してください。このような場合は、コピーしたネイティブアーカイブファイルが、ターゲットホストにインストールされているオペレーティングシステムのバージョンと一致していることを確認します。

3. JBoss Web Server アーカイブファイルのコピーが Ansible コントロールに存在しない場合、コレクションはデフォルトで Red Hat カスタマーポータルに接続し、アーカイブファイルを自動的にダウンロードします。Red Hat カスタマーポータルとの接続を確実に成功させるには、rhn_username 変数と rhn_password 変数を設定して、Red Hat サービスアカウントの認証情報を指定します。

   以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

   上記の例では、<client_ID> と <client_secret> を、Red Hat サービスアカウントに関連付けられているクライアント ID とシークレットに置き換えます。

   注記

   デフォルトでは、コレクションは、どのネイティブアーカイブファイルがターゲットホストにインストールされているオペレーティングシステムのバージョンと一致するかを自動的に判別します。適切なアーカイブファイルのコピーが Ansible コントロールノードにすでに存在する場合、コレクションはこれらのアーカイブファイルを再度ダウンロードしません。

   アーカイブファイルを手動でダウンロードする場合や、これらのファイルを別の方法ですでに取得している場合は、完全なオフラインインストールを強制できます。オフラインインストールの強制に関する詳細は、JBoss Web Server 製品パッチ更新の自動インストールの有効化 を参照してください。

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 Server コレクションは、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 変数が適切な製品バージョンのベースリリース (例: 6.0.0) に設定されていることを確認します。

   JBoss Web Server コレクションは、デフォルトで最新のパッチ更新をインストールするように設定されています。コレクションは Red Hat カスタマーポータルに接続して、インストールする正しいパッチを決定します。

3. 最新のパッチ更新ではなく、指定したパッチリリースをコレクションにインストールする場合は、jws_patch_version 変数を、インストールするパッチリリースに設定します。

   以下に例を示します。

   [...]
   jws_apply_patches: True
   jws_patch_version: 5.7.2

   Copy to Clipboard Toggle word wrap

   上記の例に基づくと、新しいパッチが利用可能な場合でも、コレクションは 6.0.2 累積パッチのみをインストールします。

4. jws_apply_patches 変数が True に設定されている場合、JBoss Web Server コレクションはデフォルトで Red Hat カスタマーポータルに接続し、新しいパッチ更新が利用可能かどうかを確認します。このコレクションは、必要に応じてパッチ更新もダウンロードします。Red Hat カスタマーポータルとの接続を確実に成功させるには、rhn_username 変数と rhn_password 変数を設定して、Red Hat サービスアカウントの認証情報を指定します。

   以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

   上記の例では、<client_ID> と <client_secret> を、Red Hat サービスアカウントに関連付けられているクライアント ID とシークレットに置き換えます。

   注記

   デフォルトでは、コレクションは、どのネイティブアーカイブファイルがターゲットホストにインストールされているオペレーティングシステムのバージョンと一致するかを自動的に判別します。適切なアーカイブファイルのコピーが Ansible コントロールノードにすでに存在する場合、コレクションはこれらのアーカイブファイルを再度ダウンロードしません。

   jws_patch_version 変数が特定のパッチリリースに設定されている場合、新しいパッチが利用可能な場合でも、コレクションは指定したパッチリリースのみをダウンロードします。

   アーカイブファイルを手動でダウンロードする場合や、これらのファイルを別の方法ですでに取得している場合は、ステップ 5 の説明に従って完全なオフラインインストールを強制できます。

5. 完全なオフラインインストールを強制し、コレクションが Red Hat カスタマーポータルに接続しないようにするには、jws_offline_install 変数を True に設定します。

   以下に例を示します。

   [...]
   jws_offline_install: True

   Copy to Clipboard Toggle word wrap
   注記

   jws_offline_install 変数は、Ansible コントロールノードがインターネットにアクセスできない場合や、コレクションがファイルのダウンロードのために Red Hat カスタマーポータルに接続することを回避したい場合に役立ちます。この場合は、jws_patch_version 変数を、インストールするパッチリリースに設定する必要があります。

   適切なパッチ更新のアーカイブファイルを Ansible コントロールノードにコピーしている。このような場合は、コピーしたネイティブアーカイブファイルが、ターゲットホストにインストールされているオペレーティングシステムのバージョンと一致していることを確認します。

   jws_offline_install 変数を True に設定した場合は、ファイルの自動ダウンロードを許可するように rhn_username 変数と rhn_password 変数を設定していても、コレクションは Red Hat カスタマーポータルに接続しようとしません。

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

      上記のコマンドで、<path_to_keystore> を、作成するキーストアファイルへのフルパスに置き換えます。-keystore オプションを指定しない場合、コマンドは、インストールした JDK のバージョンに応じたデフォルトの場所にキーストアファイルを作成します。たとえば、Red Hat build of OpenJDK を使用している場合、キーストアのデフォルトの場所は /etc/ssl/keystore.jks です。

      上記のコマンドは、公開鍵と秘密鍵のペアと、サーバー認証用の単一の自己署名証明書を含むキーストアファイルを生成します。キーペアと自己署名証明書は、-alias オプション (tomcat など) で識別される単一のキーストアエントリーに格納されます。

   3. keytool コマンドで次の情報の入力を求めるプロンプトが表示されたら、セットアップに適した値を入力します。

      • キーストアのパスワード (デフォルトでは changeit)
      • 証明書に関する一般情報
      • 証明書のキーパスワード (デフォルトでは、キーストアパスワード)
   注記

   または、新しいキーストアを作成する代わりに、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 コレクションは 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

      前の例の <keystore_password> を、各ターゲットホストにある Java キーストアの正しいパスワードに置き換えます。

      注記

      jws_listen_https_keystore_password 変数を設定しない場合、JBoss Web Server コレクションは、値が changeit の server.xml で certificateKeystorePassword 設定を自動的に設定します。

   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

   前の例で、<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. パスワードボールト機能を有効にするには、jws_tomcat_vault_enabled 変数を True に設定します。

   以下に例を示します。

   [...]
   jws_tomcat_vault_enabled: True

   Copy to Clipboard Toggle word wrap

2. パスワード vault 用に設定したキーストアエイリアス、キーストアパスワード、繰り返し回数、ソルト値を指定するには、次の変数を適切な値に設定します。

   以下に例を示します。

   [...]
   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 ファイルに保存します。