第18章 ユーティリティー
18.1. oVirt エンジンの名前変更ツール
18.1.1. oVirt エンジンの名前変更ツール
engine-setup コマンドをクリーンな環境で実行すると、コマンドは、セットアッププロセス中に提供された Manager の完全修飾ドメイン名を使用する多数の証明書およびキーを生成します。Manager の完全修飾ドメイン名を後で変更する必要がある場合 (たとえば、Manager をホストしているマシンを別のドメインに移行したため)、完全修飾ドメイン名のレコードを更新して、新しい名前を反映する必要があります。ovirt-engine-rename コマンドは、このタスクを自動化します。
ovirt-engine-rename コマンドは、以下の場所にある Manager の完全修飾ドメイン名のレコードを更新します。
- /etc/ovirt-engine/engine.conf.d/10-setup-protocols.conf
- /etc/ovirt-engine/imageuploader.conf.d/10-engine-setup.conf
- /etc/ovirt-engine/isouploader.conf.d/10-engine-setup.conf
- /etc/ovirt-engine/logcollector.conf.d/10-engine-setup.conf
- /etc/pki/ovirt-engine/cert.conf
- /etc/pki/ovirt-engine/cert.template
- /etc/pki/ovirt-engine/certs/apache.cer
- /etc/pki/ovirt-engine/keys/apache.key.nopass
- /etc/pki/ovirt-engine/keys/apache.p12
警告
ovirt-engine-rename コマンドは、Manager が実行される Web サーバーの新しい証明書を作成しますが、エンジンや認証局の証明書には影響しません。このため、特に Red Hat Enterprise Virtualization 3.2 以前からアップグレードされた環境では、ovirt-engine-rename コマンドの使用に伴うリスクがあります。したがって、可能な場合は engine-cleanup および engine-setup を実行して Manager の完全修飾ドメイン名を変更することが推奨されます。
18.1.2. oVirt Engine Rename コマンドの構文
ovirt-engine-rename コマンドの基本的な構文は次のとおりです。
# /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
このコマンドは、次のオプションも受け入れます。
--newname=[new name]- ユーザーの操作なしで、Manager の新しい完全修飾ドメイン名を指定できます。
--log=[file]- 名前変更操作のログが書き込まれるファイルのパスおよび名前を指定できます。
--config=[file]- 名前変更操作にロードする設定ファイルのパスおよびファイル名を指定できます。
--config-append=[file]- 名前変更操作に追加する設定ファイルのパスおよびファイル名を指定できます。このオプションを使用して、応答ファイルのパスおよびファイル名を指定できます。
--generate-answer=[file]- 応答先となるファイルのパスとファイル名を指定でき、ovirt-engine-rename コマンドで変更された値が記録されます。
18.1.3. oVirt エンジンの名前変更ツールの使用
概要
ovirt-engine-rename コマンドを使用して、Manager の完全修飾ドメイン名のレコードを更新できます。
このツールは、Manager がローカル ISO またはデータストレージドメインを提供しているかどうかを確認します。その場合、ツールは、操作を続行する前に、ストレージに接続されている仮想マシンまたはストレージドメインをイジェクト、シャットダウン、またはメンテナンスモードにするようにユーザーに促します。これにより、仮想マシンが仮想ディスクとの接続を失うことがなくなり、名前の変更プロセス中に ISO ストレージドメインが接続を失うのを防ぐことができます。
手順18.1 Red Hat Virtualization Manager の名前変更
- 新しい完全修飾ドメイン名に、DNS およびその他の関連するレコードをすべて準備します。
- DHCP を使用している場合は、DHCP サーバーの設定を更新します。
- Manager のホスト名を更新します。
- 以下のコマンドを実行します。
# /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
- プロンプトが表示されたら、Enter を押してエンジンサービスを停止します。
During execution engine service will be stopped (OK, Cancel) [OK]:
- プロンプトが表示されたら、Manager の新しい完全修飾ドメイン名を入力します。
New fully qualified server name:[new name]
結果
ovirt-engine-rename コマンドは、Manager の完全修飾ドメイン名のレコードを更新します。
