ホストの管理

手順

1. Satellite Web UI で、ホスト > ホストの作成 の順にクリックします。
2. ホスト タブで、必要な詳細を入力します。
3. Ansible ロール タブをクリックして、Ansible ロール リストから、ホストに追加するロールを 1 つまたは複数選択します。矢印 アイコンを使用して、追加または削除するロールを管理します。
4. Puppet クラス タブで、追加する Puppet クラスを選択します。

5. インターフェイス タブで、以下を行います。

   1. 各インターフェイスに対して、アクション コラムで 編集 をクリックし、必要に応じて以下を設定します。

      • タイプ: ボンドまたは BMC インターフェイスに対して、タイプ リストで、インターフェイスタイプを選択します。
      • MAC アドレス: MAC アドレスを入力します。
      • DNS 名: DNS サーバーに認識させる DNS 名を入力します。これは、完全修飾ドメイン名 (FQDN) のホスト部分に使用されます。
      • ドメイン: プロビジョニングネットワークのドメイン名を選択します。これにより、サブネット リストが自動的に更新され、適切なサブネットの選択肢が表示されます。
      • IPv4 サブネット: リストから、ホストの IPv4 サブネットを選択します。
      • IPv6 サブネット: リストから、ホストの IPv6 サブネットを選択します。
      • IPv4 アドレス: サブネットに対して IP アドレス管理 (IPAM) が有効な場合は、IP アドレスが自動的に提案されます。または、アドレスを入力することもできます。トークンのプロビジョニングが有効な場合、ドメインが DNS を管理しない場合、サブネットが逆引き DNS を管理しない場合、またはサブネットが DHCP 予約を管理しない場合は、このアドレスを省略できます。
      • IPv6 アドレス: サブネットに対して IP アドレス管理 (IPAM) を有効にした場合は、IP アドレスが自動的に提案されます。または、アドレスを入力することもできます。
      • 管理: このチェックボックスを選択すると、Capsule が提供する DHCP サービスおよび DNS サービスを使用してプロビジョニングを行う際にインターフェイスを設定します。
      • プライマリー: このチェックボックスを選択すると、このインターフェイスの DNS 名を、FQDN のホスト部分に使用します。
      • プロビジョニング: このチェックボックスを選択すると、プロビジョニングにこのインターフェイスを使用します。つまり、このインターフェイスを使用して TFTP ブートが行われ、そしてイメージをベースにしたプロビジョニングでは、プロビジョニングを実行するスクリプトにこのインターフェイスが使用されます。anaconda による RPM のダウンロードや、%post スクリプトの Puppet 設定などの多くのプロビジョニングタスクは、プライマリーインターフェイスを使用する点にご留意ください。

      • 仮想 NIC: このインターフェイスが物理デバイスではない場合は、このチェックボックスを選択します。この設定にはオプションが 2 つあります。

        • タグ: 任意で VLAN タグを設定します。設定していない場合はサブネットの VLAN ID となります。
        • 割り当て先: この仮想インターフェイスが割り当てられるインターフェイスのデバイス名を入力します。
   2. OK をクリックして、インターフェイス設定を保存します。
   3. オプションとして、インターフェイスの追加 をクリックし、追加ネットワークインターフェイスを組み込みます。詳細は、5章ネットワークインターフェイスの追加 を参照してください。
   4. 送信 をクリックし、変更を適用して終了します。
6. オペレーティングシステム タブで、必要な情報を入力します。Red Hat オペレーティングシステムの場合は、メディアの選択 で 同期したコンテンツ を選択します。Red Hat 以外のオペレーティングシステムを使用する場合には、すべてのメディア を選択してから、メディアの選択 リストからインストールメディアを選択します。このリストからパーティションテーブルを選択するか、カスタムパーティションテーブル フィールドでカスタムのパーティションテーブルを入力します。両方は指定できません。

7. パラメーター タブで パラメーターの追加 をクリックして、ランタイム時にジョブテンプレートにわたすパラメーター変数を追加します。これには、ホストに関連付ける 全 Puppet クラス、Ansible Playbook パラメーター、ホストパラメーターが含まれます。Ansible のジョブテンプレートでパラメーター変数を使用するには、ホストパラメーター を追加する必要があります。

   Red Hat Enterprise Linux 8 ホストの作成時には、システム目的属性を設定できます。システム目的属性は、ホストの作成時に、どのサブスクリプションを自動的にアタッチするかを定義します。ホストパラメーター エリアで、適切な値を指定し、以下のパラメーターを入力します。値の一覧は、標準の RHEL 8 インストールの実行 の システムの目的の概要 を参照してください。

   • syspurpose_role
   • syspurpose_sla
   • syspurpose_usage
   • syspurpose_addons

   リモートジョブ実行用のプルモードでホストを作成する場合は、タイプ boolean を true に設定して enable-remote-execution-pull パラメーターを追加します。詳細は、「リモート実行用のトランスポートモード」 を参照してください。

8. 追加情報 タブに、ホストに関する追加情報を入力します。
9. 送信 をクリックして、プロビジョニングリクエストを完了します。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. Actions メニューで Clone をクリックします。
3. Host タブで、元のホストとは異なる Name を指定します。
4. Interfaces タブで、別の IP アドレスを指定します。
5. Submit をクリックしてホストのクローンを作成します。

手順

1. Satellite Web UI で、Infrastructure > Compute Resources に移動します。
2. コンピュートリソースを選択します。
3. 仮想マシン タブで、アクション メニューから 仮想マシンの関連付 をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Overview タブで、System purpose カードの Edit をクリックします。
4. ホストのシステム目的属性を選択します。
5. Save をクリックします。

CLI 手順

1. ホストにログインして、必要なシステム目的属性を編集します。たとえば、使用タイプを Production、ロールを Red Hat Enterprise Linux Server に設定し、addon アドオンを追加します。値の一覧は、標準の RHEL 8 インストールの実行 の システムの目的の概要 を参照してください。

   # subscription-manager syspurpose set usage 'Production'
   # subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server'
   # subscription-manager syspurpose add addons 'your_addon'

2. このホストのシステム目的属性を検証します。

   # subscription-manager syspurpose

3. このホストに自動的にサブスクリプションをアタッチします。

   # subscription-manager attach --auto

4. このホストのシステム目的のステータスを検証します。

   # subscription-manager status

手順

1. Satellite Web UI で、ホスト > コンテンツホスト に移動し、編集する Red Hat Enterprise Linux 8 ホストを選択します。
2. Select Action リストをクリックし、Manage System Purpose を選択します。

3. 選択したホストに割り当てるシステム目的属性を選択します。以下の値のいずれかを選択できます。

   • 選択した全ホストを設定するための特定の属性
   • 変更なし (選択したホストに設定された属性を保持)
   • なし (消去) (選択したホストの属性を消去)
4. Assign をクリックします。
5. Satellite Web UI で、Hosts > Content Hosts に移動し、同じ Red Hat Enterprise Linux 8 ホストを選択し、システム目的に基づいてサブスクリプションを自動的にアタッチします。
6. アクションの選択 リストをクリックして サブスクリプションの管理 を選択します。
7. 自動アタッチ をクリックして、選択した全ホストに、システムロールをもとにサブスクリプションを自動的にアタッチします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Content タブをクリックし、Module streams タブをクリックします。
4. モジュールの横にある縦リーダーをクリックして、実行するアクションを選択します。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

手順

