第 22 章 工具
22.1. oVirt Engine Rename 工具
22.1.1. oVirt Engine Rename 工具
当 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/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
命令为管理器运行的 Web 服务器创建新证书,但它不会影响 Manager 或证书颁发机构的证书。因此,使用 ovirt-engine-rename
命令有一些风险,特别是在从 Red Hat Enterprise Virtualization 3.2 及更早版本升级的环境中。因此,建议尽可能运行 engine-cleanup
和 engine-setup
更改管理器的完全限定域名。
在升级过程中,必须解析旧主机名。如果 oVirt Engine Rename Tool 失败并显示消息 [ ERROR ] Host name is not valid: <OLD FQDN> 没有解析到 IP 地址
,请将旧主机名添加到 /etc/hosts
文件中,使用 oVirt Engine Rename Tool,然后从 /etc/hosts
文件中删除旧主机名。
22.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
命令更改的文件的路径和文件名。
22.1.3. 使用 oVirt Engine Rename 工具重命名 Manager
您可以使用 ovirt-engine-rename
命令更新 Manager 的完全限定域名(FQDN)的记录。
ovirt-engine-rename
命令不会更新 SSL 证书,如 imageio-proxy
或 websocket-proxy
。在运行 ovirt-engine-rename
后,必须手动更新这些。请参阅以下 更新 SSL 证书。
工具可检查 Manager 是否提供本地 ISO 还是数据存储域。如果存在,工具会提示用户弹出、关闭或置于维护模式,然后再继续操作。这样可确保虚拟机不会与其虚拟磁盘的连接,并防止 ISO 存储域在重命名过程中丢失连接。
使用 oVirt Engine Rename 工具
- 为新的 FQDN 准备所有 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 的新 FQDN:
New fully qualified server name:new_engine_fqdn
ovirt-engine-rename
命令会更新 Manager 的 FQDN 记录。
对于自托管引擎,请完成以下步骤:
在每个现有的自托管引擎节点上运行以下命令:
# hosted-engine --set-shared-config fqdn new_engine_fqdn --type=he_local
此命令修改每个自托管引擎节点的
/etc/ovirt-hosted-engine-ha/hosted-engine.conf
的本地副本中的 FQDN在其中一个自托管引擎节点上运行以下命令:
# hosted-engine --set-shared-config fqdn new_engine_fqdn --type=he_shared
此命令修改共享存储域的
/etc/ovirt-hosted-engine-ha/hosted-engine.conf
主副本中的 FQDN。
现在,所有新的和现有的自托管引擎节点都使用新的 FQDN。
更新 SSL 证书
在 ovirt-engine-rename
命令后面运行以下命令以更新 SSL 证书:
1. # names="websocket-proxy imageio-proxy"
2. # subject="$(\ openssl x509 \ -in /etc/pki/ovirt-engine/certs/apache.cer \ -noout \ -subject | \ sed \ 's;subject= \(.*\);\1;' )"
3. # . /usr/share/ovirt-engine/bin/engine-prolog.sh
4. # for name in $names; do /usr/share/ovirt-engine/bin/pki-enroll-pkcs12.sh \ --name="${name}" \ --password=mypass \ --subject="${subject}" \ --keep-key \ --san=DNS:"${ENGINE_FQDN}" done