Red Hat Satellite の管理

1. ソースサーバーをバックアップします。
2. ソースサーバーからターゲットサーバーにクローンを作成します。
3. ソースサーバーの電源を切断します。
4. ターゲットサーバーの IP アドレスを新しいホスト名と一致させるように、ターゲットサーバーのネットワーク設定を更新します。
5. 新規ターゲットサーバーをテストします。

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. 新しいデータベースサーバーに PostgreSQL をインストールします。

   # dnf install postgresql-server 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. ファイルの最後に以下の行を追加して、認証に SCRAM を使用します。

   password_encryption=scram-sha-256

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

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

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

     host  all   all   Satellite_ip/32   scram-sha-256

8. PostgreSQL サービスを起動して有効にします。

   # systemctl enable --now postgresql

9. postgresql ポートを開きます。

   # firewall-cmd --add-service=postgresql

10. 変更を永続化します。

    # firewall-cmd --runtime-to-permanent

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

    $ su - postgres -c psql

12. 3 つのデータベースと専用ロールを作成します。1 つは Foreman 用、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;

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 で、PostgreSQL 以外の Satellite サービスをすべて停止します。

   # satellite-maintain service stop --exclude postgresql

2. Satellite バックアップのターゲットディレクトリーを作成します。

   # mkdir /var/My_Migration_Backup_Directory

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

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

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

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

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

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

6. Satellite Server 上の PostgreSQL パッケージを削除します。

   # satellite-maintain packages remove postgresql-server

7. PostgreSQL データディレクトリーを削除します。

   # rm -fr /var/lib/pgsql/data

手順

1. 機密性の高い変数を暗号化されたファイルに保存します。

   1. Ansible Vault を作成します。たとえば、My_Vault.yml という名前の vault を作成するには、以下を実行します。

      $ ansible-vault create My_Vault.yml

   2. ansible-vault create コマンドでエディターが開いたら、必要なパラメーターを key: value 形式で入力します。

      Satellite のユーザー名とパスワードで認証する場合:

      My_Username: My_Admin_User_Account
      My_Password: My_Admin_Password
      My_Server_URL: https://satellite.example.com

      Satellite ユーザー名と Personal Access Token (PAT) を使用して認証する場合:

      My_Username: My_Admin_User_Account
      My_Password: My_PAT
      My_Server_URL: https://satellite.example.com

   3. HTTP プロキシーを使用して Satellite API にアクセスする場合は、そのプロキシーも vault に保存します。

      My_HTTP_Proxy: "http://proxy.example.com:8080"

   4. 変更を保存してエディターを閉じます。Ansible は vault 内のデータを暗号化します。

2. vault ファイルを参照する Playbook ファイルを作成します。

   注記

   次の YAML スニペットには、Playbook で使用される redhat.satellite.satellite グループのすべてのモジュールにボールト変数をパラメーターとして渡す module_defaults キーワードが含まれています。モジュールのデフォルトグループを使用すると、各モジュールにパラメーターを個別に渡すのではなく、モジュールのグループに共通のパラメーターを定義できるため、パラメーター管理が簡素化されます。

   1. Satellite API への認証方法を説明します。

      Satellite のユーザー名とパスワード、または PAT で認証する場合は、username、password、および server_url パラメーターを My_Vault.yml の内容にマッピングします。

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

   2. HTTP プロキシーを使用して Satellite API にアクセスする必要がある場合は、https_proxy 環境変数を設定します。

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        environment:
          https_proxy: "{{ My_HTTP_Proxy }}"
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

   3. tasks: セクションで、Playbook が実行するタスクを定義します。

3. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check --ask-vault-pass My_Playbook.yml

   このコマンドは構文の検証のみを行うことに注意してください。設定が有効ではあるが、間違っている場合には、保護されません。

4. Playbook を実行します。

   $ ansible-playbook --ask-vault-pass My_Playbook.yml

手順

1. Satellite Web UI で、Administer > Organizations に移動します。
2. 新規組織 をクリックします。
3. 名前 フィールドに、組織の名前を入力します。
4. ラベル フィールドには、組織の一意識別子を入力します。これは、コンテンツストレージのディレクトリーなど、特定のアセットを作成し、マッピングするために使用されます。文字、数字、アンダースコア、およびダッシュを使用し、スペースは使用しないでください。
5. オプション: Description フィールドに、組織の説明を入力します。
6. Submit をクリックします。
7. ホストに組織が割り当てられていない場合は、組織に追加するホストを選択し、Proceed to Edit をクリックします。
8. 編集 ページで、組織に追加するインフラストラクチャーリソースを割り当てます。これには、ネットワークリソース、インストールメディア、キックスタートテンプレートなどのパラメーターが含まれます。Administer > Organizations に移動して、編集する組織を選択すると、いつでもこのページに戻ることができます。
9. Submit をクリックします。