1. Satellite Web UI で 設定 > ホストグループ に移動して、ホストグループの作成 をクリックします。
2. 属性を継承する既存のホストグループがある場合には、親 リストからホストグループを選択します。継承する属性がない場合には、このフィールドは空白のままにします。
3. 新規ホストグループの 名前 を入力します。
4. 新たに作成するホストに継承させる情報をさらに入力します。
5. Ansible ロール タブをクリックして、Ansible ロール リストから、ホストに追加するロールを 1 つまたは複数選択します。矢印 アイコンを使用して、追加または削除するロールを管理します。

6. 追加タブをクリックして、ホストグループに属性として指定する情報を追加します。

   注記

   Puppet は、Production 環境内に作成した Puppet 環境に関連付けられているホストグループにホストを登録すると、Puppet CA 証明書の取得に失敗します。

   ホストグループに関連付ける適切な Puppet 環境を作成するには、ディレクトリーを手動で作成します。

   # mkdir /etc/puppetlabs/code/environments/example_environment

7. 送信 をクリックしてホストグループを保存します。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Edit ボタンをクリックします。
4. Host Group リストからホストグループを選択します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Edit ボタンをクリックします。
4. Host Group リストから新規ホストグループを選択します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Host collections カードで縦リーダーをクリックして Add host to collections を選択します。
4. ホストコレクションを選択します。
5. Add をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Edit ボタンの横にある縦リーダーアイコンをクリックし、Change content source を選択します。
4. 一覧から Environment、Content View、および Content Source を選択します。
5. コンテンツソースの変更 をクリックします。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 変更するホストの名前をクリックします。
3. コンテンツビューの詳細 カードの縦リーダーをクリックし、Edit content view assignment を選択します。
4. 環境を選択します。
5. コンテンツビューを選択します。
6. Save をクリックします。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 変更するホストの名前をクリックします。
3. Edit ボタンをクリックします。
4. ホストの管理 または ホストの管理解除 をクリックして、ホストのステータスを変更します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Traces タブをクリックし、Enable Traces ボタンをクリックします。
4. 一覧から katello-host-tools-tracer をインストールするプロバイダーを選択します。
5. Enable Tracer ボタンをクリックします。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Traces タブを選択します。
4. 再起動するアプリケーションを選択します。
5. Restart app リストから Restart via remote execution を選択します。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 変更する必要のあるホストのチェックボックスを選択します。
3. アクションの選択 リストから 組織の割り当て を選択すると、新しいオプションウィンドウが開きます。

4. 組織の選択 リストから、ホストを割り当てる組織を選択します。Fix Organization on Mismatch チェックボックスを選択します。

   注記

   ドメインまたはサブネットなど、ホストに関連付けるリソースがあるにもかかわらず、これらのリソースがホストの割り当て先の組織に割り当てられていない場合に、不一致が生じます。Fix Organization on Mismatch (組織の不一致についての修正) オプションを使用すると、このようなリソースが組織に追加されるので、このオプションは推奨の選択肢になります。Fail on Mismatch (不一致により失敗) オプションを選択すると、常にエラーメッセージが生成されます。たとえば、実際には設定に不一致がない場合でも、別の組織にホストを再割り当てすると失敗します。

5. Submit をクリックします。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 変更する必要のあるホストのチェックボックスを選択します。
3. アクションの選択 リストから ロケーションの割り当て を選択すると、新しいオプションウィンドウが開きます。

4. ロケーションの選択 リストに移動して、ホストに割り当てるロケーションを選択します。Fix Location on Mismatch チェックボックスを選択します。

   注記

   ドメインまたはサブネットなど、ホストに関連付けるリソースがあるにもかかわらず、これらのリソースがホストの割り当て先のロケーションに割り当てられていない場合に、不一致が生じます。Fix Location on Mismatch (ロケーションの不一致についての修正) オプションを使用すると、このようなリソースがロケーションに追加されるので、このオプションは推奨の選択肢になります。Fail on Mismatch (不一致により失敗) オプションを選択すると、常にエラーメッセージが生成されます。たとえば、実際には設定に不一致がない場合でも、別のロケーションにホストを再割り当てすると失敗します。

5. Submit をクリックします。

手順

1. Satellite Web UI で、ホスト > すべてのホスト または ホスト > コンテンツホスト へ移動します。すべてのホスト または コンテンツホスト のどちらのページからホストを削除しても相違はないので注意してください。どちらの場合も、Satellite はホストを完全に削除します。
2. 削除するホストを選択します。
3. アクションの選択 リストから ホストの削除 を選択します。
4. 送信 をクリックして、Red Hat Satellite からホストを完全に削除します。

1. ディレクトリーを手動で作成します。

   # mkdir /etc/puppetlabs/code/environments/example_environment

2. Satellite Web UI で、Configure > Environments に移動し、Import environment from をクリックします。ボタン名には、内部または外部の Capsule の FQDN が含まれます。
3. 作成したディレクトリーを選択し、更新 をクリックします。

手順

1. root ユーザーで、ホストにログインします。

2. スクリプトをダウンロードします。

   # curl -O http://satellite.example.com/pub/bootstrap.py

3. スクリプトを実行可能にします。

   # chmod +x bootstrap.py

4. ヘルプテキストを表示して、スクリプトが実行可能であることを確認します。

   • Red Hat Enterprise Linux 8 の場合:

     # /usr/libexec/platform-python bootstrap.py -h

   • 他の Red Hat Enterprise Linux バージョンの場合:

     # ./bootstrap.py -h

5. ご使用の環境に適した値を使用して、ブートストラップコマンドを入力します。

   --server オプションの場合は、Satellite Server または Capsule Server の FQDN を指定します。オプションが --location、--organization、および --hostgroup の場合は、オプションへの引数として、ラベルではなく引用符で囲まれた名前を使用します。高度なユースケースは、「詳細なブートストラップスクリプトの設定」 を参照してください。

   • Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。

     # /usr/libexec/platform-python bootstrap.py \
     --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

   • Red Hat Enterprise Linux 6 または 7 では、次のコマンドを入力します。

     # ./bootstrap.py --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

6. --login オプションで指定した Satellite ユーザーのパスワードを入力します。

   スクリプトは、進捗の通知を stdout に送信します。

7. スクリプトでプロンプトが表示されたら、ホストの Puppet 証明書を承認します。Satellite Web UI で Infrastructure > Capsules に移動して、--server オプションで指定した Satellite または Capsule Server を検出します。
8. アクション コラムのリストから、証明書 を選択します。
9. アクション コラムで、署名 をクリックして、ホストの Puppet 証明書を承認します。
10. ホストに戻り、残りのブートストラップ処理が完了するのを確認します。
11. Satellite Web UI で ホスト > すべてのホスト に移動して、そのホストが、適切なホストグループに接続していることを確認します。

12. オプション: ホストの登録が完了したら、スクリプトを削除します。

    # rm bootstrap.py

手順

1. katello-agent パッケージをインストールします。

   # dnf install katello-agent

2. goferd サービスを開始します。

   # systemctl start goferd

手順

1. コンテンツホストで katello-host-tools-tracer RPM パッケージをインストールします。

   # yum install katello-host-tools-tracer

2. 以下のコマンドを入力します。

   # katello-tracer-upload

3. Satellite Web UI で ホスト > すべてのホスト に移動して、必要なホスト名をクリックします。
4. トレース タブをクリックして、トレースを表示します。インストールされていない場合には、Enable Traces ボタンでそのパッケージをインストールするリモート実行ジョブを開始します。

