Red Hat Satellite の管理

手順

1. Satellite Server の完全修飾ドメイン名を特定します。

   # hostname -f

2. Web ブラウザーで以下の完全修飾ドメイン名を指定して、Satellite Server の pub ディレクトリーにアクセスします。

   https://satellite.example.com/pub

3. Satellite に初めてアクセスする場合は、信頼できない接続を警告するメッセージが Web ブラウザーに表示されます。自己署名証明書を承認し、Satellite の URL をセキュリティー例外として追加し、設定を上書きします。この手順は、使用しているブラウザーによって異なる場合があります。セキュリティー例外を承認する前に Satellite の URL が有効であることを確認します。
4. katello-server-ca.crt を選択します。
5. 証明書を認証局としてブラウザーにインポートして信頼し、Web サイトを特定します。

CLI 手順

1. Satellite CLI から、Satellite web UI へのアクセスに使用するマシンに、katello-server-ca.crt ファイルをコピーします。

   # scp /var/www/html/pub/katello-server-ca.crt username@hostname:remotefile

2. ブラウザーで、katello-server-ca.crt 証明書を認証局としてインポートして信頼し、Web サイトを識別します。

手順

1. Web ブラウザーで以下の完全修飾ドメイン名を指定して、Satellite Server にアクセスします。

   https://satellite.example.com/

2. 設定プロセスで作成したユーザー名とパスワードを入力します。設定プロセス時にユーザーを作成されなかった場合は、デフォルトのユーザー名 admin が使用されます。ログインに問題がある場合は、パスワードをリセットできます。詳細は、「管理ユーザーパスワードのリセット」 を参照してください。

手順

1. Satellite ユーザーに代わって Kerberos Ticket-Granting Ticket (TGT) を取得します。

   $ kinit idm_user

   警告

   Red Hat Identity Management を認証プロバイダーとして設定するときに、Satellite API と Satellite Web UI の両方へのアクセスを有効にした場合、ユーザーが Kerberos TGT を受信した後に攻撃者が API セッションを取得できるようになります。ユーザーが以前にブラウザーなど、どこにも Satellite ログイン認証情報を入力していなかった場合でも、攻撃は可能です。

2. 自動ネゴシエート認証が有効になっていない場合は、TGT を使用して Hammer を手動で認証します。

   $ hammer auth login negotiate

3. オプション: コレクション内にある、キャッシュされたすべての Kerberos チケットを破棄します。

   $ kdestroy -A

手順

1. Red Hat Identity Management 認証情報を使用して、自分用の Kerberos Ticket-Granting ticket (TGT) を取得します。

   $ kinit idm_user
   Password for idm_user@EXAMPLE.COM:

2. ブラウザーのアドレスバーに、Satellite Server の URL を入力します。

   自動的にログインされます。

手順

1. Chrome ブラウザーで Kerberos 認証を使用できるようにします。

   $ google-chrome --auth-server-whitelist=".example.com" --auth-negotiate-delegate-whitelist=”.example.com"

   注記

   ドメイン全体を許可リストに登録する代わりに、特定の Satellite Server を許可リストに登録することもできます。

2. Red Hat Identity Management 認証情報を使用して、自分用の Kerberos Ticket-Granting Ticket (TGT) を取得します。

   $ kinit idm_user
   Password for idm_user@_EXAMPLE.COM:

3. ブラウザーのアドレスバーに、Satellite Server の URL を入力します。

   自動的にログインされます。

手順

1. Satellite Web UI で、右上隅のユーザー名をクリックします。
2. メニューから マイアカウント を選択します。
3. 現在のパスワード フィールドに現在のパスワードを入力します。
4. パスワード フィールドに新しいパスワードを入力します。
5. 確認 フィールドに新しいパスワードを再入力します。
6. Submit をクリックして新しいパスワードを保存します。

管理ユーザーパスワードのリセット:

1. Satellite Server がインストールされているベースのオペレーティングシステムにログインします。

2. 以下のコマンドを実行してパスワードをリセットします。

   # foreman-rake permissions:reset
   Reset to user: admin, password: qwJxBptxb7Gfcjj5

3. このパスワードを使用して、Satellite Web UI でパスワードをリセットします。

4. Satellite Server の ~/.hammer/cli.modules.d/foreman.yml ファイルを編集し、新規パスワードを追加します。

   # vi ~/.hammer/cli.modules.d/foreman.yml

新規の管理ユーザーパスワードの設定:

1. Satellite Server がインストールされているベースのオペレーティングシステムにログインします。

2. パスワードをリセットするには、以下のコマンドを入力します。

   # foreman-rake permissions:reset password=new_password

3. Satellite Server の ~/.hammer/cli.modules.d/foreman.yml ファイルを編集し、新規パスワードを追加します。

   # vi ~/.hammer/cli.modules.d/foreman.yml

