3.9. 工具

当 engine-setup 命令在干净环境中运行时，命令会生成多个证书和密钥，该证书和密钥使用设置过程中提供的 Manager 的完全限定域名。如果稍后需要修改 Manager 的全限定域名（例如，由于将 Manager 托管管理器的计算机迁移到其他域），则必须更新完全限定域名的记录，以反映新的名称。ovirt-engine-rename 命令自动执行此任务。

ovirt-engine-rename 命令会在以下位置更新 Manager 的完全限定域名记录：

ovirt-engine-rename 命令的基本语法为：

# /usr/share/ovirt-engine/setup/bin/ovirt-engine-rename

该命令还接受以下选项：

您可以使用 ovirt-engine-rename 命令更新 Manager 的完全限定域名(FQDN)的记录。

工具可检查 Manager 是否提供本地 ISO 还是数据存储域。如果存在，工具会提示用户弹出、关闭或置于维护模式，然后再继续操作。这样可确保虚拟机不会与其虚拟磁盘的连接，并防止 ISO 存储域在重命名过程中丢失连接。

ovirt-engine-rename 命令会更新 Manager 的 FQDN 记录。

对于自托管引擎，请完成以下步骤：

现在，所有新的和现有的自托管引擎节点都使用新的 FQDN。

对于远程数据仓库部署，请在远程计算机上执行这些步骤（而不是在 Manager 机器上）：

引擎配置工具是用于为您的 Red Hat Virtualization 环境配置全局设置的命令行实用程序。该工具与存储在引擎数据库中的键值映射列表交互，并允许您检索和设置单个键的值，并且检索所有可用的配置键和值的列表。另外，可以为 Red Hat Virtualization 环境中的每个配置级别存储不同的值。

您可以从安装 Red Hat Virtualization Manager 的机器上运行引擎配置工具。如需有关使用方法的详细信息，请打印该命令的帮助输出：

# engine-config --help

常见任务：

USB Filter Editor 是一个 Windows 工具，用于配置 usbfilter.txt 策略文件。此文件中定义的策略规则会允许或拒绝特定 USB 设备从客户端机器自动透传到使用 Red Hat Virtualization Manager 管理的虚拟机。策略文件位于以下位置的 Red Hat Virtualization Manager 中： /etc/ovirt-engine/usbfilter.txt 更改 USB 过滤器策略不会生效，除非 Red Hat Virtualization Manager 上的 ovirt-engine 服务被重启。

从此 "Installers and Images for Red Hat Virtualization Manager" 主题中下载 USB Filter Editor。

默认 USB 设备策略为虚拟机提供对 USB 设备的基本访问权限；更新策略以允许使用其他 USB 设备。

双击桌面上的 USB 过滤编辑器快捷方式图标。

Red Hat USB Filter Editor 界面显示每个 USB 设备的 Class, Vendor, Product, Revision, 和 Action。允许在 Action 列中将允许 USB 设备设为 Allow ；禁止的设备设置为 Block。

USB 设备策略规则按照其列出的顺序处理。使用 Up 和 Down 按钮在列表中移动或低于规则。通用 块 规则需要保留为最低条目，以确保所有 USB 设备都被拒绝，除非 USB 过滤器编辑器中明确允许。

双击桌面上的 USB 过滤编辑器快捷方式图标。这会打开编辑器。

您已在 USB Filter Editor 中添加 USB 策略。您需要将 USB 过滤策略导出到 Red Hat Virtualization Manager，以便它们生效。

双击桌面上的 USB 过滤编辑器快捷方式图标。这会打开编辑器。

您已从 USB Filter Editor 中删除了 USB 策略。您需要将 USB 过滤策略导出到 Red Hat Virtualization Manager，以便它们生效。

在 USB 过滤器编辑器中搜索连接的 USB 设备以允许或阻止它们。

双击桌面上的 USB 过滤编辑器快捷方式图标。这会打开编辑器。

您已搜索附加的 USB 设备。USB 过滤策略需要导出到 Red Hat Virtualization Manager 才能生效。

USB 设备策略更改需要导出并上传到 Red Hat Virtualization Manager 中，以便更新的策略生效。上传策略并重启 ovirt-engine 服务。

双击桌面上的 USB 过滤编辑器快捷方式图标。这会打开编辑器。

在编辑前，必须下载并导入到 USB Filter Editor 中现有的 USB 设备策略。

RHV 镜像离散工具分析存储域和 RHV 数据库中的镜像数据。如果发现卷和卷属性的差异，它会警告您，当不会修复这些差异。在各种情况下使用该工具，例如：

输出示例：

 Checking storage domain c277ad93-0973-43d9-a0ca-22199bc8e801
    Looking for missing images...
    No missing images found
    Checking discrepancies between SD/DB attributes...
    image ef325650-4b39-43cf-9e00-62b9f7659020 has a different attribute capacity on storage(2696984576) and on DB(2696986624)
    image 852613ce-79ee-4adc-a56a-ea650dcb4cfa has a different attribute capacity on storage(5424252928) and on DB(5424254976)

 Checking storage domain c64637b4-f0e8-408c-b8af-6a52946113e2
    Looking for missing images...
    No missing images found
    Checking discrepancies between SD/DB attributes...
    No discrepancies found

