第2章 Capsule Server のインストール
Capsule Server をインストールする前に、お使いの環境がインストール要件を満たしていることを確認してください。詳細は、「システム要件」 を参照してください。
2.1. Satellite Server への登録 リンクのコピーリンクがクリップボードにコピーされました!
この手順を使用して、Capsule Server をインストールするベースシステムを Satellite Server に登録します。
前提条件
Satellite Server に登録する前に、Capsule のインストール先のベースシステムが次の条件を満たしていることを確認してください。
サブスクリプションのマニフェストの前提条件
- Satellite Server にマニフェストをインストールし、Capsule が所属する組織に適したリポジトリーが含まれている必要がある。
- マニフェストには、Capsule をインストールするベースシステムのリポジトリーと、Capsule に接続するクライアントが含まれている必要がある。
- リポジトリーは、同期されている必要がある。
マニフェストとリポジトリーに関する詳しい情報は、『Red Hat Satellite コンテンツ管理ガイド』の「サブスクリプションの管理」を参照してください。
プロキシーとネットワークの前提条件
- Satellite Server のベースシステムは、Capsule のベースシステムのホスト名を解決できる必要があり、Capsule のベースシステムは Satellite Server のベースシステムのホスト名を解決できる必要がある。
- Capsule Server のインストール先のベースシステムには、Red Hat コンテンツ配信ネットワーク (CDN) への接続にプロキシーを使用しないように設定しておく。
- 要件に合わせてホストとネットワークベースのファイアウォールを設定する必要がある。詳細は「ポートとファイアウォールの要件」を参照してください。
- Satellite Server のユーザー名とパスワードが必要。詳細は『Red Hat Satellite の管理』の「外部認証の設定」を参照してください。
手順
Satellite Server にシステムを登録するには、以下の手順を実行します。
Capsule をインストールするベースシステムに、
katello-ca-consumer-latest.noarch.rpmパッケージをダウンロードします。コンシューマー RPM で、ホストが Red Hat Satellite で指定したコンテンツソースからコンテンツをダウンロードするように設定します。curl --insecure --output katello-ca-consumer-latest.noarch.rpm https://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm
# curl --insecure --output katello-ca-consumer-latest.noarch.rpm https://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpmCopy to Clipboard Copied! Toggle word wrap Toggle overflow katello-ca-consumer-latest.noarch.rpmパッケージをインストールします。yum localinstall katello-ca-consumer-latest.noarch.rpm
# yum localinstall katello-ca-consumer-latest.noarch.rpmCopy to Clipboard Copied! Toggle word wrap Toggle overflow Capsule の所属先の環境で、Capsule のベースシステムを登録します。アクティベーションキーを使用して、環境の指定を簡素化します。
subscription-manager register --org=organization_name --activationkey=example_activation_key
# subscription-manager register --org=organization_name --activationkey=example_activation_keyCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2. Satellite Infrastructure サブスクリプションのアタッチ リンクのコピーリンクがクリップボードにコピーされました!
Capsule Server の登録後に、サブスクリプションプール ID を特定して、利用可能なサブスクリプションをアタッチする必要があります。Red Hat Satellite Infrastructure のサブスクリプションを使用すると、Red Hat Satellite、Red Hat Enterprise Linux および Red Hat Software Collections (RHSCL) コンテンツにアクセスできるようになります。必要なサブスクリプションはこれだけです。
Red Hat Satellite Infrastructure は、Smart Management を提供するサブスクリプションすべてに含まれます。詳細は、Red Hat ナレッジベースソリューション「Satellite Infrastructure Subscriptions MCT3718 MCT3719」を参照してください。
サブスクリプションがシステムにアタッチされていない場合には、利用可能として分類されます。利用可能な Satellite サブスクリプションを見つけることができない場合は、Red Hat ナレッジベースソリューション 「How do I figure out which subscriptions have been consumed by clients registered under Red Hat Subscription Manager?」 を参照して、スクリプトを実行し、サブスクリプションが別のシステムで使用されているかどうかを確認できます。
手順
Satellite Infrastructure サブスクリプションをアタッチするには、以下の手順を実行します。
Satellite Infrastructure サブスクリプションのプール ID を特定します。
subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'
# subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'Copy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行すると、以下のような出力が表示されます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - サブスクリプションプール IDを書き留めます。上記の例と、実際のサブスクリプションプール ID は異なります。
Capsule Server の実行先のベースシステムに、Satellite Infrastructure サブスクリプションをアタッチします。
subscription-manager attach --pool=pool_id
# subscription-manager attach --pool=pool_idCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行すると、以下のような出力が表示されます。
サブスクリプションを正常に割り当てます: Red Hat Satellite Infrastructure サブスクリプション
サブスクリプションを正常に割り当てます: Red Hat Satellite Infrastructure サブスクリプションCopy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: Satellite Infrastructure サブスクリプションが割り当てられていることを確認します。
subscription-manager list --consumed
# subscription-manager list --consumedCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3. リポジトリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
この手順を使用して、Capsule Server のインストールに必要なリポジトリーを有効にします。
手順
必要なリポジトリーを設定するには、以下の手順を実行します。
すべてのリポジトリーを無効にします。
subscription-manager repos --disable "*"
# subscription-manager repos --disable "*"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のリポジトリーを有効にします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記Red Hat Virtualization (RHV) がホストする仮想マシンとして、Capsule Server をインストールする場合は、Red Hat Common リポジトリーを有効にして、RHV ゲストエージェントとドライバーもインストールする必要があります。詳細は『仮想マシン管理ガイド』の「ゲストエージェントおよびドライバーのインストール」を参照してください。
yumメタデータを消去します。yum clean all
# yum clean allCopy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: 必要なリポジトリーが有効になっていることを確認します。
yum repolist enabled
# yum repolist enabledCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.4. chronyd とシステムクロックの同期 リンクのコピーリンクがクリップボードにコピーされました!
時間のずれを最小限に抑えるには、Capsule Server をインストールするベースシステムのシステムクロックを Network Time Protocol (NTP) サーバーと同期する必要があります。ベースシステムのクロックが正しく設定されていない場合には、証明書の検証に失敗する可能性があります。
chrony スイートに関する詳細は、『Red Hat Enterprise Linux 7 システム管理者ガイド』の「chrony スイートを使用した NTP の設定」を参照してください。
手順
システムクロックを同期するには、以下の手順を実行します。
chronyパッケージをインストールします。yum install chrony
# yum install chronyCopy to Clipboard Copied! Toggle word wrap Toggle overflow chronydサービスを起動して、有効にします。systemctl start chronyd systemctl enable chronyd
# systemctl start chronyd # systemctl enable chronydCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.5. Capsule Server パッケージのインストール リンクのコピーリンクがクリップボードにコピーされました!
Capsule Server パッケージをインストールする前に、ベースシステムにインストールした全パッケージを更新する必要があります。
手順
Capsule Server をインストールするには、以下の手順を実行します。
すべてのパッケージを更新します。
yum update
# yum updateCopy to Clipboard Copied! Toggle word wrap Toggle overflow satellite-capsuleパッケージをインストールします。yum install satellite-capsule
# yum install satellite-capsuleCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.6. SSL 証明書を使用した Capsule Server の設定 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Satellite は SSL 証明書を使用して、Satellite Server、外部 Capsule Server、全ホストの間の暗号化通信を有効にします。組織の要件によっては、デフォルトの証明書またはカスタムの証明書で Capsule Server を設定する必要があります。
- また、デフォルトの SSL 証明書を使用する場合には、外部 Capsule Server ごとに異なるデフォルトの SSL 証明書を設定する必要があります。詳細は、「デフォルトの SSL 証明書を使用した Capsule Server の設定」 を参照してください。
- また、カスタムの SSL 証明書を使用する場合には、外部 Capsule Server ごとに異なるカスタムの SSL 証明書を使用して設定する必要があります。詳細は、「カスタム SSL 証明書を使用した Capsule Server の設定」 を参照してください。
2.6.1. デフォルトの SSL 証明書を使用した Capsule Server の設定 リンクのコピーリンクがクリップボードにコピーされました!
本セクションを使用して、Satellite Server のデフォルトの証明局 (CA) が署名した SSL 証明書を使用して Capsule Server を設定します。
前提条件
デフォルトのサーバー証明書で Capsule Server を設定する前に、Capsule Server が以下の条件を満たすように確認してください。
- Capsule Server が Satellite Server に登録されている。詳細は、「Satellite Server への登録」を参照してください。
- Capsule Server パッケージがインストールされている。詳細は、「Capsule Server パッケージのインストール」を参照してください。
手順
デフォルトのサーバー証明書で Capsule Server を設定するには、以下の手順を実行します。
Satellite Server で Capsule Server の全ソース証明書ファイルを保存するには、
rootユーザーのみがアクセスできるディレクトリーを作成します (例:/root/capsule_cert)。mkdir /root/capsule_cert
# mkdir /root/capsule_certCopy to Clipboard Copied! Toggle word wrap Toggle overflow Satellite Server で、Capsule Server の
/root/capsule_cert/capsule_certs.tar証明書アーカイブを生成します。capsule-certs-generate \ --foreman-proxy-fqdn capsule.example.com \ --certs-tar /root/capsule_cert/capsule_certs.tar
# capsule-certs-generate \ --foreman-proxy-fqdn capsule.example.com \ --certs-tar /root/capsule_cert/capsule_certs.tarCopy to Clipboard Copied! Toggle word wrap Toggle overflow capsule-certs-generateコマンドが返すsatellite-installerコマンドのコピーをメモし、Capsule Server に証明書をデプロイします。capsule-certs-generate の出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Satellite Server から、証明書アーカイブファイルを Capsule Server にコピーします。
scp /root/capsule.example.com-certs.tar
# scp /root/capsule.example.com-certs.tar root@capsule.example.com:/root/capsule.example.com-certs.tarCopy to Clipboard Copied! Toggle word wrap Toggle overflow Capsule Server で、証明書をデプロイするには、
capsule-certs-generateコマンドにより返されたsatellite-installerコマンドを入力します。Satellite へのネットワーク接続やポートをまだ開いていない場合は、
--foreman-proxy-register-in-foremanオプションをfalseに設定すると、Capsule が Satellite へ接続を試行しなくなり、エラー報告がなくなります。ネットワークとファイアウォールを適切に設定したら、このオプションをtrueにして再度インストーラーを実行します。重要証明書をデプロイした後に、証明書アーカイブを削除しないでください。このアーカイブは、Capsule Server のアップグレード時などに必要になります。
2.6.2. カスタム SSL 証明書を使用した Capsule Server の設定 リンクのコピーリンクがクリップボードにコピーされました!
Satellite Server がカスタムの SSL 証明書を使用するように設定する場合は、この設定時に、外部の各 Capsule Server も、異なるカスタム SSL 証明書で設定する必要があります。
カスタム証明書を使用して Capsule Server を設定するには、Capsule Server ごとに以下の手順を実行します。
2.6.2.1. Capsule Server のカスタム SSL 証明書の作成 リンクのコピーリンクがクリップボードにコピーされました!
Satellite Server で、Capsule Server 用にカスタムの証明書を作成します。Capsule Server 用のカスタムの SSL 証明書がすでにある場合には、以下の手順は省略してください。
カスタム証明書を使用して Satellite を設定する場合には、次の点を考慮してください。
- SSL 証明書には、Privacy-Enhanced Mail (PEM) エンコードを使用する必要がある。
- Satellite Server と Capsule Server の両方に、同じ証明書を使用できない。
- 同じ証明局を使用して Satellite と Capsule の証明書を署名する必要がある。
手順
カスタムの SSL 証明書を作成するには、以下の手順を実行します。
ソースの証明書ファイルすべてを保存するには、
rootユーザーだけがアクセスできるディレクトリーを作成します。mkdir /root/capsule_cert
# mkdir /root/capsule_certCopy to Clipboard Copied! Toggle word wrap Toggle overflow Certificate Signing Request (CSR) を署名する秘密鍵を作成します。
秘密鍵は暗号化する必要がないことに注意してください。パスワードで保護された秘密鍵を使用する場合は、秘密鍵のパスワードを削除します。
この Capsule Server の秘密鍵がすでにある場合は、この手順を省略します。
openssl genrsa -out /root/capsule_cert/capsule_cert_key.pem 4096
# openssl genrsa -out /root/capsule_cert/capsule_cert_key.pem 4096Copy to Clipboard Copied! Toggle word wrap Toggle overflow 証明書署名要求 (CSR) 用の
/root/capsule_cert/openssl.cnf設定ファイルを作成して、以下のコンテンツを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
[ req_distinguished_name ]セクションに、貴社の組織の情報を入力します。- 2
- 証明書のコモンネーム
CNを、Capsule Server の完全修飾ドメイン名 (FQDN) と一致するように設定します。FQDN を確認するには、対象の Capsule Server でhostname -fコマンドを入力します。これは、katello-certs-checkコマンドが証明書を正しく検証することを確認するために必要です。 - 3
- サブジェクトの別名 (SAN: Subject Alternative Name)
DNS.1を、お使いのサーバーの完全修飾ドメイン名 (FQDN) に一致する用に設定します。
証明書署名要求 (CSR) を作成します。
openssl req -new \ -key /root/capsule_cert/capsule_cert_key.pem \ -config /root/capsule_cert/openssl.cnf \ -out /root/capsule_cert/capsule_cert_csr.pem
# openssl req -new \ -key /root/capsule_cert/capsule_cert_key.pem \1 -config /root/capsule_cert/openssl.cnf \2 -out /root/capsule_cert/capsule_cert_csr.pem3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 証明局に証明書署名要求を送信します。同じ証明局が Satellite Server と Capsule Server の証明書に署名する必要があります。
要求を送信する場合は、証明書の有効期限を指定してください。証明書要求を送信する方法は異なるため、推奨の方法について認証局にお問い合わせください。要求への応答で、認証局バンドルと署名済み証明書を別々のファイルで受け取ることになります。
2.6.2.2. カスタムの SSL 証明書の Capsule Server へのデプロイ リンクのコピーリンクがクリップボードにコピーされました!
この手順を使用して、証明局が署名したカスタムの SSL 証明書で、Capsule Server を設定します。capsule-certs-generate コマンドにより返される、satellite-installer コマンドは、Capsule Server ごとに一意となっています。複数の Capsule Server に同じコマンドを使用しないでください。
前提条件
カスタムのサーバー証明書で Capsule Server を設定する前に、Satellite Server と Capsule Server が以下の条件を満たすように確認してください。
- Satellite Server は、カスタムの証明書で設定されている。詳細は、『オンラインネットワークからの Satellite Server のインストール』の「カスタムの SSL 証明書を使用した Satellite Server の設定」を参照してください。
- Capsule Server が Satellite Server に登録されている。詳細は、「Satellite Server への登録」を参照してください。
- Capsule Server パッケージがインストールされている。詳細は、「Capsule Server パッケージのインストール」 を参照してください。
手順
カスタムの SSL 証明書で Capsule Server を設定するには、以下の手順を実行します。
Satellite Server で、カスタムの SSL 証明書の入力ファイルを検証します。
katello-certs-check \ -c /root/capsule_cert/capsule_cert.pem \ -k /root/capsule_cert/capsule_cert_key.pem \ -b /root/capsule_cert/ca_cert_bundle.pem
# katello-certs-check \ -c /root/capsule_cert/capsule_cert.pem \1 -k /root/capsule_cert/capsule_cert_key.pem \2 -b /root/capsule_cert/ca_cert_bundle.pem3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドに成功すると、
capsule-certs-generateコマンド 2 つが返されます。このうちのいずれか 1 つを、Capsule Server の証明書アーカイブの生成に使用する必要があります。katello-certs-check の出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Satellite Server で、
katello-certs-checkコマンドの出力をもとに、要件に合わせて、capsule-certs-generateコマンドを入力し、新規または既存の Capsule の証明書を生成します。このコマンドでは、$CAPSULEは、お使いの Capsule Server の FQDN に置き換えます。 capsule-certs-generateコマンドが返すsatellite-installerコマンドのコピーをメモし、Capsule Server に証明書をデプロイします。capsule-certs-generate の出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Satellite Server から、証明書アーカイブファイルを Capsule Server にコピーします。
scp /root/capsule.example.com-certs.tar \ root@capsule.example.com:/root/capsule.example.com-certs.tar
# scp /root/capsule.example.com-certs.tar \ root@capsule.example.com:/root/capsule.example.com-certs.tarCopy to Clipboard Copied! Toggle word wrap Toggle overflow Capsule Server で、証明書をデプロイするには、
capsule-certs-generateコマンドにより返されたsatellite-installerコマンドを入力します。Satellite へのネットワーク接続やポートをまだ開いていない場合は、
--foreman-proxy-register-in-foremanオプションをfalseに設定すると、Capsule が Satellite へ接続を試行しなくなり、エラー報告がなくなります。ネットワークとファイアウォールを適切に設定したら、このオプションをtrueにして再度インストーラーを実行します。重要証明書をデプロイした後に、証明書アーカイブを削除しないでください。このアーカイブは、Capsule Server のアップグレード時などに必要になります。
2.6.2.3. ホストへの カスタム SSL 証明書のデプロイ リンクのコピーリンクがクリップボードにコピーされました!
Capsule Server がカスタムの SSL 証明書を使用するよう設定した後に、Capsule Server に登録されている全ホストに katello-ca-consumer パッケージもインストールする必要があります。
BZ#1683835 が解決されるまで、katello-ca-consumer パッケージはアップグレードできません。以前のパッケージを削除して、新しいパッケージをインストールする必要があります。katello-ca-consumer パッケージをアップグレードすると、subscription.rhsm.redhat.com の baseurl 設定が元に戻るため、アップグレードに失敗します。
手順
各ホストで、以下の手順を実行し、katello-ca-consumer パッケージをインストールします。
ホストで現行の
katello-ca-consumerパッケージを削除します。yum remove 'katello-ca-consumer*'
# yum remove 'katello-ca-consumer*'Copy to Clipboard Copied! Toggle word wrap Toggle overflow ホストに
katello-ca-consumerパッケージをインストールします。yum localinstall \ http://capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
# yum localinstall \ http://capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpmCopy to Clipboard Copied! Toggle word wrap Toggle overflow