手順

1. Satellite web UI で、Administer > Settings に移動して、General タブをクリックします。
2. ログインページフッターテキスト の横にある編集ボタンをクリックして、ログインページに表示させるテキストを入力します。たとえば、自社で必須とされる警告メッセージなどにすることができます。
3. Save をクリックします。
4. Satellite web UI からログアウトして、ログインページで Satellite バージョン番号の下にカスタムテキストが表示されることを確認します。

1. ソースサーバーをバックアップします。
2. ソースサーバーからターゲットサーバーにクローンを作成します。
3. ソースサーバーの電源を切断します。
4. 新規ホスト名とターゲットサーバーの IP アドレスが一致するように、ターゲットサーバー上のネットワーク設定を更新します。
5. 非推奨の Katello Agent を使用しているコンテンツホストがある場合は、それらすべてのコンテンツホストとその Capsule で goferd サービスを再起動して、接続を更新します。
6. 新規ターゲットサーバーをテストします。

1. PostgreSQL データベースをアクティブにし、Pulp データは除外してバックアップを実行します。

   # satellite-maintain backup offline --skip-pulp-content \
   --assumeyes /var/backup

2. Satellite サービスを停止して無効にします。

   # satellite-maintain service stop
   # satellite-maintain service disable

3. Pulp データをターゲットサーバーにコピーします。

   # rsync --archive --partial --progress --compress \
   /var/lib/pulp/ target_server.example.com:/var/lib/pulp/

手順

1. Satellite Infrastructure サブスクリプションの割り当て の手順に従って、Satellite サブスクリプションをサーバーに割り当てます。

2. すべてのリポジトリーを無効にし、以下のリポジトリーのみを有効にします。

   # subscription-manager repos --disable '*'
   # subscription-manager repos \
   --enable=satellite-6.14-for-rhel-8-x86_64-rpms \
   --enable=satellite-maintenance-6.14-for-rhel-8-x86_64-rpms \
   --enable=rhel-8-for-x86_64-baseos-rpms \
   --enable=rhel-8-for-x86_64-appstream-rpms

3. 次のモジュールを有効にします。

   # dnf module enable satellite:el8

   注記

   モジュール satellite:el8 を有効にすると、postgresql:10 および ruby:2.5 との競合について警告が表示されます。これは、これらのモジュールが Red Hat Enterprise Linux 8 でデフォルトのモジュールバージョンに設定されているためです。モジュール satellite:el8 には、モジュール postgresql:12 および ruby:2.7 への依存関係があり、satellite:el8 モジュールで有効になります。これらの警告はインストールプロセスの失敗の原因にはならないため、安全に無視できます。Red Hat Enterprise Linux 8 のモジュールとライフサイクルストリームの詳細は、Red Hat Enterprise Linux Application Streams のライフサイクル を参照してください。

手順

1. PostgreSQL をインストールするには、以下のコマンドを入力します。

   # dnf install postgresql-server postgresql-evr postgresql-contrib

2. PostgreSQL を初期化するには、以下のコマンドを入力します。

   # postgresql-setup initdb

3. /var/lib/pgsql/data/postgresql.conf ファイルで以下を行います。

   # vi /var/lib/pgsql/data/postgresql.conf

   Satellite で機能するには、外部 PostgreSQL のデフォルト設定を調整する必要があることに注意してください。基本的に推奨される外部データベース設定の調整は次のとおりです。

   • checkpoint_completion_target: 0.9
   • max_connections: 500
   • shared_buffers: 512MB
   • work_mem: 4MB

4. # を削除して、着信接続をリッスンするようにします。

   listen_addresses = '*'

5. /var/lib/pgsql/data/pg_hba.conf ファイルを編集します。

   # vi /var/lib/pgsql/data/pg_hba.conf

6. 以下の行をファイルに追加します。

     host  all   all   Satellite_ip/32   md5

7. PostgreSQL サービスを起動し、有効にするには、以下のコマンドを実行します。

   # systemctl enable --now postgresql

8. 外部 PostgreSQL サーバーで postgresql ポートを開きます。

   # firewall-cmd --add-service=postgresql
   # firewall-cmd --runtime-to-permanent

9. postgres ユーザーに切り替え、PostgreSQL クライアントを起動します。

   $ su - postgres -c psql

10. 3 つのデータベースと専用のロールを作成します。1 つは Satellite 用、1 つは Candlepin 用、もう 1 つは Pulp 用です。

    CREATE USER "foreman" WITH PASSWORD 'Foreman_Password';
    CREATE USER "candlepin" WITH PASSWORD 'Candlepin_Password';
    CREATE USER "pulp" WITH PASSWORD 'Pulpcore_Password';
    CREATE DATABASE foreman OWNER foreman;
    CREATE DATABASE candlepin OWNER candlepin;
    CREATE DATABASE pulpcore OWNER pulp;

