第3章 JBoss Web Server の自動デプロイメントの有効化

手順

1. Ansible コントロールノードで、vars.yml ファイルを開きます。

2. インストールする JBoss Web Server のバージョンを指定するには、jws_version 変数を適切なベースリリースに設定します。

   以下に例を示します。

   [...]
   jws_version: 5.8.0

   注記

   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>

   上記の例では、<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>

   前の例で、<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.8.0
   [...]
   jws_apply_patches: True

   注記

   jws_version 変数が適切な製品バージョンのベースリリース (例: 6.0.0) に設定されていることを確認します。

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

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

   以下に例を示します。

   [...]
   jws_apply_patches: True
   jws_patch_version: 5.8.2

   上記の例に基づくと、新しいパッチが利用可能な場合でも、コレクションは 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>

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

   注記

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

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

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

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

   以下に例を示します。

   [...]
   jws_offline_install: True

   注記

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

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

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

6. 変更を vars.yml ファイルに保存します。