手順

1. Satellite Web UI で、 Configure > Global Parameters に移動して、ホストパラメーターをグローバルに追加します。あるいは、Configure > Host Groups に移動し、ホストグループを編集または作成して、ホストパラメーターをホストグループにのみ追加することもできます。
2. グローバルパラメーターまたはホストグループのホストパラメーターを使用して、Puppet エージェントを有効化します。Enable-puppet7 という名前のホストパラメーターを追加し、boolean タイプを選択して、値を true に設定します。

3. グローバルパラメーターまたはホストグループで次のホストパラメーターを使用して、Puppet エージェントの設定を指定します。

   • puppet_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet サーバーのホスト名 (puppet.example.com など) に設定します。
   • オプション: puppet_ca_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet CA サーバーのホスト名 (puppet-ca.example.com など) に設定します。puppet_ca_server が設定されていない場合、Puppet エージェントは puppet_server と同じサーバーを使用します。
   • オプション: puppet_environment という名前のホストパラメーターを追加し、string タイプを選択して、ホストで使用する Puppet 環境に値を設定します。

   BZ2177730 が解決されるまでは、Puppet サーバーが Capsule Server となっている統合セットアップでも、ホストパラメーターを使用して Puppet エージェント設定を指定する必要があります。

4. Hosts > Register Host に移動し、適切なアクティベーションキーを使用してホストを登録します。詳細は、ホストの管理 の ホストの登録 を参照してください。
5. Infrastructure > Capsules に移動します。
6. 必要な Capsule Server の Actions コラムの一覧から、Certificates を選択します。
7. 必要なホストの右にある Sign をクリックして、Puppet エージェントの SSL 証明書に署名します。

手順

1. root ユーザーで、ホストにログインします。

2. Puppet エージェントパッケージをインストールします。

   • Red Hat Enterprise Linux 8 以降を実行しているホストの場合:

     # dnf install puppet-agent

   • Red Hat Enterprise Linux 7 以前を実行しているホストの場合:

     # yum install puppet-agent

3. 次のスクリプトを使用して、Puppet エージェントを現在のシェルの PATH に追加します。

   . /etc/profile.d/puppet-agent.sh

4. Puppet エージェントを設定します。ホストの所属先の Puppet 環境名に environment パラメーターを設定します。

   # puppet config set server satellite.example.com --section agent
   # puppet config set environment My_Puppet_Environment --section agent

5. Puppet エージェントサービスを開始します。

   # puppet resource service puppet ensure=running enable=true

6. ホストの証明書を作成します。

   # puppet ssl bootstrap

7. Satellite Web UI で、Infrastructure > Capsules に移動します。
8. 必要な Capsule Server の Actions コラムの一覧から、Certificates を選択します。
9. 必要なホストの右にある Sign をクリックして、Puppet エージェントの SSL 証明書に署名します。

10. ホスト上で、Puppet エージェントを再度実行します。

    # puppet ssl bootstrap

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 編集するホストの横の 編集 をクリックします。
3. インターフェイス タブで、インターフェイスの追加 をクリックします。
4. タイプ リストで、インターフェイス オプションが選択されている状態にします。
5. MAC アドレス を指定します。この設定は必須です。
6. eth0 などの デバイス ID を指定します。ボンディングインターフェイス、VLAN、エイリアスの作成時に、この ID を使用してこの物理インターフェイスを指定します。
7. ホストの IP アドレスに関連付けられた DNS 名 を指定します。Satellite は、選択したドメイン (DNS A フィールド) に関連付けられた Capsule Server、および選択したサブネット (DNS PTR フィールド) に関連付けられた Capsule Server にこの名前を保存します。そのため、1 台のホストに複数の DNS エントリーを持たせることができます。
8. ドメイン リストからドメインを選択します。ドメインを作成して管理するには、インフラストラクチャー > ドメイン に移動します。
9. サブネット リストからサブネットを選択します。サブネットを作成して管理するには、インフラストラクチャー > サブネット に移動します。
10. IP アドレス を指定します。DHCP Capsule Server が割り当てられたマネージドインターフェイスでは、DHCP リースを作成するためにこの設定が必要です。DHCP が有効になっているマネージドインターフェイスでは、IP アドレスが自動補完されます。
11. インターフェイスが マネージド かどうかを選択します。インターフェイスがマネージドの場合は、プロビジョニング時に関連付けられた Capsule Server から設定がプルされ、DNS エントリーおよび DHCP エントリーが作成されます。キックスタートのプロビジョニングを使用している場合には、設定ファイルはインターフェイス用に自動的に作成されます。
12. ホストの プライマリー インターフェイスかどうかを選択します。プライマリーインターフェイスからの DNS 名を、FQDN のホストの部分として使用します。
13. ホストの プロビジョニング インターフェイスかどうかを選択します。TFTP ブートは、プロビジョニングインターフェイスを使用します。イメージベースのプロビジョニングの場合は、プロビジョニングを完了するスクリプトは、プロビジョニングインターフェイスを使用してプロビジョニングを完了します。
14. リモート実行 のインターフェイスを使用するかどうかを選択します。
15. 仮想 NIC チェックボックスのチェックを解除したままにします。
16. OK をクリックして、インターフェイス設定を保存します。
17. 送信 をクリックして、ホストへの変更を適用します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 編集するホストの横の 編集 をクリックします。
3. インターフェイス タブで、インターフェイスの追加 をクリックします。
4. タイプ リストで、インターフェイス オプションが選択されている状態にします。

5. 一般的なインターフェイス設定を指定します。適用できる設定オプションは、物理インターフェイスのオプションと同じです (「物理インターフェイスの追加」 を参照)。

   マネージドの仮想インターフェイスの MAC アドレス を指定し、プロビジョニング用の設定ファイルが適切に生成されるようにします。ただし、MAC アドレス は、マネージド外の仮想インターフェイスには不要です。

   VLAN を作成する場合、デバイス ID フィールドに eth1.10 の形式で ID を指定します。エイリアスを作成する場合は、eth1:10 の形式で ID を使用します。

6. 仮想 NIC チェックボックスを選択します。仮想インターフェイスに固有の追加設定オプションがその形式に追加されます。

   • タグ: オプションで VLAN タグを設定して、物理ネットワークから仮想インターフェイスにネットワークセグメントを分割します。タグを指定しない場合は、管理インターフェイスは、関連のあるサブネットの VLAN タグを継承します。このフィールドでユーザーが指定したエントリーは、エイリアスインターフェイスには適用されません。
   • 割り当て先: eth1 など、仮想インターフェイスの所属先となる物理インターフェイスの ID を指定します。この設定は必須です。
7. OK をクリックして、インターフェイス設定を保存します。
8. 送信 をクリックして、ホストへの変更を適用します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 編集するホストの横の 編集 をクリックします。
3. インターフェイス タブで、インターフェイスの追加 をクリックします。
4. タイプ リストから ボンディング を選択します。タイプ固有の設定オプションがフォームに追加されます。

5. 一般的なインターフェイス設定を指定します。適用できる設定オプションは、物理インターフェイスのオプションと同じです (「物理インターフェイスの追加」 を参照)。

   ボンディングインターフェイスは、デバイス ID フィールドにある bond0 形式の ID を使用します。

   MAC アドレス 1 つで十分です。

   セカンダリーインターフェイスを追加する場合は、Managed を選択します。それ以外の場合、Satellite は設定を適用しません。