11. Pulp データベースに接続します。

    postgres=# \c pulpcore
    You are now connected to database "pulpcore" as user "postgres".

12. hstore エクステンションを作成します。

    pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
    CREATE EXTENSION

13. postgres ユーザーをログアウトします。

    # \q

14. Satellite Server から、データベースにアクセスできることをテストします。接続に成功した場合には、コマンドは 1 を返します。

    # PGPASSWORD='Foreman_Password' psql -h postgres.example.com  -p 5432 -U foreman -d foreman -c "SELECT 1 as ping"
    # PGPASSWORD='Candlepin_Password' psql -h postgres.example.com -p 5432 -U candlepin -d candlepin -c "SELECT 1 as ping"
    # PGPASSWORD='Pulpcore_Password' psql -h postgres.example.com -p 5432 -U pulp -d pulpcore -c "SELECT 1 as ping"

手順

1. Satellite Server で Satellite サービスを停止します。

   # satellite-maintain service stop

2. PostgreSQL サービスを起動します。

   # systemctl start postgresql

3. 内部データベースのバックアップを作成します。

   # satellite-maintain backup online \
   --preserve-directory \
   --skip-pulp-content \
   /var/migration_backup

4. データを新規外部データベースに転送します。

   PGPASSWORD='Foreman_Password' pg_restore -h postgres.example.com -U foreman -d foreman < /var/migration_backup/foreman.dump
   PGPASSWORD='Candlepin_Password' pg_restore -h postgres.example.com -U candlepin -d candlepin < /var/migration_backup/candlepin.dump
   PGPASSWORD='Pulpcore_Password' pg_restore -h postgres.example.com -U pulp -d pulpcore < /var/migration_backup/pulpcore.dump

5. satellite-installer コマンドを使用して Satellite が新規データベースを参照するように更新します。

   # satellite-installer --scenario satellite \
   --foreman-db-database foreman \
   --foreman-db-host postgres.example.com \
   --foreman-db-manage false \
   --foreman-db-password Foreman_Password \
   --foreman-db-username foreman \
   --foreman-proxy-content-pulpcore-manage-postgresql false \
   --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
   --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
   --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
   --foreman-proxy-content-pulpcore-postgresql-user pulp \
   --katello-candlepin-db-host postgres.example.com \
   --katello-candlepin-db-name candlepin \
   --katello-candlepin-db-password Candlepin_Password \
   --katello-candlepin-db-user candlepin \
   --katello-candlepin-manage-db false

手順

1. Satellite Web UI で、Administer > Organizations に移動します。
2. 新規組織 をクリックします。
3. 名前 フィールドに、組織の名前を入力します。
4. ラベル フィールドには、組織の一意識別子を入力します。これは、コンテンツストレージのディレクトリーなど、特定のアセットを作成し、マッピングするために使用されます。文字、数字、アンダースコア、およびダッシュを使用し、スペースは使用しないでください。

5. オプション: Simple Content Access (SCA) を有効にしない場合は、Simple Content Access チェックボックスをオフにします。SCA の詳細は、Simple Content Access を参照してください。

   注記

   Red Hat は、エンタイトルメントモードが非推奨であるため、SCA を無効にすることを推奨しません。

6. オプション: Description フィールドに、組織の説明を入力します。
7. Submit をクリックします。
8. ホストに組織が割り当てられていない場合は、組織に追加するホストを選択し、Proceed to Edit をクリックします。
9. 編集 ページで、組織に追加するインフラストラクチャーリソースを割り当てます。これには、ネットワークリソース、インストールメディア、キックスタートテンプレートなどのパラメーターが含まれます。管理 > 組織 に移動して、編集する組織を選択すると、いつでもこのページに戻ることができます。
10. Submit をクリックします。

CLI 手順

1. 組織を作成するには、以下のコマンドを入力します。

   # hammer organization create \
   --name "My_Organization" \
   --label "My_Organization_Label" \
   --description "My_Organization_Description"

   注記

   この方法で作成された組織では、デフォルトで Simple Content Access (SCA) が有効になっています。SCA を無効にする場合は、コマンドに --simple-content-access false パラメーターを追加します。エンタイトルメントモード (SCA を使用しない) は非推奨であるため、Red Hat は SCA を無効にすることを推奨していません。

2. オプション: 組織を編集するには、hammer organization update コマンドを入力します。たとえば、以下のコマンドはコンピュートリソースを組織に割り当てます。

   # hammer organization update \
   --name "My_Organization" \
   --compute-resource-ids 1

手順

1. Satellite Web UI で、Administer > Organizations に移動します。
2. デバッグ証明書を生成する組織を選択します。
3. Generate and Download をクリックします。
4. 証明書ファイルを安全なロケーションに保存します。

手順