一个日志集合工具包括在 Red Hat Virtualization Manager 中。这可让您在请求支持时从 Red Hat Virtualization 环境中轻松收集相关日志。

log collection 命令是 ovirt-log-collector。您需要以 root 用户身份登录，并为 Red Hat Virtualization 环境提供管理凭证。ovirt-log-collector -h 命令显示使用情况信息，包括 ovirt-log-collector 命令的所有有效选项列表。

日志收集器命令的基本语法为：

# ovirt-log-collector options  list all|clusters|datacenters
# ovirt-log-collector options collect

两种支持的操作模式是 列出 并收集。

除非指定了另一个参数，否则默认操作是将可用的主机与它们所属的数据中心和集群一起列出。系统会提示您输入用户名和密码来检索某些日志。

有大量参数可以进一步优化 ovirt-log-collector 命令。

常规选项

Red Hat Virtualization Manager Options

这些选项过滤日志集合，并指定 Red Hat Virtualization Manager 的身份验证详情。

这些参数可以合并用于特定命令。例如，ovirt-log-collector --user=admin@internal --cluster ClusterA,ClusterB --hosts "SalesHost"* 将用户指定为 admin@internal，并将日志集合限制为仅限在 A 和 B 中的 SalesHost 主机。

SSH 配置

PostgreSQL 数据库选项

必须指定数据库用户名和数据库名称，如果使用 pg-user 和 dbname 参数（如果从默认值更改了）

如果数据库不在本地主机上，则使用 pg-dbhost 参数。使用可选的 pg-host-key 参数来收集远程日志。必须在数据库服务器上安装 PostgreSQL SOS 插件，才能远程日志收集才能成功。

当在未指定附加参数的情况下运行 ovirt-log-collector 命令时，其默认行为是从 Red Hat Virtualization Manager 及其附加的主机收集所有日志。它还会收集数据库日志，除非添加了 --no-postgresql 参数。在以下示例中，运行日志收集器以从 Red Hat Virtualization Manager 和三个附加的主机收集所有日志。

# ovirt-log-collector
INFO: Gathering oVirt Engine information...
INFO: Gathering PostgreSQL the oVirt Engine database and log files from localhost...
Please provide REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
About to collect information from 3 hypervisors. Continue? (Y/n):
INFO: Gathering information from selected hypervisors...
INFO: collecting information from 192.168.122.250
INFO: collecting information from 192.168.122.251
INFO: collecting information from 192.168.122.252
INFO: finished collecting information from 192.168.122.250
INFO: finished collecting information from 192.168.122.251
INFO: finished collecting information from 192.168.122.252
Creating compressed archive...
INFO Log files have been collected and placed in /tmp/logcollector/sosreport-rhn-account-20110804121320-ce2a.tar.xz.
The MD5 for this file is 6d741b78925998caff29020df2b2ce2a and its size is 26.7M

Engine Vacuum 工具通过更新表和删除死行来维护 PostgreSQL 数据库，允许重复使用磁盘空间。有关 VACUUM 命令及其参数的信息，请参阅 PostgreSQL 文档。

Engine Vacuum 命令是 engine-vacuum。您必须以 root 用户身份登录，并为 Red Hat Virtualization 环境提供管理凭证。

或者，在使用 engine-setup 命令自定义现有安装时，也可以运行引擎 Vacuum 工具：

$ engine-setup
...
[ INFO  ] Stage: Environment customization
...
Perform full vacuum on the engine database engine@localhost?
This operation may take a while depending on this setup health and the
configuration of the db vacuum process.
See https://www.postgresql.org/docs/12/static/sql-vacuum.html
(Yes, No) [No]:

Yes 选项在完全详细模式下运行引擎 Vacuum 工具。

引擎 Vacuum 有两种模式：

engine-vacuum 命令的基本语法为：

# engine-vacuum

# engine-vacuum option

运行 engine-vacuum 命令，不带选项来执行标准撤离。

有几个参数可以进一步优化 engine-vacuum 命令。

常规选项

如果逻辑网络的名称超过 15 个字符，或包含非 ASCII 字符，系统会自动生成一个主机标识符 (vdsm_name) 名称；它包含字符 on，以及网络唯一标识符的前 13 个字符，例如 ona1b2c3d4e5f6g。这是显示在主机的日志文件中的名称。要查看逻辑网络名称及其自动生成的网络名称列表，请使用位于 /usr/share/ovirt-engine/bin/ 中的 VDSM-to-Network-Name Mapping 工具。

工具显示逻辑网络名称列表，它们映射到其对等主机标识符。

--host 是数据库服务器的 hostname/IP 地址。默认值为 localhost。

--port 是数据库服务器的端口号。默认值为 5432。--database 是数据库的名称。默认值为 engine，即 Manager 数据库。

--secure 启用与数据库的安全连接。默认情况下，工具会在没有安全连接的情况下运行。