CLI 手順

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

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

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 ブラウザーで、Edit > Preferences > Advanced Tab に移動します。
3. View Certificates を選択し、Your Certificates タブをクリックします。
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. ファイアウォールおよびメールサーバーのログを調べます。

4. Satellite Server がメール配信に Postfix サービスを使用している場合、テストメールがキューに保持される可能性があります。確認するには、mailq コマンドを入力して現在のメールキューを一覧表示します。テストメールがキューに保持されている場合、mailq は次のメッセージを表示します。

   postqueue: warning: Mail system is down -- accessing queue directly
   -Queue ID-  --Size-- ----Arrival Time---- -Sender/Recipient-------
   BE68482A783    1922 Thu Oct  3 05:13:36  satellite-noreply@example.com

   この問題を修正するには、Satellite Server で Postfix サービスを開始します。

   # systemctl start postfix

手順

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

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

   注記

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

手順

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/tftpboot /etc /root/ssl-build \
   /var/www/html/pub /opt/puppetlabs
   16M   /var/lib/tftpboot
   37M   /etc
   900K  /root/ssl-build
   100K  /var/www/html/pub
   2M    /opt/puppetlabs
   942M  total

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

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

   Expand

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

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

   Show more

   この例では、圧縮されたバックアップデータは合計 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. Satellite Server 上のローカルファイルシステム (例: /var/ または /var/tmp/) から完全バックアップデータを削除します。
3. 増分バックアップデータを Satellite Server 上のローカルファイルシステム (例: /var/ または /var/tmp/) にコピーします。

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 My_Username \
     --password 'My_Password'

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

     # satellite-change-hostname new-satellite \
     --username My_Username \
     --password 'My_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 Server に登録されているすべてのホストと Capsule Server を再登録します。詳細は、ホストの管理 の グローバル登録を使用したホストの登録 を参照してください。

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

   # satellite-installer \
   --foreman-proxy-foreman-base-url https://new-satellite.example.com \
   --foreman-proxy-trusted-hosts 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 設定ファイルを更新します。詳細は、仮想マシンサブスクリプションの virt-who 設定 の virt-who 設定の変更 を参照してください。
8. 外部認証を使用している場合は、satellite-change-hostname スクリプトの実行後に、外部認証向けに Satellite Server を再設定します。詳細は、Red Hat Satellite ユーザーの認証設定 を参照してください。

手順

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

   • デフォルトの SSL 証明書を使用している場合は、デフォルトの SSL 証明書を再生成します。

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

     .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 \
   --certs-tar /root/new-capsule.example.com-certs.tar \
   --password 'My_Password' \
   --username My_Username

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