1. 証明書の秘密鍵と公開鍵を 2 つのファイルに分割します。

   1. たとえば、デフォルトの組織の X.509 証明書を開きます。

      $ vi 'Default Organization-key-cert.pem'

   2. -----BEGIN RSA PRIVATE KEY----- から -----END RSA PRIVATE KEY----- までのファイルのコンテンツを key.pem ファイルにコピーします。
   3. -----BEGIN CERTIFICATE----- から -----END CERTIFICATE----- までのファイルのコンテンツを cert.pem ファイルにコピーします。
2. ブラウザーを使用するには、まず X.509 証明書をブラウザーがサポートする形式に変換してから、証明書をインポートする必要があります。

Firefox をご利用の場合

1. 次のコマンドを使用して、証明書を PKCS12 形式に変換します。

   $ openssl pkcs12 -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -export -in cert.pem -inkey key.pem -out My_Organization_Label.pfx -name My_Organization

2. Firefox ブラウザーで、編集 > 設定 > 詳細タブ に移動します。
3. 証明書の表示 を選択し、証明書タブをクリックします。
4. Import をクリックして、読み込む .pfx ファイルを選択します。

5. アドレスバーに次の URL を入力して、すべてのリポジトリーのアクセス可能なパスを参照し、その内容を確認します。

   https://satellite.example.com/pulp/content/

手順

1. Satellite Web UI で、Administer > Organizations に移動します。
2. 削除する組織名の右側にあるリストから 削除 を選択します。
3. OK をクリックして組織を削除します。

CLI 手順

1. 以下のコマンドを入力して、削除する組織の ID を取得します。

   # hammer organization list

   出力から、削除する組織の ID をメモします。

2. 以下のコマンドを入力して組織を削除します。

   # hammer organization delete --id Organization_ID

手順

1. Satellite Web UI で、Administer > Locations に移動します。
2. New Location をクリックします。
3. オプション: Parent リストから、親ロケーションを選択します。これにより、ロケーションの階層が作成されます。
4. Name フィールドに、ロケーションの名前を入力します。
5. オプション: Description フィールドに、ロケーションの説明を入力します。
6. Submit をクリックします。
7. ホストにロケーションが割り当てられていない場合は、新しいロケーションに割り当てるホストを追加し、Proceed to Edit をクリックします。
8. ロケーションに追加するインフラストラクチャーリソースを割り当てます。これには、ネットワークリソース、インストールメディア、キックスタートテンプレートなどのパラメーターが含まれます。Administer > Locations に移動して、編集するロケーションを選択すると、いつでもこのページに戻ることができます。
9. Submit をクリックして変更を保存します。

手順

1. Satellite Web UI で、Administer > Locations に移動します。
2. 削除するロケーションの名前の右側にあるリストから削除を選択します。
3. OK をクリックして、ロケーションを削除します。

CLI 手順

1. 以下のコマンドを入力して、削除するロケーションの ID を取得します。

   # hammer location list

   出力から、削除するロケーションの ID をメモします。

2. 以下のコマンドを実行してロケーションを削除します。

   # hammer location delete --id Location ID

手順

1. Satellite Web UI で、Administer > Users に移動します。
2. 編集する ユーザー名 をクリックします。
3. ユーザー タブで、メール フィールドの値を確認します。メール通知は、このフィールドのアドレスに送信されます。
4. メール設定 タブで メールの有効化 を選択します。

5. 通知タイプの横にあるドロップダウンメニューから、ユーザーが受信する通知を選択します。

   注記

   メールクエリー テキストボックスに必要なクエリーを記入すると、監査サマリー 通知をフィルターすることができます。

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

   通知メールのユーザーへの送信が開始されます。

手順

1. Satellite Web UI で、Administer > Users に移動します。
2. ユーザー名をクリックします。

3. メール設定 タブで テストメール をクリックします。

   ユーザーのメールアドレスにすぐにテストメッセージが送信されます。

1. ユーザーのメールアドレスを確認します。
2. Satellite Server のメール設定を確認します。
3. ファイアウォールおよびメールサーバーのログを調べます。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動し、表示するホストを見つけて、Actions 列の Edit をクリックします。
2. Additional Information タブに移動します。Include this host within Satellite reporting チェックボックスがオンになっている場合、そのホストで E メール通知が有効になります。

3. オプション: E メール通知を有効または無効にするには、チェックボックスを切り替えます。

   注記

   E メール通知を受け取る場合は、ユーザー設定で電子メールアドレスが設定されていることを確認してください。

手順

1. du コマンドを入力して、Satellite データベースおよび設定ファイルを含む非圧縮ディレクトリーのサイズを予測します。

   # du -sh /var/lib/pgsql/data /var/lib/pulp
   100G    /var/lib/pgsql/data
   100G	/var/lib/pulp
   
   # du -csh /var/lib/qpidd /var/lib/tftpboot /etc /root/ssl-build \
   /var/www/html/pub /opt/puppetlabs
   886M  /var/lib/qpidd
   16M   /var/lib/tftpboot
   37M   /etc
   900K  /root/ssl-build
   100K  /var/www/html/pub
   2M    /opt/puppetlabs
   942M  total

