第13章 Satellite Server または Capsule Server の名前の変更
Satellite Server または Capsule Server の名前を変更するには、satellite-change-hostname
スクリプトを使用します。
Satellite Server または Capsule Server のドメイン名を変更する場合は、ネットワークの問題を回避するために、satellite-change-hostname
を使用してホスト名を更新します。
13.1. Satellite Server の名前の変更
Satellite Server のホスト名は、Satellite Server のコンポーネント、すべての Capsule Server、および Satellite Server に登録されているホストが通信用に使用しています。この手順により、Satellite Server の名前を変更するだけでなく、新しいホスト名を指すようにすべての参照も更新されます。
Satellite Server ホストの名前を変更すると、そのホスト上のすべての Satellite サービスがシャットダウンされます。名前変更が完了すると、サービスが再起動されます。
前提条件
- ホスト名を変更する前に、Satellite Server をバックアップしてください。名前の変更に失敗した場合は、バックアップから復元してください。詳細は、11章Satellite Server および Capsule Server のバックアップ を参照してください。
Satellite Server で
hostname
およびhostname -f
コマンドを実行します。どちらのコマンドも Satellite Server の FQDN を返さない場合、satellite-change-hostname
スクリプトは完了できません。hostname
コマンドが FQDN ではなく Satellite Server のショートネームを返す場合は、satellite-change-hostname
スクリプトを使用する前に、hostnamectl set-hostname My_Old_FQDN
を使用して古い FQDN を正しく設定します。- Satellite Server にカスタム SSL 証明書がインストールされている場合は、ホストの新しい FQDN の新しい証明書を取得します。詳細は、接続されたネットワーク環境で の Satellite Server のインストール の カスタム SSL 証明書を使用した Satellite Server の設定 を 参照してください。
手順
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"
- Satellite Server の新しいホスト名用にカスタム SSL 証明書を作成した場合は、Satellite インストールスクリプトを実行して証明書をインストールします。カスタム SSL 証明書のインストールに関する詳細は、接続されたネットワーク環境で の Satellite Server のインストール の カスタムの SSL 証明書の Satellite Server へのデプロイ を 参照してください。
- Satellite Server に登録されているすべてのホストと Capsule Server を再登録します。詳細は、ホストの 管理 の ホストの 登録 を参照してください。
すべての Capsule Server で、Satellite インストールスクリプトを実行して、新規ホスト名への参照を更新します。
# satellite-installer \ --foreman-proxy-foreman-base-url https://new-satellite.example.com \ --foreman-proxy-trusted-hosts new-satellite.example.com
Satellite Server で、すべての Capsule Server をリスト表示します。
# hammer capsule list
Satellite Server で、コンテンツを各 Capsule Server に同期します。
# hammer capsule content synchronize \ --id My_capsule_ID
- virt-who エージェントを使用する場合は、新しいホスト名で virt-who 設定ファイルを更新します。詳細は、仮想マシンサブスクリプションの設定 の virt-who 設定 の修正 を参照してください。
-
外部認証を使用している場合は、
satellite-change-hostname
スクリプトの実行後に、外部認証向けに Satellite Server を再設定します。詳細は、オンライン 接続されているネットワーク環境での Satellite Server のインストール の 外部認証の設定 を 参照してください。