发行注记
版本 2.3
Red Hat Modernization and Migration Documentation Team
ccs-mms-docs@redhat.com摘要
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
第 1 章 Migration Toolkit for Virtualization 2.3
您可以使用 Migration Toolkit for Virtualization (MTV) 将虚拟机从 VMware vSphere 或 Red Hat Virtualization 迁移到 OpenShift Virtualization。
本发行注记描述了技术变化、新功能和增强以及已知问题。
1.1. 技术变化
此发行版本有以下技术更改:
设置 VddkInitImage 路径是添加 VMware 提供程序的步骤的一部分。
在 web 控制台中,在添加 VMware 供应商时输入 VddkInitImage 路径。或者,通过 CLI,您可以将 VddkInitImage 路径添加到 VMware 迁移的 Provider CR 中。
需要为非供应商存储类更新 StorageProfile 资源
您必须为非供应商存储类(如 NFS)更新带有 accessModes 和 volumeMode 的 StorageProfile 资源。文档包括到相关步骤的链接。
1.2. 新功能及功能增强
此发行版本有以下功能及改进:
MTV 2.3 支持从 RHV 进行温迁移
您可以使用温迁移从 VMware 和 RHV 中迁移虚拟机。
为 VMware 用户建立了足够多的权限集合
VMware 用户不必具有完整的 cluster-admin 权限才能执行虚拟机迁移。创建并记录了最少的足够的用户权限。
在 MTV 文档中更新了与使用 hook 相关的内容
MTV 文档包括了为迁移计划和在虚拟机上运行 hook 添加 hook 的说明。
1.3. 已知问题
这个版本有以下已知问题:
来自 RHV 的一些温迁移可能会失败
当您运行一个从 RHV 对多个 VM 进行温迁移的迁移计划时,一些虚拟机的迁移可能会在截止阶段失败。在这种情况下,重启迁移计划并为第一次运行的虚拟机迁移设置截止时间。(BZ#2063531)
温迁移后不会删除快照
在成功进行 RHV 虚拟机迁移后,Migration Controller 服务不会删除快照。您可以手动删除快照。(BZ#22053183)
如果在源虚拟机上执行快照操作,则来自 RHV 的迁移会失败
如果用户在源虚拟机上执行快照操作,则迁移失败,而不是等待用户的快照操作完成。(BZ#2057459)
在迁移的虚拟机上不会安装 QEMU 客户机代理
QEMU 客户机代理不会在迁移的虚拟机上安装。临时解决方案:使用迁移后 hook 安装 QEMU 客户机代理。(BZ#2018062)
删除迁移计划不会删除临时资源。
删除迁移计划不会删除 importer pod、conversion pod、配置映射、secret、失败的虚拟机和数据卷等临时资源。(BZ#2018974) 您必须在删除迁移计划前归档迁移计划来清理临时资源。
没有操作系统的虚拟机的错误消息不明确
web 控制台的 Migration Plan 详情页面没有明确指明因没有操作系统造成错误的原因。(BZ#2008846)
日志文件包括已删除迁移计划或虚拟机的日志
如果您删除迁移计划,然后使用相同名称运行新的迁移计划,或者如果您删除迁移的虚拟机,则 MTV web 控制台创建的日志文件可能会包括已删除的迁移计划或虚拟机的日志。(BZ#2023764)
迁移具有加密分区的虚拟机会在转换阶段失败
vSphere 和 RHV 迁移都会出现这个问题。
仅 MTV 2.3.4 :当源供应商是 RHV 时,在网络映射阶段或存储映射阶段复制迁移计划会失败。
可能的临时解决方案:在浏览器中删除缓存或重启浏览器。(BZ#2143191)
第 2 章 Migration Toolkit for Virtualization 2.2
您可以使用 Migration Toolkit for Virtualization (MTV) 将虚拟机从 VMware vSphere 或 Red Hat Virtualization 迁移到 OpenShift Virtualization。
本发行注记描述了技术变化、新功能和增强以及已知问题。
2.1. 技术变化
此发行版本有以下技术更改:
为 warm 迁移设置 precopy 时间间隔
您可以在 warm 迁移的预复制阶段设置快照之间的时间间隔。
2.2. 新功能及功能增强
此发行版本有以下功能及改进:
创建验证规则
您可以创建自定义验证规则来检查迁移的虚拟机是否可行。验证规则基于 Provider Inventory 服务收集的 VM 属性,并使用 Rego 写入的 Open Policy Agent 原生查询语言。
使用 Web 控制台下载日志
您可以使用 MTV web 控制台下载迁移计划的日志或迁移的虚拟机。
使用 Web 控制台复制迁移计划
您可以使用 Web 控制台(包括虚拟机、映射和 hook)来复制迁移计划,以便编辑副本并作为新的迁移计划运行。
使用 Web 控制台归档迁移计划
您可以使用 MTV web 控制台归档迁移计划。可查看或复制已归档的计划。它们不能运行、编辑或取消存档。
2.3. 已知问题
这个版本有以下已知问题:
某些验证服务问题不会阻止迁移
特定的 Validation 服务问题被标记为 Critical 并显示评估信息(The VM will not be migrated)不会阻塞迁移。(BZ#2025977)
以下 Validation 服务评估不会阻止迁移:
表 2.1. 不会阻止迁移的问题
| 评估 | 结果 |
|---|---|
| OpenShift Virtualization 不支持磁盘接口类型(只支持 sata、virtio_scsi 和 virtio 接口类型)。 | 如果无法识别源接口,则迁移的虚拟机将有一个 virtio 磁盘。 |
| OpenShift Virtualization 不支持 NIC 接口类型(仅支持 e1000、rtl8139 和 virtio 接口类型)。 | 如果无法识别源接口,则迁移的虚拟机将有一个 virtio NIC。 |
| 虚拟机使用为主机设备透传配置的 vNIC 配置集,OpenShift Virtualization 当前不支持该配置集。 | 迁移的虚拟机会有一个 SR-IOV NIC。目的地网络必须正确设置。 |
| 一个或多个虚拟机磁盘具有 illegal 或 locked 状态条件。 | 迁移将进行,但磁盘传输可能会失败。 |
|
虚拟机有一个带有不是 | 迁移将进行,但磁盘传输可能会失败。 |
| 虚拟机具有一个或多个带有 ILLEGAL 状态的磁盘的快照。OpenShift Virtualization 当前不支持它。 | 迁移将进行,但磁盘传输可能会失败。 |
| 虚拟机启用了 USB 支持,但 OpenShift Virtualization 目前不支持 USB 设备。 | 迁移的虚拟机没有 USB 设备。 |
| 虚拟机使用 watchdog 设备配置,该设备目前不受 OpenShift Virtualization 支持。 | 迁移的虚拟机没有 watchdog 设备。 |
|
虚拟机的状态不是 | 迁移将进行,但在虚拟机无法关闭时可能会挂起。 |
在迁移的虚拟机上不会安装 QEMU 客户机代理
QEMU 客户机代理不会在迁移的虚拟机上安装。临时解决方案:使用迁移后 hook 安装 QEMU 客户机代理。(BZ#2018062)
在 current.log 文件中缺少资源造成错误的消息
如果资源不存在,例如,如果因为迁移的虚拟机已关闭造成 virt-launcher pod 不存在,则其日志不可用。
当从 web 控制台下载或使用 must-gather 工具创建时,以下错误信息会出现在缺少资源的 current.log 文件中:error: expected 'logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]'.(BZ#2023260)
温迁移后,Importer pod 日志不可用
为调试而保留的 importer pod 会导致温迁移在 precopy 阶段挂起。(BZ#2016290)
作为临时解决方案,importer pod 会在 precopy 阶段的末尾被删除,以便 precopy 可以成功。但是,这意味着,在温迁移完成后不会保留 importer pod 日志。在 precopy stage 中,您只能使用 oc logs -f <cdi-importer_pod> 命令来查看 importer pod 日志。
此问题仅影响 importer pod 日志和温迁移。冷迁移和 virt-v2v 日志不会受到影响。
删除迁移计划不会删除临时资源。
删除迁移计划不会删除 importer pod、conversion pod、配置映射、secret、失败的虚拟机和数据卷等临时资源。(BZ#2018974) 您必须在删除迁移计划前归档迁移计划来清理临时资源。
没有操作系统的虚拟机的错误消息不明确
web 控制台的 Migration Plan 详情页面没有明确指明因没有操作系统造成错误的原因。(BZ#2008846)
在 Plan CR 中根据名称引用的网络、存储和虚拟机不会在 web 控制台中显示。
如果 Plan CR 引用存储、网络或虚拟机名称而非 ID,则资源不会出现在 MTV web 控制台中。迁移计划无法编辑或重复。(BZ#1986020)
日志文件包括已删除迁移计划或虚拟机的日志
如果您删除迁移计划,然后使用相同名称运行新的迁移计划,或者如果您删除迁移的虚拟机,则 MTV web 控制台创建的日志文件可能会包括已删除的迁移计划或虚拟机的日志。(BZ#2023764)
如果在迁移过程中删除了目标虚拟机,在 Plan CR 中的迁移状态为 Succeeded
如果您在迁移的 Convert image to kubevirt 步骤中删除了目标 VirtualMachine CR,则 web 控制台的 Migration 详情页面会显示步骤的状态为 VirtualMachine CR not found。但是,在 Plan CR 文件和 web 控制台中,虚拟机迁移的状态为 Succeeded。(BZ#2031529)
第 3 章 Migration Toolkit for Virtualization 2.1
您可以使用 Migration Toolkit for Virtualization (MTV) 将虚拟机从 VMware vSphere 或 Red Hat Virtualization 迁移到 OpenShift Virtualization。
本发行注记描述了新功能及改进、已知问题和技术变化。
3.1. 技术变化
添加至 HyperConverged 自定义资源的 VDDK 镜像
VMware Virtual Disk Development Kit (VDDK) SDK 镜像必须添加到 HyperConverged 自定义资源中。在此发行版本中,它在 v2v-vmware 配置映射中引用。
3.2. 新功能及功能增强
此发行版本添加了以下功能及改进。
从 Red Hat Virtualization 进行冷迁移
您可以从 Red Hat Virtualization 执行虚拟机的冷迁移。
迁移 hook
您可以创建迁移 hook,以在迁移之前或之后运行 Ansible playbook 或自定义代码。
过滤的 must-gather 数据收集
您可以为 must-gather 工具指定选项,以便按命名空间、迁移计划或虚拟机过滤数据。
SR-IOV 网络支持
如果 OpenShift Virtualization 环境具有 SR-IOV 网络,您可以使用单个根 I/O 虚拟化 (SR-IOV) 网络接口迁移虚拟机。
3.3. 已知问题
在迁移的虚拟机上不会安装 QEMU 客户机代理
QEMU 客户机代理不会在迁移的虚拟机上安装。临时解决方案:使用迁移后 hook 安装 QEMU 客户机代理。(BZ#2018062)
磁盘复制阶段不会进行
RHV 虚拟机的磁盘复制阶段没有进行,MTV web 控制台不会显示出错信息。(BZ#1990596)
造成这个问题的原因可能是以下条件之一:
- 目标集群上不存在存储类。
-
VDDK 镜像还没有添加到
HyperConverged自定义资源中。 - 虚拟机没有磁盘。
- VM 磁盘已锁定。
- VM 时区被设置为 UTC。
- 虚拟机为 USB 设备配置。
要禁用 USB 设备,请参阅 Red Hat Virtualization 文档中的 配置 USB 设备。
要确定原因:
- 在 OpenShift Container Platform web 控制台中点 Workloads → Virtualization。
- 点 Virtual Machines 标签页。
- 选择虚拟机以打开 Virtual Machine Overview 屏幕。
- 点 Status 查看虚拟机的状态。
VM 时区必须是没有偏移的 UTC
源虚拟机的时区必须是 UTC,且无偏移。在评估对工作负载的潜在影响后,您可以将时区设置为 GMT Standard Time。(BZ#1993259)
RHV 资源 UUID 会导致 "Provider not found" 错误
如果在 Host, NetworkMap, StorageMap, 或 Plan 自定义资源 (CR) 中使用 RHV 资源 UUID,则会显示 "Provider not found" 错误。
您必须使用资源名称。(BZ#1994037)
在不同数据中心的相同 RHV 资源名称会导致模糊引用
如果在 NetworkMap、StorageMap 或 Plan 自定义资源 (CR) 中使用 RHV 资源名称,如果另一个数据中心中存在相同的资源名称,Plan CR 会显示一个关键 "Ambig reference" 条件。您必须重命名资源或使用 CR 中的资源 UUID。
在 web 控制台中,资源名称会在同一列表中出现两次,而没有数据中心引用来区分它们。您必须重命名资源。(BZ#1993089)
温迁移后不会删除快照
成功迁移 VMware VM 后,不会删除快照。您必须在 VMware vSphere 中手动删除快照。(BZ#2001270)
第 4 章 Migration Toolkit for Virtualization 2.0
您可以使用虚拟化的 Migration Toolkit for Virtualization (MTV) 从 VMware vSphere 中迁移虚拟机。
本发行注记描述了新功能及改进、已知问题和技术变化。
4.1. 新功能及功能增强
此发行版本添加了以下功能及改进。
温迁移
温迁移会在虚拟机运行时在预复制阶段复制大多数虚拟机数据,从而缩短停机时间。在 cutover 阶段,虚拟机将停止,并复制其余的数据。
取消迁移
您可以在迁移过程中取消整个迁移计划或单个虚拟机。可以重启已取消的迁移计划以迁移剩余的虚拟机。
迁移网络
您可以为源和目标供应商选择迁移网络以提高性能。默认情况下,使用 VMware 管理网络和 OpenShift Container Platform pod 网络复制数据。
验证服务
验证服务检查源虚拟机是否有可能会影响迁移的问题,并标记迁移计划中问题。
验证服务只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。
有关红帽技术预览功能支持范围的详情,请参考 https://access.redhat.com/support/offerings/techpreview/。
4.2. 已知问题
本节描述了已知问题和缓解措施。
在迁移的虚拟机上不会安装 QEMU 客户机代理
QEMU 客户机代理不会在迁移的虚拟机上安装。临时解决方案:使用迁移后 hook 安装 QEMU 客户机代理。(BZ#2018062)
Network map 显示 "Destination network not found" 错误
如果网络映射处于 NotReady 状态,并且 NetworkMap 清单显示 Destination network not found 错误,则原因为缺少的网络附加定义。在创建网络映射前,您必须为每个额外网络创建 网络附加定义。(BZ#1971259)
温迁移在第三个 precopy 期间会卡住
温迁移使用更改的块跟踪快照在 precopy 阶段复制数据。默认情况下,快照以一小时的间隔创建。创建快照时,其内容将复制到目标集群。但是,当创建第三个快照时,第一个快照将被删除,块跟踪将会丢失。(BZ#1969894)
您可以执行以下操作之一来缓解这个问题:
- 在 precopy 阶段开始后的一个小时内启动 cutover 阶段,以便只创建一个内部快照。
将
vm-import-controller-config配置映射中的快照间隔增加到720分钟:$ oc patch configmap/vm-import-controller-config \ -n openshift-cnv -p '{"data": \ {"warmImport.intervalMinutes": "720"}}'