2. 圧縮データを保存するために必要な領域を計算します。

   以下の表は、バックアップに含まれるすべてのデータ項目の圧縮率を示しています。

   表11.1 バックアップデータ圧縮率

   データ型	ディレクトリー	比率	圧縮結果の例
   PostgreSQL データベースファイル	/var/lib/pgsql/data	80 – 85%	100 GB → 20 GB
   Pulp RPM ファイル	/var/lib/pulp	(非圧縮)	100 GB
   設定ファイル	/var/lib/qpidd /var/lib/tftpboot /etc /root/ssl-build /var/www/html/pub /opt/puppetlabs	85%	942 MB → 141 MB

   この例では、圧縮されたバックアップデータは合計 120 GB を占有します。

3. バックアップの保存に必要な利用可能な領域を計算するには、圧縮および非圧縮のバックアップデータの予測値を合計し、合計値の 20% をさらに追加してバックアップの信頼性を高めます。

   この例では、非圧縮および圧縮のバックアップデータに 201 GB と 120 GB の合計 321 GB が必要です。64 GB の予備領域もあわせ、385－21－2 GB をバックアップのロケーションに割り当てる必要があります。

手順

1. 完全なオフラインバックアップを実行するには、以下のコマンドを入力します。

   # satellite-maintain backup offline /var/backup_directory

2. バックアップディレクトリー内にディレクトリーを作成し、初回増分バックアップを保存するには、--incremental オプションを使用する satellite-maintain backup コマンドを入力します。

   # satellite-maintain backup offline --incremental /var/backup_directory/full_backup /var/backup_directory

3. 2 回目増分バックアップを作成するには、--incremental オプションを使用する satellite-maintain backup コマンドを入力し、次回増分の開始点を示すために、初回増分バックアップへのパスを追加します。これで 2 回目増分バックアップのディレクトリーがバックアップディレクトリー内に作成されます。

   # satellite-maintain backup offline --incremental /var/backup_directory/first_incremental_backup /var/backup_directory

4. オプション: 別のバージョンのバックアップをポイントし、開始点としてそのバックアップバージョンでの増分シリーズを作成する場合は、いつでもこれを行うことができます。たとえば、初回もしくは 2 回目増分バックアップからではなく、完全バックアップから新しい増分バックアップを作成するには、完全バックアップディレクトリーをポイントします。

   # satellite-maintain backup offline --incremental /var/backup_directory/full_backup /var/backup_directory

手順

1. Satellite または Capsule のインストールに適した方法を選択します。

   • オンライン接続されているネットワークで Satellite Server をインストールするには、オンラインネットワーク環境での Satellite Server のインストール の手順に従います。
   • オンライン接続されていないネットワークから Satellite Server をインストールするには、オフラインネットワーク環境での Satellite Server のインストール の手順に従います。
   • Capsule Server をインストールするには、Capsule Server のインストール の手順に従います。
2. バックアップデータを Satellite Server のローカルファイルシステムにコピーします。/var/ または /var/tmp/ を使用します。

3. 復元スクリプトを実行します。

   # satellite-maintain restore /var/backup_directory

   ここでの backup_directory は、バックアップされたデータを格納しているタイムスタンプ付きのディレクトリーまたはサブディレクトリーになります。

   コピーするデータサイズが原因で、復元プロセスの完了に長い時間がかかることがあります。

手順

1. 「完全バックアップからの復元」 の手順を使用して、最新の完全バックアップを復元します。
2. /var/ や /var/tmp/ などの Satellite Server のローカルファイルシステムから完全バックアップデータを削除します。
3. /var/ や /var/tmp/ などの Satellite Server のローカルファイルシステムに増分バックアップデータをコピーします。

4. 増分バックアップが作成された順序で復元します。

   # satellite-maintain restore /var/backup_directory/FIRST_INCREMENTAL
   # satellite-maintain restore /var/backup_directory/SECOND_INCREMENTAL

手順

1. Satellite Server で、satellite-change-hostname スクリプトを実行し、新しいホスト名を指定します。以下の方法のいずれかを選択します。

   • Satellite Server をデフォルトの自己署名 SSL 証明書でインストールした場合は、以下のコマンドを入力します。

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password

   • Satellite Server をカスタムの SSL 証明書を使用してインストールした場合は、以下を実行します。

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password \
     --custom-cert "/root/ownca/test.com/test.com.crt" \
     --custom-key "/root/ownca/test.com/test.com.key"