4. Capsule Server 用のカスタム証明書を作成した場合は、前のステップで capsule-certs-generate コマンドが返した satellite-installer コマンドを入力して、証明書を Capsule Server にデプロイします。詳細は、Capsule Server のインストール の Capsule Server へのカスタム SSL 証明書のデプロイ を参照してください。
5. Capsule Server に登録されている全ホストを再登録します。詳細は、ホストの管理 の ホストの登録とホスト統合の設定 を参照してください。

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 9 論理ボリュームとファイルシステムの拡張 の 論理ボリュームの設定と管理 を参照してください。

      注記

      (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. 新しい SSL 証明書を Satellite Server 上の CA 証明書ファイルに追加し、古い SSL 証明書を保持します。
2. Satellite Server およびすべての Capsule Server で証明書を更新します。
3. ホストにデュアル CA 証明書をデプロイします。
4. Satellite Server 上の CA 証明書ファイルから古い証明書を削除し、CA 証明書ファイルに新しい SSL 証明書のみが含まれるようにします。
5. Satellite Server およびすべての Capsule Server で証明書を更新します。
6. ホストに新しい CA 証明書をデプロイします。

検証

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 Server にデプロイするために、capsule-certs-generate コマンドが返す satellite-installer コマンドのコピーを保存しておきます。

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"

手順

1. HTTPS を使用してリポジトリーに接続し、Git サーバーで自己署名認証局 (CA) を使用する場合は、次の手順を実行します。

   1. 証明書の Git 設定を保存するために、/usr/share/foreman/ ディレクトリーの下に新しいディレクトリーを作成します。

      # mkdir --parents /usr/share/foreman/.config/git

   2. 新しいディレクトリーに config という名前のファイルを作成します。

      # touch /usr/share/foreman/.config/git/config

   3. foreman ユーザーに .config ディレクトリーへのアクセスを許可します。

      # chown --recursive foreman /usr/share/foreman/.config

   4. 自己署名 CA 証明書へのパスを使用して、foreman ユーザーの Git グローバル設定を更新します。

      # sudo --user foreman git config --global http.sslCAPath Path_To_CA_Certificate

2. SSH を使用してリポジトリーに接続する場合は以下を実行します。

   1. SSH 鍵ペアがない場合は作成します。パスフレーズは指定しないでください。

      # sudo --user foreman ssh-keygen

   2. Satellite の公開鍵を使用してバージョン管理サーバーを設定します。公開鍵は、/usr/share/foreman/.ssh/id_rsa.pub にあります。

   3. Git SSH ホストキーを foreman ユーザーとして受け取ります。

      # sudo --user foreman ssh git.example.com

3. Satellite Web UI で、Git リポジトリーの詳細を入力します。

   1. Administer > Settings に移動します。
   2. Template Sync タブをクリックします。
   3. Branch 設定を変更して、リポジトリーのターゲットブランチを定義します。
   4. リポジトリー URL を定義するには、Repo 設定を変更します。
   5. HTTP プロキシーを使用してリポジトリーに接続する場合は、HTTP proxy policy 設定を Global default HTTP proxy または Custom HTTP proxy に変更します。

手順

1. Satellite Server の /var/lib/foreman で、テンプレートを保存するディレクトリーを作成します。

   # mkdir /var/lib/foreman/My_Templates_Dir

   注記

   テンプレートを /var/lib/foreman の外部のカスタムディレクトリーに配置できますが、Foreman サービスがその内容を読み取れるようにする必要があります。ディレクトリーには正しいファイルパーミッションと foreman_lib_t SELinux ラベルが必要です。

2. 新しいテンプレートディレクトリーの所有者を foreman ユーザーに変更します。

   # chown foreman /var/lib/foreman/My_Templates_Dir

3. Template Sync タブの Repo 設定を /var/lib/foreman/My_Templates_Dir/ ディレクトリーと一致するように変更します。

手順

1. Satellite Web UI で、Hosts > Templates > Sync Templates に移動します。
2. Import をクリックします。
3. 各フィールドに、Administer > Settings > Template Sync で設定した値が入力されます。インポートするテンプレートに従って値を変更します。各フィールドの詳細は、「テンプレート同期設定」 を参照してください。
4. Submit をクリックします。

API の手順

1. POST リクエストを api/v2/templates/import に送信します。

   # curl -H "Accept:application/json" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/import \
   -X POST

   インポートが成功すると、{"message":"Success"} が表示されます。

手順

1. Satellite Web UI で、Hosts > Templates > Sync Templates に移動します。
2. Export をクリックします。
3. 各フィールドに、Administer > Settings > Template Sync で設定した値が入力されます。エクスポートするテンプレートに従って値を変更します。各フィールドの詳細は、「テンプレート同期設定」 を参照してください。
4. Submit をクリックします。

CLI 手順

1. テンプレートをリポジトリーにエクスポートするには、次のコマンドを入力します。

   $ hammer export-templates \
   --organization "My_Organization" \
   --repo "https://git.example.com/path/to/repository"

   注記

   このコマンドは、リポジトリーのクローンを作成し、コミットに変更を加えて、リポジトリーにプッシュして戻します。--branch "My_Branch" オプションを使用すると、テンプレートを特定のブランチにエクスポートできます。

API の手順

1. POST リクエストを api/v2/templates/export に送信します。

   # curl -H "Accept:application/json" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/export \
   -X POST

   エクスポートが成功すると、{"message":"Success"} が表示されます。

ジャーナルを使用したロギングの設定手順

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

   # satellite-installer \
   --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-type \
   --reset-foreman-proxy-log

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

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

JSON 出力へのロギングを設定する手順

1. Satellite Server で、satellite-installer の JSON 出力へのロギングを有効にします。

   # satellite-installer \
   --foreman-logging-layout json \
   --foreman-logging-type file

2. オプション: jq を使用してログメッセージを検査します。

   # cat /var/log/foreman/production.log | jq

手順

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 > 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 > Webhook > 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 も許可されます。