第2章 Capsule Server のインストール
Capsule Server をインストールする前に、お使いの環境がインストール要件を満たしていることを確認してください。詳細は、インストールのための環境準備 を参照してください。
2.1. Satellite Server への登録
この手順を使用して、Capsule Server をインストールするベースオペレーティングシステムを Satellite Server に登録します。
Red Hat サブスクリプションマニフェストの前提条件
- Satellite Server にマニフェストをインストールし、Capsule が所属する組織に適したリポジトリーが含まれている必要がある。
- マニフェストには、Capsule をインストールするベースオペレーティングシステムのリポジトリーと、Capsule に接続するクライアントが含まれている必要がある。
- リポジトリーは、同期されている必要がある。
マニフェストおよびリポジトリーに関する詳細は コンテンツ管理 の Red Hat サブスクリプションの管理 を参照してください。
プロキシーとネットワークの前提条件
- Satellite Server のベースシステムは、Capsule のベースオペレーティングシステムのホスト名を解決できる必要があり、Capsule のベースシステムは Satellite Server のベースオペレーティングシステムのホスト名を解決できる必要がある。
- Capsule Server と Satellite Server の間でクライアント証明書認証を使用した HTTPS 接続が可能であることを確認します。Capsule Server と Satellite Server 間の HTTP プロキシーはサポートされていません。
- 要件に合わせてホストとネットワークベースのファイアウォールを設定する必要がある。詳細は、Capsule Server のインストール の ポートとファイアウォールの要件 を参照してください。Satellite Web UI、Hammer CLI、または Satellite API のホスト登録機能を使用して、Satellite にホストを登録できます。詳細は、ホストの管理 の ホストの登録 を参照してください。
手順
- Satellite Web UI で、Hosts > Register Host に移動します。
- Activation Keys リストから、ホストに割り当てるアクティベーションキーを選択します。
- Generate をクリックして登録コマンドを作成します。
- ファイル アイコンをクリックして、コマンドをクリップボードにコピーします。
- SSH を使用してホストに接続し、登録コマンドを実行します。
-
/etc/yum.repos.d/redhat.repo
ファイルをチェックして、適切なリポジトリーが有効であることを確認します。
CLI 手順
Hammer CLI を使用してホスト登録コマンドを生成します。
# hammer host-registration generate-command \ --activation-keys "My_Activation_Key"
ホストが Satellite Server の SSL 証明書を信頼しない場合は、登録コマンドに
--insecure
フラグを追加して SSL 検証を無効にすることができます。# hammer host-registration generate-command \ --activation-keys "My_Activation_Key" \ --insecure true
- SSH を使用してホストに接続し、登録コマンドを実行します。
-
/etc/yum.repos.d/redhat.repo
ファイルをチェックして、適切なリポジトリーが有効であることを確認します。
API の手順
Satellite API を使用してホスト登録コマンドを生成します。
# curl -X POST https://satellite.example.com/api/registration_commands \ --user "My_User_Name" \ -H 'Content-Type: application/json' \ -d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"] }}'
ホストが Satellite Server の SSL 証明書を信頼しない場合は、登録コマンドに
--insecure
フラグを追加して SSL 検証を無効にすることができます。# curl -X POST https://satellite.example.com/api/registration_commands \ --user "My_User_Name" \ -H 'Content-Type: application/json' \ -d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"], "insecure": true }}'
アクティベーションキーを使用すると、その環境を簡単に指定できます。詳細は、コンテンツの管理 の アクティベーションキーの管理 を参照してください。
コマンドライン引数としてパスワードを入力するには、
username:password
構文を使用します。これにより、パスワードがシェル履歴に保存される可能性があることに注意してください。または、パスワードの代わりに一時的なパーソナルアクセストークンを使用することもできます。Satellite Web UI でトークンを生成するには、My Account > Personal Access Tokens に移動します。- SSH を使用してホストに接続し、登録コマンドを実行します。
-
/etc/yum.repos.d/redhat.repo
ファイルをチェックして、適切なリポジトリーが有効であることを確認します。