2. Satellite Server の新しいホスト名用にカスタム SSL 証明書を作成した場合は、Satellite インストールスクリプトを実行して証明書をインストールします。カスタム SSL 証明書のインストールに関する詳細は、オンラインネットワーク環境での Satellite Server のインストール の Satellite Server へのカスタム SSL 証明書のデプロイ を参照してください。
3. すべての Satellite ホストを再登録します。詳細は、ホストの管理 の ホストの登録 を参照してください。

4. すべての Capsule Server で、Satellite インストールスクリプトを実行して、新規ホスト名への参照を更新します。

   # satellite-installer \
   --foreman-proxy-foreman-base-url https://new-satellite.example.com \
   --foreman-proxy-trusted-hosts new-satellite.example.com \
   --puppet-server-foreman-url https://new-satellite.example.com

5. Satellite Server で、すべての Capsule Server をリスト表示します。

   # hammer capsule list

6. Satellite Server で、コンテンツを各 Capsule Server に同期します。

   # hammer capsule content synchronize \
   --id My_capsule_ID

7. virt-who エージェントを使用する場合は、新しいホスト名で virt-who 設定ファイルを更新します。詳細は、Red Hat Satellite での仮想マシンサブスクリプションの設定 の virt-who 設定の修正 を参照してください。
8. 外部認証を使用している場合は、satellite-change-hostname スクリプトの実行後に、外部認証向けに Satellite Server を再設定します。詳細は、オンラインネットワーク環境での Satellite Server のインストール の 外部認証の設定 を参照してください。

手順

1. Satellite Server で、Capsule Server の 新しい証明書のアーカイブファイルを生成します。

   • デフォルトの SSL 証明書を使用している場合は、以下のコマンドを実行します。

     # capsule-certs-generate \
     --foreman-proxy-fqdn new-capsule.example.com \
     --certs-tar /root/new-capsule.example.com-certs.tar

     .tar ファイルへの完全パスを必ず入力してください。

   • カスタムの SSL 証明書を使用している場合は、Capsule Server 用の新しい SSL 証明書を作成します。詳細は、Capsule Server のインストールの カスタム SSL 証明書を使用した Capsule Server の設定 を参照してください。

2. Satellite Server で、証明書アーカイブファイルを Capsule Server にコピーします。たとえば、アーカイブファイルを root ユーザーのホームディレクトリーにコピーするには、次のようにします。

   # scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:

3. Capsule Server で satellite-change-hostname スクリプトを実行し、新しいホスト名と Satellite 認証情報、および証明書アーカイブファイル名を提供します。

   # satellite-change-hostname new-capsule.example.com --username admin \
   --password password \
   --certs-tar /root/new-capsule.example.com-certs.tar

   .tar ファイルへの完全パスを必ず入力してください。

4. Capsule Server のカスタム証明書を作成した場合は、前の手順で Capsule-certs-generate コマンドが返した Satellite-installer コマンドを入力して、Capsule Server に証明書をデプロイします。詳細は、Capsule Server のインストール の Capsule Server へのカスタム SSL 証明書のデプロイ を参照してください。

5. すべての Capsule クライアントで、以下のコマンドを入力して、ブートストラップ RPM を再インストールし、クライアントを再登録して、サブスクリプションを更新します。

   この手順は、リモート実行機能を使用して実行できます。詳細は、ホストの管理 の リモートジョブの設定およびセットアップ を参照してください。

   # dnf remove katello-ca-consumer*
   
   # dnf install http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
   
   # subscription-manager register --org="My_Organization" \
   --environment="Library" \
   --force
   
   # subscription-manager refresh

6. Satellite Web UI で Capsule のホスト名を更新します。

   1. Satellite Web UI で、Infrastructure > Capsules に移動します。
   2. リストで Capsule Server を見つけて、Edit をクリックします。
   3. 名前 と URL フィールドが Capsule Server の新規ホスト名に一致するように変更して、送信 をクリックします。
   4. DNS サーバーで、Capsule Server の新しいホスト名のレコードを追加し、以前のホスト名のレコードを削除します。

手順

1. Satellite Web UI で、Administer > Settings に移動します。
2. General タブで、Saved audits interval の設定を見つけます。
3. 設定の値を、Satellite が監査レコードを削除する日数に設定します。

手順

1. SSH を使用して Satellite Server に接続します。

   # ssh root@satellite.example.com

2. オプション: タスクを表示します。

   # hammer task info --id My_Task_ID

3. タスクを削除します。

   # foreman-rake foreman_tasks:cleanup TASK_SEARCH="id=My_Task_ID"

4. オプション: タスクが Satellite Server から削除されていることを確認します。

   # hammer task info --id My_Task_ID

   タスクが削除されているため、このコマンドはゼロ以外の終了コードを返すことに注意してください。

手順

1. 実行中の Pulp タスクを完了させます。新たなタスクは開始しないでください。ディスクに空きスペースがないため、失敗することになります。