6. ボンディングインターフェイスに固有の設定オプションを指定します。

   • モード: フォールトトレランスおよび負荷分散のポリシーを定義するボンドモードを選択します。各ボンドモードの簡単な説明は、「Satellite で利用可能なボンディングモード」 を参照してください。
   • 割り当て済みデバイス: 割り当てられたデバイスの ID のコンマ区切りのリストを指定します。物理インターフェイスまたは VLAN を指定できます。
   • ボンドオプション: 設定オプションのコンマ区切りのリストを指定します (例: miimon=100)。ボンディングされたインターフェイスの設定オプションの詳細は、Red Hat Enterprise Linux のネットワークの設定および管理 ガイドの ネットワークボンディングの設定 を参照してください。
7. OK をクリックして、インターフェイス設定を保存します。
8. 送信 をクリックして、ホストへの変更を適用します。

手順

1. Capsule Server で BMC が有効になっていない場合には、有効にします。

   1. 以下のオプションを指定して satellite-installer スクリプトを実行し、Capsule Server で BMC 電源管理を設定します。

      # satellite-installer --foreman-proxy-bmc=true \
      --foreman-proxy-bmc-default-provider=ipmitool

   2. Satellite Web UI で、Infrastructure > Capsules に移動します。
   3. アクション コラムのリストから、更新 をクリックします。機能 コラムのリストに BMC が追加されているはずです。
2. Satellite Web UI で、ホスト > すべてのホスト に移動します。
3. 編集するホストの横の 編集 をクリックします。
4. インターフェイス タブで、インターフェイスの追加 をクリックします。
5. タイプ リストから BMC を選択します。タイプ固有の設定オプションがその形式に追加されます。
6. 一般的なインターフェイス設定を指定します。適用できる設定オプションは、物理インターフェイスのオプションと同じです (「物理インターフェイスの追加」 を参照)。

7. BMC インターフェイスに固有の設定オプションを指定する方法:

   • ユーザー名 および パスワード: BMC で必要な認証情報を指定します。
   • プロバイダー: BMC プロバイダーを指定します。
8. OK をクリックして、インターフェイス設定を保存します。
9. 送信 をクリックして、ホストへの変更を適用します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動し、RHEL Web コンソールを使用して管理および監視するホストを選択します。
2. ホストウィンドウの右上で Web コンソール をクリックします。

手順

1. 次の satellite-installer コマンドを実行します。

   satellite-installer --no-enable-foreman-plugin-remote-execution-cockpit

2. Satellite Web UI で、Administer > Settings に移動し、Remote execution タブをクリックします。
3. Cockpit URL 行で、Value の下の設定を消去し、Submit をクリックします。これにより、Satellite Web UI から Web Console ボタンが削除されます。

4. RHEL Web コンソールパッケージを Satellite からアンインストールします。

   dnf remove rubygem-foreman_remote_execution-cockpit

1. RedHatInsights.insights-client ロールをホストに追加します。

   新しいホストについては、「Red Hat Satellite でのホストの作成」 を参照してください。

   既存のホストについては、Red Hat Satellite での Ansible Integration を使用した設定の管理 の Ansible ロールを使用してクライアントの反復タスクを自動化する を参照してください。

2. RedHatInsights.insights-client ロールをホストで実行するには、ホスト > すべてのホスト に移動して、使用するホスト名をクリックします。
3. Ansible ロールの実行 ボタンをクリックします。

1. Satellite Web UI で、設定 > Insights に移動します。
2. Start Recommendations Sync ボタンをクリックします。

手順

1. Satellite Web UI で、設定 > Insights に移動します。

2. Red Hat Insights ページで、Insights プランに含める推奨事項の数を選択します。

   関連付けられた Playbook がある推奨事項のみを選択できます。

3. Remediate をクリックします。
4. Remediation Summary ウィンドウで、適用する 解決策 を選択します。Filter フィールドを使用して、特定のキーワードを検索します。
5. Remediate をクリックします。
6. Job Invocation ページで、事前完了フィールドの内容は変更しないでください。
7. オプション: リモート実行ジョブの詳細設定については、Show Advanced Fields をクリックします。
8. 必要なType of queryを選択します。
9. 必要なScheduleを選択します。
10. Submit をクリックします。

1. Satellite Web UI で、ホスト > すべてのホスト に 移動 します。
2. ホストを選択します。
3. ホストの詳細ページで、Recommendations をクリックします。
4. Red Hat Insights ページで、Insights プランに含める推奨事項の数を選択し、同様に続行します。

手順

1. Satellite Web UI で、監視 > レポートテンプレート に移動します。
2. 使用するレポートテンプレートの右にある、生成 をクリックします。
3. オプション: レポートをスケジュールするには、the 生成日時 フィールドの右側のアイコンをクリックして、レポートを生成する日時を選択します。
4. オプション: メールアドレスにレポートを送信するには、メールでレポートを送信する チェックボックスを選択して、配信先のメールアドレス フィールドで、必要なメールアドレスを入力します。
5. オプション: 検索クエリーフィルターを適用します。利用可能な結果すべてを表示するには、フィルターフィールドに何も値を投入しないでください。
6. Submit をクリックします。レポートが含まれれる CSV ファイルをダウンロードします。メールでレポートを送信する チェックボックスを選択した場合は、ホストの監視レポートがメールアドレスに送信されます。

CLI 手順

1. 利用可能なレポートテンプレートすべてをリストします。

   # hammer report-template list

2. レポートを生成します。

   # hammer report-template generate --id My_Template_ID

   このコマンドは、レポートが完全に生成されるまで待機してから完了します。レポートをバックグラウンドタスクとして生成する場合は、hammer report-template schedule コマンドを使用できます。

   注記

   サブスクリプションエンタイトルメントレポートを生成する場合は、Days from Now オプションを使用して、エンタイトルメントサブスクリプションの最新の有効期限を指定する必要があります。no limit 値を使用すると、すべてのエンタイトルメントを表示できます。

   すべてのエンタイトルメントを表示する

   # hammer report-template generate \
   --inputs "Days from Now=no limit" \
   --name "Subscription - Entitlement Report"

   60 日以内に有効期限が切れるすべてのエンタイトルメントを表示する

   # hammer report-template generate \
   --inputs "Days from Now=60" \
   --name "Subscription - Entitlement Report"

手順

1. Satellite Web UI で、監視 > レポートテンプレート に移動して、テンプレートの作成 をクリックします。
2. 名前 フィールドに、レポートテンプレートの一意名を入力します。
3. デフォルト を選択して、テンプレートをすべてのロケーションおよび組織で利用できるようにします。
4. テンプレートエディターで直接テンプレートを作成するか、インポート をクリックしてテキストファイルからテンプレートをインポートします。テンプレートのインポートに関する詳細は、「レポートテンプレートのインポート」 を参照してください。
5. オプション: 監査コメント フィールドで、このテンプレートに関する有用な情報を追加できます。
6. 入力 タブをクリックし、名前 フィールドに、テンプレートで参照できる入力の名前を input('name') 形式で入力します。テンプレート本文でこの入力値を参照する前に、テンプレートを保存する必要がある点にご留意ください。
7. 入力値が必須かどうかを選択します。入力値が必須の場合は、必須 チェックボックスをクリックします。
8. 値のタイプ リストから、ユーザーが入力しなければならない入力値のタイプを選択します。
9. オプション: テンプレートの入力にファクトを使用する場合は、詳細 チェックボックスをクリックします。
10. オプション: オプション フィールドで、ユーザーが選択できるオプションを定義します。このフィールドが未定義のままである場合、ユーザーは必要な値を入力できるフリーテキストフィールドを受け取ります。
11. オプション: デフォルト フィールドに、デフォルトのテンプレート入力として設定する値 (ホスト名など) を入力します。
12. オプション: 説明 フィールドに、レポートの生成時に入力に関するインラインヘルプとして表示する情報を入力できます。
13. オプション: タイプ タブをクリックして、このテンプレートが他のテンプレートに追加されるスニペットかどうかを選択します。
14. ロケーション タブをクリックして、テンプレートを使用するロケーションを追加します。
15. 組織 タブをクリックして、テンプレートを使用する組織を追加します。
16. Submit をクリックして変更を保存します。

