手順

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. 右上にあるユーザー名をクリックします。
2. メニューから マイアカウント を選択します。
3. 現在のパスワード フィールドに現在のパスワードを入力します。
4. パスワード フィールドに新しいパスワードを入力します。
5. 確認 フィールドに新しいパスワードを再入力します。
6. 送信 ボタンをクリックして、新しいパスワードを保存します。

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

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. Satellite インフラストラクチャーサブスクリプションのアタッチ の手順に従い、サーバーに Satellite サブスクリプションをアタッチします。

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

   # subscription-manager repos --disable '*'
   # subscription-manager repos \
   --enable=satellite-6.12-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 Life Cycle を参照してください。

手順

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

   # dnf install postgresql-server postgresql-evr

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. postgres ユーザーをログアウトします。

    # \q

12. 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 --skip-pulp-content --preserve-directory -y /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-host postgres.example.com \
       --foreman-db-password Foreman_Password \
       --foreman-db-database foreman \
       --foreman-db-manage false \
       --foreman-db-username foreman \
       --katello-candlepin-db-host postgres.example.com \
       --katello-candlepin-db-name candlepin \
       --katello-candlepin-db-password Candlepin_Password \
       --katello-candlepin-manage-db false \
       --katello-candlepin-db-user candlepin \
       --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-password Pulpcore_Password \
       --foreman-proxy-content-pulpcore-postgresql-user pulp

手順

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

手順

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 に移動し、変更する通知設定を持つホストを選択します。
2. ホストのチェックボックスを選択し、アクションの選択 リストから 通知の有効化 または 通知の無効化 を必要に応じて選択します。

手順

1. OpenSCAP プラグインを Satellite Server にインストールします。

   # satellite-installer --enable-foreman-plugin-openscap --enable-foreman-proxy-plugin-openscap

2. OpenSCAP プラグインを Capsule Server にインストールします。

   # satellite-installer --enable-foreman-proxy-plugin-openscap

3. OpenSCAP プラグイン Puppet モジュールをインストールします。

   # dnf install puppet-foreman_scap_client

4. Satellite web UI で、Configure > Puppet Classes に移動します。

5. Import environments from satellite.example.com をクリックします。

   Puppet を使用して、Satellite Server および Capsules に OpenSCAP プラグインをインストールおよび設定できます。

手順

1. Satellite Web UI で 設定 > ホストグループ に移動して、ホストグループを作成するか、OpenSCAP レポートを設定するホストグループをクリックします。
2. Puppet 環境 リストから、foreman_scap_client および foreman_scap_client::params が含まれる Puppet 環境を選択します。
3. OpenSCAP Capsule リストから、使用する OpenSCAP が有効になった Capsule を選択します。
4. Puppet クラス タブをクリックして、foreman_scap_client と foreman_scap_client::params の Puppet クラスを追加します。
5. 送信 をクリックして変更を保存します。
6. Satellite Web UI で、ホスト > ポリシー に移動します。
7. ホストグループに割り当てるポリシーを選択します。
8. ホストグループ タブをクリックします。
9. ホストグループ リストから、このポリシーに割り当てるホストグループを任意の数だけ割り当てます。
10. 送信 をクリックして変更を保存します。

手順

1. Satellite Web UI で ホスト > すべてのホスト に移動して、OpenSCAP レポートを設定するホストで、編集 をクリックします。
2. Puppet 環境 リストから、foreman_scap_client および foreman_scap_client::params が含まれる Puppet 環境を選択します。
3. OpenSCAP Capsule リストから、使用する OpenSCAP が有効になった Capsule を選択します。
4. Puppet クラス タブをクリックして、foreman_scap_client と foreman_scap_client::params の Puppet クラスを追加します。
5. コンプライアンスポリシーを追加するには、次のいずれかの場所に移動します。
6. Satellite Web UI で、ホスト > すべてのホスト に移動します。
7. ポリシーを追加するホストを選択します。
8. アクションの選択 をクリックします。
9. リストから コンプライアンスポリシーの割り当て を選択します。
10. ポリシーウィンドウで、利用可能なポリシーの一覧からポリシーを選択して、送信 をクリックします。

手順

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 -i /var/backup_directory/FIRST_INCREMENTAL
   # satellite-maintain restore -i /var/backup_directory/SECOND_INCREMENTAL

   satellite-maintain backup コマンドを使用してバックアップを作成した場合は、このコマンドに -i オプションを使用する必要はありません。

手順

1. Satellite Server で satellite-change-hostname スクリプトを実行する適切な方法を選択して、新しいホスト名と Satellite 認証情報を提供します。

   • 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 のインストール の カスタムの SSL 証明書の Satellite Server へのインストール を参照してください。
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

手順

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 ユーザーのパスワードを提供します。この例では、アーカイブファイルは 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 --username admin \
   --password password \
   --certs-tar /root/new-capsule.example.com-certs.tar

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

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

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 で、インフラストラクチャー > Capsules に移動します。
7. リストで Capsule Server を見つけ、右側にある 編集 をクリックします。
8. 名前 と URL フィールドが Capsule Server の新規ホスト名に一致するように変更して、送信 をクリックします。
9. DNS サーバーで、Capsule Server の新規ホスト名用のレコードを追加し、古いホスト名のレコードを削除します。

手順

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-installer --foreman-logging-level debug

2. デバッグが完了したら、ロギングレベルをデフォルト値にリセットします。

   # satellite-installer --reset-foreman-logging-level

手順

1. Satellite web UI で、Administer > About に移動します。
2. Smart Proxies タブでは、すべての Capsules のステータスを表示できます。
3. Compute Resources タブで、接続されているコンピュートリソースプロバイダーのステータスを表示できます。
4. Backend System Status テーブルでは、すべてのバックエンドサービスのステータスを表示できます。

手順

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

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

2. オプション: デフォルト値にロガーをリセットするには、以下のコマンドを入力します。

   # satellite-installer --reset-foreman-loggers

手順

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

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

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

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

手順

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

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

   # foreman-rake audits:list_attributes

手順

1. Satellite web UI で、Administer > Webhooks 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. ターゲット 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 コンテンツタイプを入力します。たとえば、定義したペイロードの 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

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

7. Template リストから、Empty Payload を選択します。
8. Credentials タブで、Capsule の認証を確認します。

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

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

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

検証

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

2. shellhook スクリプトがトリガーされ、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!