2. /var/lib/pulp ディレクトリーのある LV に十分な空き領域があることを確認します。以下のような方法があります。

   1. 孤立したコンテンツを削除します:

      # foreman-rake katello:delete_orphaned_content RAILS_ENV=production

      これは 1 週間ごとに実行されるので、多くの領域が解放されるわけではありません。

   2. できるだけ多くのリポートのダウンロードポリシーを 即時 から オンデマンド に変更し、ダウンロード済みパッケージを削除します。手順については、Red Hat カスタマーポータルのナレッジベースのソリューション How to change syncing policy for Repositories on Satellite from "Immediate" to "On-Demand" を参照してください。

   3. /var/lib/pulp ディレクトリーのある LV 上のファイルシステムを拡張します。詳細は、Red Hat Enterprise Linux 8 の論理ボリュームの設定および管理 の 論理ボリュームおよびファイルシステムの拡張 を参照してください。

      注記

      (ext3、ext4、または xfs などの) 通常外のファイルシステムを使用している場合は、そのファイルシステムをアンマウントして使用されていない状態にする必要があります。その場合は、以下を実行します。

      1. Satellite サービスを停止します。

         # satellite-maintain service stop

      2. LV 上のファイルシステムを拡張します。

      3. Satellite サービスを起動します。

         # satellite-maintain service start

3. ディスクに空きスペースがないために Pulp タスクが失敗していた場合は、それらのタスクを再実行します。

手順

1. postgresql サービス以外の全サービスを停止します。

   # satellite-maintain service stop --exclude postgresql

2. postgres ユーザーに切り替えて、データベースの領域を回収します。

   # su - postgres -c 'vacuumdb --full --all'

3. Vacuum が完了したら、他のサービスを開始します。

   # satellite-maintain service start

検証

1. ローカルマシンから Satellite Web UI にアクセスします。たとえば、https://satellite.example.com からアクセスします。
2. ブラウザーで、証明書の詳細を表示して、デプロイした証明書を確認します。

手順

1. Satellite Server で、カスタムの SSL 証明書の入力ファイルを検証します。

   # katello-certs-check -t capsule \
   -b /root/capsule_cert/ca_cert_bundle.pem \
   -c /root/capsule_cert/capsule_cert.pem \
   -k /root/capsule_cert/capsule_cert_key.pem

2. Satellite Server で、Capsule Server の証明書アーカイブファイルを生成します。

   # capsule-certs-generate \
   --certs-tar "/root/My_Certificates/capsule.example.com-certs.tar" \
   --certs-update-server \
   --foreman-proxy-fqdn "capsule.example.com" \
   --server-ca-cert "/root/My_Certificates/ca_cert_bundle.pem" \
   --server-cert "/root/My_Certificates/capsule_cert.pem" \
   --server-key "/root/My_Certificates/capsule_cert_key.pem"

3. Satellite Server から、証明書アーカイブファイルを Capsule Server にコピーします。

   # scp /root/My_Certificates/capsule.example.com-certs.tar user@capsule.example.com:

   必要に応じて、コピーしたファイルを該当するパスに移動できます。

4. capsule-certs-generate コマンドが返す satellite-installer コマンドのコピーをメモし、Capsule Server に証明書をデプロイします。

5. capsule-certs-generate コマンドで返された satellite-installer コマンドを使用して、Capsule Server に証明書をデプロイします。

   # satellite-installer --scenario capsule \
   --certs-tar-file "/root/My_Certificates/capsule.example.com-certs.tar" \
   --certs-update-server \
   --foreman-proxy-foreman-base-url "https://satellite.example.com" \
   --foreman-proxy-register-in-foreman "true"

Journal を使用したロギングの設定手順

1. 以下の satellite-installer コマンドを入力して、ロギングを journald サービスに設定します。

   # satellite-installer \
   --foreman-logging-layout pattern \
   --foreman-logging-type journald \
   --foreman-proxy-log JOURNAL

2. オプション: ログメッセージを検査するには、journalctl ユーティリティーを使用します。以下に例を示します。

   • journalctl --unit foreman および journalctl --unit foreman-proxy は、foreman および foreman-proxy ユニットのメッセージを表示します。
   • journalctl REQUEST=request_ID は、指定されたリクエストのメッセージを表示します。

ファイルベースのロギングを設定する手順

1. 次の satellite-installer コマンドを入力して、ファイルベースのログを設定します。

   # satellite-installer \
   --reset-foreman-logging-layout \
   --reset-foreman-logging-type \
   --reset-foreman-proxy-log

2. オプション: ログメッセージを検査するには、次のファイルを表示します。

   • /var/log/foreman/production.log
   • /var/log/foreman-proxy.log

手順

1. 必要なロガーを個別に有効にします。たとえば、sql と ldap のロガーを有効にするには、以下のコマンドを入力します。

   # satellite-installer \
   --foreman-loggers ldap:true \
   --foreman-loggers sql:true