手順

1. Satellite Web UI で、監視 > レポートテンプレート に移動します。
2. エクスポートするテンプレートを特定し、アクション コラムのリストから エクスポート を選択します。
3. ダウンロードするすべてのレポートテンプレートに対して、この操作を繰り返します。

CLI 手順

1. エクスポートで利用可能なレポートテンプレートを表示するには、以下のコマンドを入力します。

   # hammer report-template list

   このコマンドの出力で、エクスポートするテンプレートのテンプレート ID をメモします。

2. レポートテンプレートをエクスポートするには、以下のコマンドを実行します。

   # hammer report-template dump --id My_Template_ID > example_export.erb

手順

1. 以下のリクエストを使用して、使用可能なレポートテンプレートのリストを取得します。

   要求例:

   $ curl --insecure --user admin:redhat \
   --request GET \
   --config https://satellite.example.com/api/report_templates \
   | json_reformat

   この例では、json_reformat ツールを使用して JSON 出力をフォーマットしています。

   応答例:

   {
       "total": 6,
       "subtotal": 6,
       "page": 1,
       "per_page": 20,
       "search": null,
       "sort": {
           "by": null,
           "order": null
       },
       "results": [
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applicable errata",
               "id": 112
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applied Errata",
               "id": 113
           },
           {
               "created_at": "2019-11-30 16:15:24 UTC",
               "updated_at": "2019-11-30 16:15:24 UTC",
               "name": "Hosts - complete list",
               "id": 158
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Host statuses",
               "id": 114
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Registered hosts",
               "id": 115
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Subscriptions",
               "id": 116
           }
       ]
   }

2. エクスポートするテンプレートの id をメモし、以下のリクエストを使用してテンプレートをエクスポートします。

   要求例:

   $ curl --insecure --output /tmp/_Example_Export_Template.erb_ \
   --user admin:password --request GET --config \
   https://satellite.example.com/api/report_templates/My_Template_ID/export

   158 は、エクスポートするテンプレートの ID の例である点にご留意ください。

   この例では、エクスポートされたテンプレートは、host_complete_list.erb にリダイレクトされます。

手順

1. Satellite Web UI で、監視 > レポートテンプレート に移動します。
2. Report Templates ウィンドウの右上にある Create Template をクリックします。
3. エディター タブの右上にあるフォルダーアイコンをクリックし、インポートする .erb ファイルを選択します。
4. 要件に合わせてテンプレートを編集します。
5. Submit をクリックします。

手順

1. 以下の例を使用して、.json ファイルにインポートするテンプレートをフォーマットします。

   # cat Example_Template.json
   {
       "name": "Example Template Name",
       "template": "
       Enter ERB Code Here
   "
   }

   ERB テンプレートを含む JSON ファイルの例:

   {
       "name": "Hosts - complete list",
       "template": "
   <%#
   name: Hosts - complete list
   snippet: false
   template_inputs:
   - name: host
     required: false
     input_type: user
     advanced: false
     value_type: plain
     resource_type: Katello::ActivationKey
   model: ReportTemplate
   -%>
   <% load_hosts(search: input('host')).each_record do |host| -%>
   <%
         report_row(
             'Server FQDN': host.name
         )
   -%>
   <%  end -%>
   <%= report_render %>
   "
   }

2. 以下のリクエストを使用して、テンプレートをインポートします。

   $ curl --insecure --user admin:redhat \
   --data @Example_Template.json --header "Content-Type:application/json" \
   --request POST --config https://satellite.example.com/api/report_templates/import

3. 以下のリクエストを使用して、レポートテンプレートのリストを取得し、Satellite でテンプレートを表示できることを確認します。

   $ curl --insecure --user admin:redhat \
    --request GET --config https://satellite.example.com/api/report_templates | json_reformat

手順

1. Satellite Web UI で、監視 > レポートテンプレート に移動して、テンプレートの作成 をクリックします。

2. オプション: エディター フィールドで <%# > タグを使用し、後の参照用として役立つと思われる情報を含むコメントを追加します。以下に例を示します。

   <%#
   name: Entitlements
   snippet: false
   model: ReportTemplate
   require:
   - plugin: katello
     version: 3.14.0
   -%>

3. load_hosts() マクロを使用して行を追加し、以下のメソッドと変数をマクロに入力します。

   <%- load_hosts(includes: [:lifecycle_environment, :operatingsystem, :architecture, :content_view, :organization, :reported_data, :subscription_facet, :pools => [:subscription]]).each_record do |host| -%>

   使用できる変数のリストを表示するには、ヘルプ タブをクリックし、セーフモードのメソッドと変数 の表で、Host::Managed 行 を探します。

4. each メソッドを使用して、host.pools 変数で行を追加します。以下に例を示します。

   <%- host.pools.each do |pool| -%>

   注記

   プール は、Simple Content Access (SCA)以外の組織でのみ機能します。

5. report_row() メソッドで行を追加してレポートを作成し、レポートの一部としてターゲットにする変数を追加します。

   <%-     report_row(
             'Name': host.name,
             'Organization': host.organization,
             'Lifecycle Environment': host.lifecycle_environment,
             'Content View': host.content_view,
             'Host Collections': host.host_collections,
             'Virtual': host.virtual,
             'Guest of Host': host.hypervisor_host,
             'OS': host.operatingsystem,
             'Arch': host.architecture,
             'Sockets': host.sockets,
             'RAM': host.ram,
             'Cores': host.cores,
             'SLA': host_sla(host),
             'Products': host_products(host),
             'Subscription Name': sub_name(pool),
             'Subscription Type': pool.type,
             'Subscription Quantity': pool.quantity,
             'Subscription SKU': sub_sku(pool),
             'Subscription Contract': pool.contract_number,
             'Subscription Account': pool.account_number,
             'Subscription Start': pool.start_date,
             'Subscription End': pool.end_date,
             'Subscription Guest': registered_through(host)
             ) -%>

6. テンプレートに終了ステートメントを追加します。

   <%-   end -%>
   <%- end -%>

7. レポートを生成するには、<%= report_render -%> マクロを追加する必要があります。

   <%= report_render -%>

8. 送信 をクリックしてテンプレートを保存します。

手順

1. Satellite Web UI で、Hosts > Host Collections に移動します。
2. New Host Collection をクリックします。
3. ホストコレクションの Name を追加します。
4. Unlimited Content Hosts を削除して、Limit フィールドにホストの最大数を入力します。
5. ホストコレクションの Description を追加します。
6. Save をクリックします。

手順

