第10章 Satellite Server または Capsule Server の名前の変更
Satellite Server または Capsule Server の名前を変更するには、satellite-change-hostname
スクリプトを使用する必要があります。
Satellite Server の名前を変更する場合は、すべての Satellite クライアントを再登録し、新しい Satellite ホスト名を指すように各 Capsule Server を設定する必要があります。カスタム SSL 証明書を使用する場合は、新しいホスト名で再生成する必要があります。virt-who を使用する場合は、新しいホスト名で virt-who 設定ファイルを更新する必要があります。
Capsule Server の名前を変更する場合は、すべての Capsule クライアントを再登録し、Satellite Web UI で Capsule ホスト名を更新する必要があります。カスタム SSL 証明書を使用する場合は、新しいホスト名で再生成する必要があります。
名前変更プロセスを実行すると、変更対象であるホストの Satellite Server 上の全サービスがシャットダウンされます。名前変更が完了すると、全サービスが再開されます。
10.1. Satellite Server の名前の変更
Satellite Server のホスト名は、Satellite Server のコンポーネント、すべての Capsule Server、および Satellite Server に登録されているホストが通信用に使用しています。この手順により、新規ホスト名への参照をすべて更新することができます。
外部認証を使用している場合は、satellite-change-hostname
スクリプトの実行後に、外部認証向けに Satellite Server を再設定する必要があります。satellite-change-hostname
スクリプトは、Satellite Server 用の外部認証を破棄してしまいます。外部認証の設定の詳細は、13章外部認証の設定 を参照してください。
virt-who を使用する場合、satellite-change-hostname
スクリプトを実行した後、新しいホスト名で virt-who 設定ファイルを更新する必要があります。詳細は、Configuring Virtual Machine Subscriptions in Red Hat Satellite の Modifying a virt-who Configuration を参照してください。
前提条件
-
hostname
コマンドとhostname -f
コマンドの両方で、Satellite Server の FQDN を返す必要があります。そうしないと、satellite-change-hostname
スクリプトが完了しません。hostname
コマンドが FQDN の代わりに Satellite Server のショートネームを返す場合、satellite-change-hostname
スクリプトの使用を試みる前に、hostnamectl set-hostname old_fqdn
を 使用して古い FQDN を正しく設定する必要があります。 - ホスト名を変更する前に、Satellite Server のバックアップを実行してください。名前変更プロセスが失敗した場合は、バックアップから復元してください。詳細は、8章Satellite Server および Capsule Server のバックアップ を参照してください。
- オプション: Satellite Server がカスタムの SSL 証明書をインストールしている場合は、ホストの新しい名前用に新しい証明書を取得すること。詳細は、Installing Satellite Server from a Connected Network の Configuring Satellite Server with a Custom SSL Certificate を参照してください。
手順
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"
- オプション: Satellite Server の新しいホスト名用にカスタム SSL 証明書を作成した場合は、Satellite インストールスクリプトを実行して証明書をインストールします。カスタム SSL 証明書のインストールに関する詳細は、Installing Satellite Server from a Connected Network の Deploying a Custom SSL Certificate to Satellite Server を参照してください。
すべての Satellite クライアントで以下のコマンドを入力して、ブートストラップ RPM を再インストールし、クライアントを再登録して、サブスクリプションを更新します。
この手順は、リモート実行機能を使用して実行できます。詳細は、Managing Hosts の Configuring and Setting up Remote Jobs を参照してください。
# yum remove -y katello-ca-consumer* # rpm -Uvh http://new-satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm # subscription-manager register \ --org="Default_Organization" \ --environment="Library" \ --force # subscription-manager refresh
すべての 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 new-satellite.example.com
Satellite Server で、すべての Capsule Server をリスト表示します。
# hammer capsule list
Satellite Server で、コンテンツを各 Capsule Server に同期します。
# hammer capsule content synchronize \ --id capsule_id_number