2. オプション: すべてのロガーをデフォルト値にリセットします。

   # satellite-installer --reset-foreman-loggers

RSS フィード通知の設定方法

1. Satellite web UI で、Administer > Settings に移動し、Notifications タブを選択します。
2. RSS URL の行で、Value 列の編集アイコンをクリックし、必要な URL を入力します。
3. RSS 有効化の行で、Value 列の編集アイコンをクリックし、この機能を有効または無効にします。

手順

1. Satellite Web UI で、Monitor > Audits に移動して、監査レコードを表示します。

2. すべての監査属性のリストを取得するには、次のコマンドを使用します。

   # foreman-rake audits:list_attributes

手順

1. Satellite Web UI で、Administer > Webhook Templates に移動します。
2. Clone an existing template または Create Template をクリックします。
3. テンプレートの名前を入力します。

4. エディターを使用して、テンプレートペイロードに変更を加えます。

   Webhook HTTP ペイロードは、Satellite テンプレート構文を使用して作成する必要があります。Webhook テンプレートは、イベントのメインオブジェクトを表すことができる @object と呼ばれる特別な変数を使用できます。特定のイベントの場合、@object が欠落する可能性があります。@payload 変数を使用して、実際にどのデータが利用可能であるかを判断できます。

   詳細は、ホストの管理 の テンプレート作成リファレンス を参照してください。使用可能なテンプレートマクロとメソッドについては、Satellite Server の /templates_doc を参照してください。

5. オプション: 説明と監査コメントを入力します。
6. 組織とロケーションを割り当てます。
7. Submit をクリックします。

手順

1. Satellite Web UI で、Administer > Webhooks に移動します。
2. Create new をクリックします。
3. Subscribe to リストからイベントを選択します。
4. Webhook の Name を入力します。
5. Target URL を入力します。Webhook は、事前設定された URL に対して HTTP リクエストを行います。ターゲット URL は動的 URL にすることができます。
6. テンプレートをクリックして Template を選択します。Webhook テンプレートは、Webhook のトリガー時に Satellite Server に対して HTTP リクエストの本文を生成するために使用されます。
7. HTTP メソッドを入力します。
8. オプション: Webhook の作成時にアクティブ化しない場合は、Enabled フラグのチェックを外します。
9. Credentials タブをクリックします。
10. オプション: HTTP 認証が必要な場合は、User および Password を入力します。
11. オプション: システム証明書ストアまたは Satellite CA に対してサーバー証明書を検証しない場合は、Verify SSL のチェックを外します。
12. Additional タブで、HTTP Content Type を入力します。たとえば、定義したペイロードの application/json、application/xml、text/plain などです。アプリケーションは、指定されたコンテンツタイプに一致するようにコンテンツを変換しようとはしません。
13. オプション: HTTP ヘッダーを JSON として提供します。ERB も許可されます。

手順

1. /var/lib/foreman-proxy/shellhooks/print_args スクリプトを変更して、引数を標準エラーに出力し、Capsule ログで確認できるようにします。

   #!/bin/sh
   #
   # Prints all arguments to stderr
   #
   echo "$@" >&2

2. Satellite Web UI で、Administer > Webhooks に移動します。
3. Create new をクリックします。
4. Subscribe to リストから、Actions Remote Execution Run Host Job Succeeded を選択します。
5. Webhook の Name を入力します。

6. Target URL フィールドに、Capsule Server の URL に続けて :9090/shellhook/print_args と入力します。

   https://capsule.example.com:9090/shellhook/print_args

   Shellhooks ディレクトリーとは異なり、URL 内の Shellhook は単数形であることに注意してください。

7. Template リストから Empty Payload を選択します。
8. Credentials タブで、Capsule Authorization をチェックします。

9. Additional タブの Optional HTTP headers フィールドに次のテキストを入力します。

   {
       "X-Shellhook-Arg-1": "Hello",
       "X-Shellhook-Arg-2": "World!"
   }

10. Submit をクリックします。これで、Hello World! を出力するシェルフックが正常に作成され、リモート実行ジョブが成功するたびに、Capsule ログに記録されます。

検証

1. 任意のホストでリモート実行ジョブを実行します。time をコマンドとして使用できます。詳細は、ホストの管理 の リモートジョブの実行 を参照してください。

2. シェルフックスクリプトがトリガーされ、Hello World! が Capsule Server ログへ出力されたことを確認します。

   # tail /var/log/foreman-proxy/proxy.log

   ログの最後に次の行が表示されているはずです。

   [I] Started POST /shellhook/print_args
   [I] Finished POST /shellhook/print_args with 200 (0.33 ms)
   [I] [3520] Started task /var/lib/foreman-proxy/shellhooks/print_args\ Hello\ World\!
   [W] [3520] Hello World!