1. Satellite Web UI で、Hosts > Host Collections に移動します。
2. 左側のパネルで、クローンを作成するホストコレクションをクリックします。
3. コレクションのコピー をクリックします。
4. クローン作成されたコレクションの名前を指定します。
5. 作成 をクリックします。

手順

1. Satellite Web UI で、ホスト > ホストコレクション に移動します。
2. 削除するホストコレクションを選択します。

3. Remove をクリックします。警告ボックスが表示されます。

   Are you sure you want to remove host collection Host Collection Name?

4. Remove をクリックします。

手順

1. Satellite Web UI で、Hosts > Host Collections に移動します。
2. ホストの追加先となるホストコレクションを選択します。
3. ホスト タブで、追加 サブタブを選択します。
4. テーブルから追加するホストを選択してから、選択項目の追加 をクリックします。

手順

1. Satellite Web UI で、Hosts > Host Collections に移動します。
2. 必要なホストコレクションを選択します。
3. ホスト タブで、リスト表示/削除 サブタブを選択します。
4. ホストコレクションから削除するホストを選択し、選択項目の削除 をクリックします。

1. Satellite は、Remote execution のチェックボックスが選択されているホストのインターフェイスを検出します。
2. Satellite はこれらのインターフェイスのサブネットを検出します。
3. Satellite は、これらのサブネットに割り当てられたリモート実行 Capsule を検出します。
4. この Capsule のセットから、Satellite は実行中のジョブの数が最も少ない Capsule を選択します。こうすることで、Satellite はリモート実行 Capsule 間でのジョブの負荷を確実に分散させます。

手順

1. ホストに katello-pull-transport-migrate パッケージをインストールします。

   • Red Hat Enterprise Linux 8 ホストおよび Red Hat Enterprise Linux 9 ホストの場合:

     # dnf install katello-pull-transport-migrate

   • Red Hat Enterprise Linux 7 ホストの場合:

     # yum install katello-pull-transport-migrate

   このパッケージは、依存関係として foreman_ygg_worker および yggdrasil をインストールし、ホストでプルモードを有効にします。ホストの subscription-manager 設定およびコンシューマー証明書は、ホストで yggdrasil クライアントを設定するために使用され、プルモードのクライアントワーカーを起動します。

2. オプション: プルクライアントが実行中であり、適切に設定されていることを確認するには、yggdrasild サービスのステータスを確認します。

   # systemctl status yggdrasild

3. オプション: パッケージのインストール後に、ホストから katello-agent を削除できます。

   警告

   お使いのホストが Red Hat Virtualization のバージョン 4.4 以下にインストールされている場合は、削除された依存関係によりホストが破損するので、katello-agent パッケージを削除しないでください。

手順

1. Satellite Web UI で、ホスト > ジョブテンプレート に移動します。
2. 新規ジョブテンプレート をクリックします。
3. テンプレート タブをクリックして、名前 フィールドにジョブテンプレートの一意名を入力します。
4. デフォルト を選択して、テンプレートをすべての組織およびロケーションで利用できるようにします。
5. テンプレートエディターで直接テンプレートを作成するか、インポート をクリックしてテキストファイルからテンプレートをアップロードします。
6. オプション: 監査コメント フィールドで、変更に関する情報を追加します。
7. Job タブをクリックし、Job category フィールドに独自のカテゴリーを入力するか、ホストの管理 の デフォルトのジョブテンプレートカテゴリー にリストされているデフォルトカテゴリーから選択します。
8. オプション: 説明形式 フィールドで説明テンプレートを入力します。(例: Install package %{package_name})。また、テンプレートでは %{template_name} および %{job_category} も使用できます。
9. プロバイダータイプ リストから、Shell スクリプトに SSH を、Ansible タスクまたは Playbook に Ansible を選択します。
10. オプション: Timeout to kill フィールドで、ジョブが完了しない場合に、ジョブを中断するタイムアウトの値を入力します。
11. オプション: 入力を追加 をクリックし、入力パラメーターを定義します。ジョブの実行時にパラメーターを要求し、テンプレートに定義する必要はありません。各種サンプルについては、ヘルプ タブを参照してください。
12. オプション: 外部入力セット をクリックして、このジョブの他のテンプレートを追加します。
13. オプション: 実効ユーザー エリアで、コマンドでデフォルトの remote_execution_effective_user 設定を使用できない場合に、ユーザーを設定します。
14. オプション: このテンプレートをスニペットとして他のテンプレートに追加する場合は、タイプ タブをクリックして、スニペット を選択します。
15. ロケーション タブをクリックして、テンプレートを使用するロケーションを追加します。
16. 組織 タブをクリックして、テンプレートを使用する組織を追加します。
17. Submit をクリックして変更を保存します。

手順

1. 以下の API 要求を使用して、利用可能な Ansible Playbook を取得します。

   # curl -X GET -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/fetch?proxy_id=My_capsule_ID

2. インポートする Ansible Playbook を選択し、その名前を書き留めます。

3. Ansible Playbook をその名前でインポートします。

   # curl -X PUT -H 'Content-Type: application/json' -d '{ "playbook_names": ["My_Playbook_Name"] }' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My_capsule_ID

   インポートが完了すると、Satellite Web UI で通知が表示されます。

手順

1. Satellite Web UI で、Administer > Settings に移動します。
2. Remote Execution をクリックします。
3. 任意の Capsule へのフォールバック を設定します。

手順

1. Satellite Web UI で、Administer > Settings に移動します。
2. Remote Execution をクリックします。
3. グローバル Capsule の有効化 を設定します。

手順

1. ホスト上で、新しいディレクトリーを作成します。

   # mkdir /My_Remote_Working_Directory

2. デフォルトの /var/tmp ディレクトリーから SELinux コンテキストをコピーします。

   # chcon --reference=/var/tmp /My_Remote_Working_Directory

3. 新しいディレクトリーを使用するように Satellite Server または Capsule Server を設定します。

   # satellite-installer \
   --foreman-proxy-plugin-remote-execution-script-remote-working-dir /My_Remote_Working_Directory

1. 新しいディレクトリーを作成します。

   # mkdir /My_Remote_Working_Directory

2. yggdrasild サービス設定にアクセスします。

   # systemctl edit yggdrasild

3. 次の行を設定に追加して、代替ディレクトリーを指定します。

   Environment=FOREMAN_YGG_WORKER_WORKDIR=/My_Remote_Working_Directory

4. yggdrasild サービスを再起動します。

   # systemctl restart yggdrasild

手順

1. Administer > Settings に移動します。
2. Remote Execution タブを選択します。
3. Effective User Method 設定の値をクリックします。
4. 新しい値を選択します。
5. Submit をクリックします。

1. 「リモート実行用の SSH 鍵の手動での配布」
2. 「Satellite API を使用したリモート実行用の SSH 鍵の取得」
3. 「プロビジョニング中に SSH キーを配布するためのキックスタートテンプレートの設定」
4. 新しい Satellite ホストの場合、グローバル登録テンプレートを使用して、登録中に SSH 鍵を Satellite ホストにデプロイすることができます。詳細は、ホストの管理 の グローバル登録テンプレートを使用した Red Hat Satellite へのホストの登録 を参照してください。

手順

1. ターゲットホストで ~/.ssh ディレクトリーを作成し、SSH 鍵を保存します。

   # mkdir ~/.ssh

2. Capsule から SSH 鍵をダウンロードします。

   # curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys

3. ~/.ssh ディレクトリーのパーミッションを設定します。

   # chmod 700 ~/.ssh

4. authorized_keys ファイルのパーミッションを設定します。

   # chmod 600 ~/.ssh/authorized_keys

手順

1. foreman-proxy ユーザーの ID を特定します。

   # id -u foreman-proxy

2. 新しいファイルのパーミッションが 600 になるように、umask の値を変更します。

   # umask 077

3. Keytab のディレクトリーを作成します。

   # mkdir -p "/var/kerberos/krb5/user/My_User_ID"

4. Keytab を作成するか、既存の Keytab をディレクトリーにコピーします。

   # cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytab

5. ディレクトリーの所有者を foreman-proxy ユーザーに変更します。

   # chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"

6. keytab ファイルが読み取り専用であることを確認します。

   # chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"

7. SELinux コンテキストを復元します。

   # restorecon -RvF /var/kerberos/krb5

手順

1. リモート実行に Kerberos 認証をインストールおよび有効にするには、以下のコマンドを入力します。

   # satellite-installer --scenario satellite \
   --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth true

2. リモート実行のデフォルトユーザーを編集するには、Satellite Web UI で Administer > Settings に移動して、Remote Execution タブをクリックします。SSH User 行で 2 番目のコラムを編集し、Kerberos アカウントのユーザー名を追加します。
3. remote_execution_effective_user に移動し、2 番目のコラムを編集して、Kerberos アカウントのユーザー名を追加します。

手順

1. テンプレートのクローンを作成するには、アクション コラムで、クローン を選択します。
2. クローンに一意名を指定して、送信 をクリックして変更を保存します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動し、リモートジョブを実行するターゲットホストを選択します。検索フィールドを使用してホストのリストを絞り込むことができます。
2. アクションの選択 リストから ジョブのスケジュール を選択します。
3. ジョブ呼び出し ページで、主なジョブ設定を定義します。
4. 使用する ジョブカテゴリー および ジョブテンプレートを選択します。
5. オプション: ブックマーク リストに保存された検索文字列を選択し、ターゲットホストを指定します。
6. オプション: 検索クエリー を入力し、ターゲットホストの範囲をさらに狭めることができます。解決 行には、クエリーの影響を受けるホストの数が表示されます。更新ボタンを押して、クエリー変更後の数を再計算します。プレビューアーイコンにはターゲットホストがリスト表示されます。
7. 残りの設定は、選択したジョブテンプレートによって異なります。カスタムパラメーターをテンプレートに追加する方法の詳細は、ジョブテンプレートの作成 を参照してください。

8. オプション: ジョブの詳細設定を行うには、詳細フィールドの表示 をクリックします。一部の詳細設定はジョブテンプレートによって異なります。以下は一般的な設定です。

   • 実効ユーザー: ジョブを実行するためにユーザーを定義します。デフォルトは SSH ユーザーです。
   • 同時実行レベル は一度に実行するジョブの最大数を定義します。この定義で、多数のホストでジョブを実行する時に、システムのリソースに負荷が過剰にかかるのを防ぐことができます。
   • Timeout to kill は、ジョブが終了しない場合に、ジョブの強制終了までの間隔 (秒単位) を定義します。以前のタスクが終了するまで時間がかかりすぎているなど、定義した間隔で起動できなかったタスクはキャンセルされます。
   • クエリーのタイプ: 検索クエリーが評価されるタイミングを定義します。これは、スケジュールされているタスクに対してクエリーが常に最新の状態に保つのに役立ちます。

   • 実行順序 は、ジョブがホストで実行される順序を決定します (アルファベット順またはランダム)。

     同時実行レベル および Timeout to kill 設定により、お使いのインフラストラクチャーハードウェアおよびニーズに合わせてジョブ実行を調整することができます。

9. ジョブをすぐに実行する場合は、スケジュール が 今すぐ実行 に設定されていることを確認します。さらに、1 回限りのジョブを未来の日付で定義したり、定期的なジョブを設定することもできます。定期的なジョブについては、開始日と終了日、実行回数と頻度を定義できます。また cron 構文を使用して繰り返しを定義することもできます。cron の詳細は、cron での Linux システムタスクの自動化 を参照してください。
10. Submit をクリックします。同じページの Recent Jobs セクションでジョブのステータスを表示できます。

CLI 手順

1. Satellite で以下のコマンドを入力します。

   # hammer settings set \
   --name=remote_execution_global_proxy \
   --value=false

2. 使用するジョブテンプレートの ID を検出します。

   # hammer job-template list

3. テンプレートの詳細を表示して、テンプレートに必要なパラメーターを確認します。

   # hammer job-template info --id My_Template_ID

4. カスタムパラメーターでリモートジョブを実行します。

   # hammer job-invocation create \
   --inputs My_Key_1="My_Value_1",My_Key_2="My_Value_2",... \
   --job-template "My_Template_Name" \
   --search-query "My_Search_Query"

   My_Search_Query は、ホストを定義するフィルター式 (例: "name ~ My_Pattern ") に置き換えます。hammer を使用したリモートコマンド実行に関する詳細については、hammer job-template --help および hammer job-invocation --help を入力します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動し、リモートジョブを実行するターゲットホストを選択します。
2. Ansible タブで、ジョブ を選択します。
3. Schedule recurring job をクリックします。
4. Create New Recurring Ansible Run ウィンドウで、最初の実行の繰り返し頻度、開始時刻、日付を定義します。
5. Submit をクリックします。
6. オプション: ホストの概要で、または Ansible > Jobs に移動して、スケジュールされた Ansible ジョブを表示します。

手順

1. Satellite Web UI で、Configure > Host groups に移動します。
2. Actions 列で、Ansible ロールの実行をスケジュールするホストグループの Configure Ansible Job を選択します。
3. Schedule recurring job をクリックします。
4. Create New Recurring Ansible Run ウィンドウで、最初の実行の繰り返し頻度、開始時刻、日付を定義します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Monitor > Jobs に移動します。このページは、Execute now が設定されているジョブをトリガーすると自動的に表示されます。スケジュールされたジョブを監視するには、監視 > ジョブ に移動して、検査するジョブ実行を選択します。
2. ジョブページで、ホスト タブをクリックします。これにより、ジョブが実行しているホストのリストが表示されます。
3. ホスト コラムで、検査するホストの名前をクリックします。これにより、ジョブの実行をリアルタイムで監視できる コマンドの詳細 ページが表示されます。
4. いつでも ジョブに戻る をクリックして、ジョブの詳細 ページに戻ることができます。

CLI 手順

1. ジョブの ID を検出します。

   # hammer job-invocation list

2. ジョブの出力を監視します。

   # hammer job-invocation output \
   --host "My_Host_Name" \
   --id My_Job_ID

3. オプション: ジョブをキャンセルするには、次のコマンドを入力します。

   # hammer job-invocation cancel \
   --id My_Job_ID

手順

1. Satellite Server でプラグインを有効化するには、以下のコマンドを入力します。

   # satellite-installer --enable-foreman-plugin-templates

2. プラグインが適切にインストールされていることを確認するには、管理 > 設定 に TemplateSync メニューがあることを確認します。

手順

1. Satellite インストーラーを使用するプラグインを無効にします。

   # satellite-installer --no-enable-foreman-plugin-templates

2. プラグインのカスタムデータを削除します。このコマンドは、作成したテンプレートには影響しません。

   # foreman-rake templates:cleanup

3. プラグインをアンインストールします。

   # satellite-maintain packages remove foreman-plugin-templates

手順

1. Satellite Web UI で、Hosts > All Hosts に移動し、パッケージをインストールするホストを選択します。
2. Content タブで、 Packages タブを選択します。
3. アップグレードボタンの横にある縦の省略記号アイコンで、Install Packages をクリックします。
4. Install packages ウィンドウで、ホストにインストールするパッケージを選択します。
5. Install をクリックします。

API の手順

1. "job_invocation" オブジェクトを作成し、本文の残りの部分をこのオブジェクト内に配置します。
2. インストールするパッケージを指定する文字列型の "package" フィールドを持つ "inputs" オブジェクトを作成します。複数のパッケージを指定する場合は、空白で区切ります。
3. 値 "katello_package_install" を持つ文字列型の "feature" フィールドを作成します。
4. 文字列型の "search_query" フィールドを作成し、パッケージをインストールするホストに一致する検索クエリーを入力します。

5. オプション: 特定のユーザーとしてパッケージをインストールする場合は、次の文字列型のフィールドを持つ ssh オブジェクトを作成します。

   • ssh ユーザーの名前を含む "effective_user" フィールド
   • ssh ユーザーのパスワードを含む "effective_user_password" フィールド (このパスワードが必要な場合)

6. オプション: 後でパッケージをインストールする場合は、"scheduling" オブジェクトを作成します。このオブジェクトには、ISO 8601 形式の日付、時刻、タイムゾーンを含む、次の文字列型フィールドの 1 つまたは両方を含めることができます。

   • "start_at" - パッケージをインストールする時刻を設定します。
   • "start_before" - パッケージをインストールする最も遅い時刻を設定します。この時刻までにパッケージをインストールできない場合、このアクションはキャンセルされます。

   時刻を省略すると、デフォルトの 00:00:00 になります。タイムゾーンを省略した場合は、デフォルトで UTC が使用されます。

7. オプション: ジョブを同時に実行するホストの数を制限する場合は、整数型の "concurrency_level" フィールドを持つ "concurrency_control" オブジェクトを作成します。ホストの数をフィールドの値として割り当てます。
8. オプション: 後でパッケージをインストールし、ジョブの実行時にホスト検索クエリーを評価する場合は、"dynamic_query" 値を持つ文字列型の "targeting_type" フィールドを作成します。これは、ホストのステータスの変更により、ジョブの実行時に検索クエリーの結果が異なることが予想される場合に便利です。このフィールドを省略すると、デフォルトの "static_query" が使用されます。

9. 作成した本文を含む POST リクエストを Satellite Server の /api/job_invocations エンドポイントに送信し、Python などのツールを使用してフォーマットされた応答を確認します。

   API リクエストの例:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Content タブをクリックし、Packages タブをクリックします。
4. Status 一覧から Upgradable を選択します。
5. アップグレードするパッケージを選択します。
6. Upgrade ボタンをクリックします。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

API の手順

1. "job_invocation" オブジェクトを作成し、本文の残りの部分をこのオブジェクト内に配置します。
2. 更新するパッケージを指定する文字列型の "package" フィールドを持つ "inputs" オブジェクトを作成します。複数のパッケージを指定する場合は、空白で区切ります。
3. 値 "katello_package_update" を持つ文字列型の "feature" フィールドを作成します。
4. 文字列型の "search_query" フィールドを作成し、パッケージを更新するホストに一致する検索クエリーを入力します。

5. オプション: 特定のユーザーとしてパッケージを更新する場合は、次の文字列型のフィールドを持つ ssh オブジェクトを作成します。

   • ssh ユーザーの名前を含む "effective_user" フィールド
   • ssh ユーザーのパスワードを含む "effective_user_password" フィールド (このパスワードが必要な場合)

6. オプション: 後でパッケージを更新する場合は、"scheduling" オブジェクトを作成します。このオブジェクトには、ISO 8601 形式の日付、時刻、タイムゾーンを含む、次の文字列型フィールドの 1 つまたは両方を含めることができます。

   • "start_at" - パッケージを更新する時刻を設定します。
   • "start_before" - パッケージを更新する最も遅い時刻を設定します。この時刻までにパッケージを更新できない場合、このアクションはキャンセルされます。

   時刻を省略すると、デフォルトの 00:00:00 になります。タイムゾーンを省略した場合は、デフォルトで UTC が使用されます。

7. オプション: ジョブを同時に実行するホストの数を制限する場合は、整数型の "concurrency_level" フィールドを持つ "concurrency_control" オブジェクトを作成します。ホストの数をフィールドの値として割り当てます。
8. オプション: 後でパッケージを更新し、ジョブの実行時にホスト検索クエリーを評価する場合は、"dynamic_query" 値を持つ文字列型の "targeting_type" フィールドを作成します。これは、ホストのステータスの変更により、ジョブの実行時に検索クエリーの結果が異なることが予想される場合に便利です。このフィールドを省略すると、デフォルトの "static_query" が使用されます。

9. 作成した本文を含む POST リクエストを Satellite Server の /api/job_invocations エンドポイントに送信し、Python などのツールを使用してフォーマットされた応答を確認します。

   API リクエストの例:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Content タブをクリックし、Packages タブをクリックします。
4. 削除するパッケージの縦リーダーをクリックして、Remove を選択します。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

API の手順

1. "job_invocation" オブジェクトを作成し、本文の残りの部分をこのオブジェクト内に配置します。
2. 削除するパッケージを指定する文字列型の "package" フィールドを持つ "inputs" オブジェクトを作成します。複数のパッケージを指定する場合は、空白で区切ります。
3. 値 "katello_package_remove" を持つ文字列型の "feature" フィールドを作成します。
4. 文字列型の "search_query" フィールドを作成し、パッケージを削除するホストに一致する検索クエリーを入力します。

5. オプション: 特定のユーザーとしてパッケージを削除する場合は、次の文字列型のフィールドを持つ ssh オブジェクトを作成します。

   • ssh ユーザーの名前を含む "effective_user" フィールド
   • ssh ユーザーのパスワードを含む "effective_user_password" フィールド (このパスワードが必要な場合)

6. オプション: 後でパッケージを削除する場合は、"scheduling" オブジェクトを作成します。このオブジェクトには、ISO 8601 形式の日付、時刻、タイムゾーンを含む、次の文字列型フィールドの 1 つまたは両方を含めることができます。

   • "start_at" - パッケージを削除する時刻を設定します。
   • "start_before" - パッケージを削除する最も遅い時刻を設定します。この時刻までにパッケージを削除できない場合、このアクションはキャンセルされます。

   時刻を省略すると、デフォルトの 00:00:00 になります。タイムゾーンを省略した場合は、デフォルトで UTC が使用されます。

7. オプション: ジョブを同時に実行するホストの数を制限する場合は、整数型の "concurrency_level" フィールドを持つ "concurrency_control" オブジェクトを作成します。ホストの数をフィールドの値として割り当てます。
8. オプション: 後でパッケージを削除し、ジョブの実行時にホスト検索クエリーを評価する場合は、"dynamic_query" 値を持つ文字列型の "targeting_type" フィールドを作成します。これは、ホストのステータスの変更により、ジョブの実行時に検索クエリーの結果が異なることが予想される場合に便利です。このフィールドを省略すると、デフォルトの "static_query" が使用されます。

9. 作成した本文を含む POST リクエストを Satellite Server の /api/job_invocations エンドポイントに送信し、Python などのツールを使用してフォーマットされた応答を確認します。

   API リクエストの例:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool