本文說明如何排解 Migrate to Virtual Machines OS 調整錯誤和警告。
錯誤是指會阻礙 OS 調整作業執行的重大問題。這類錯誤表示有潛在問題需要立即處理和解決，否則無法繼續進行程序。警告並非致命錯誤，但可提供重要資訊供您參考。即使複製成功，這些訊息也會指出在改編過程中偵測到的潛在問題或不一致之處。
每個改編程序都會產生改編報告，詳細列出程序期間發生的任何錯誤或警告。
雖然大部分的 OS 調整作業都會自動完成，但有時您必須排解並修正錯誤和警告，才能完成複製程序。下列錯誤和警告會指出需要進行這類修改的情況。
OS 調整錯誤
下表列出您在 OS 調整程序中可能遇到的錯誤，以及各項錯誤的疑難排解資訊。
| 訊息 | 建議採取的行動 |
|---|---|
| 找不到 VM 磁碟上的作業系統。 | 確認 VM 磁碟包含有效的作業系統，且未經過加密 (例如使用 BitLocker 加密)。對來源 VM 所做的變更適用於後續的複製週期。 |
| VM 磁碟上有多個作業系統。找到的根檔案系統：{roots} | 標示要調整的作業系統。在 Windows 上執行 mkdir %SystemDrive%\Google\Migrate，在 Linux 上執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* > /etc/google/migrate/disk-mappings-hints。
對來源 VM 所做的變更適用於後續的複製週期。 |
| 多個根檔案系統標示了提示目錄。 | 請確認提示目錄只存在於單一根檔案系統。在 Windows 上：%SystemDrive%\Google\Migrate，在 Linux 上：/etc/google/migrate。對來源 VM 所做的變更適用於後續的複製週期。 |
| {mount_point} 檔案系統的 inode 不足。 | 確認 {mount_point} 檔案系統上至少有 {required_free_inodes} 個可用的 inode。對來源 VM 所做的變更適用於後續的複製週期。 |
| {mount_point} 磁碟區的磁碟空間不足。 | 確認 {mount_point} 磁碟區至少有 {required_free_space_mb} MB 的可用空間。建議您先建立來源快照，再對 {mount_point} 磁碟區進行變更。對來源 VM 所做的變更適用於後續的複製週期。 |
| Linux 核心缺少 VirtIO 驅動程式。 | 確認來源 VM 已安裝支援 VirtIO 驅動程式的 Linux 核心 (virtio_scsi,
virtio_net)。在 Compute Engine 上執行遷移的 VM 時，必須使用這些驅動程式。對來源 VM 所做的變更適用於後續的複製週期。 |
/etc/fstab 檔案包含不穩定的重要項目，例如非持續性區塊裝置名稱。 |
在來源 VM 上執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* >
/etc/google/migrate/disk-mappings-hints。對來源 VM 所做的變更適用於後續的複製週期。 |
| 「{file_path}」檔案包含不穩定的重要項目，例如非永久性區塊裝置名稱。 | 在來源 VM 上執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* >
/etc/google/migrate/disk-mappings-hints。對來源 VM 所做的變更適用於後續的複製週期。 |
| 找不到 {directory} 或 {directory} 為空白。 | 確認 {directory} 存在且不為空白，且不是指向遺失磁碟區的軟連結。對來源 VM 所做的變更適用於後續的複製週期。 |
| 找不到「{file}」。 | 確認 {file} 存在，且不是指向遺失磁碟區的軟連結。對來源 VM 所做的變更適用於後續的複製週期。 |
無法從 /etc/fstab 掛接重要項目，例如重複的 fstab 項目或遺失的裝置。錯誤：{error_details} |
檢查來源 VM 中的 /etc/fstab 設定，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 不支援的作業系統：{os_description}。 | 如需支援的作業系統清單，請參閱產品說明文件 -「支援的作業系統」。 |
| 不支援的作業系統：amazonlinux2.0。 | 您嘗試遷移執行 Amazon Linux 2 作業系統的 VM，但 Google Cloud不支援這類 VM。如要遷移 VM，必須將 OS 轉換為支援的 OS。將 OS 轉換為支援 OS 的功能屬於實驗計畫的一部分，請參閱「將 Amazon Linux 2 VM 遷移至 Google Cloud」。如要執行轉換，請在來源 VM 上執行 mkdir -p
/etc/google/migrate/elevate_amazonlinux2_to_rocky 指令。對來源 VM 所做的變更適用於後續的複製週期。 |
| {os_description} 不支援將 BIOS 轉換為 UEFI。 | 如需 BIOS 轉換為 UEFI 時支援的作業系統清單，請參閱產品說明文件「支援的作業系統」。 |
| 不支援的作業系統：{os_description}。 | 如需支援的作業系統清單，請參閱產品說明文件「支援的作業系統」。或者，您也可以考慮使用磁碟遷移功能遷移資料磁碟，詳情請參閱「遷移 VM 磁碟」。 |
| {os_type} 作業系統不支援 {architecture} 架構。 | 如需支援的架構清單，請參閱產品說明文件 -「支援的作業系統」。 |
| {os_type} 作業系統不支援將 BIOS 轉換為 UEFI，架構為 {architecture}。 | 如需支援 BIOS 轉換為 UEFI 的架構清單，請參閱產品說明文件「支援的作業系統」。 |
| 無法偵測到支援的 Linux 系統啟動載入程式，例如 Grub。如果作業系統較舊，或是所選啟動類型 (BIOS/UEFI) 不支援已安裝的作業系統，就可能發生這種情況。 | 如需支援的作業系統清單，請參閱產品說明文件，並確認作業系統的啟動類型 (BIOS/UEFI) 設定正確 - 支援的作業系統。 |
| 無法安裝 google-compute-engine 套件：{error_message} | 請嘗試解決基本問題並手動安裝套件，或與支援團隊聯絡。如要繼續操作但不安裝這些套件，請在來源 VM 上執行 mkdir -p /etc/google/migrate/skip_failed_install。
請注意，如果沒有訪客環境，部分 Compute Engine 功能可能無法運作。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 {package_name}：{error_message} | 請嘗試解決根本問題，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 {package_name}：{error_message} | 請嘗試解決基本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 {package_name}：{error_message} | 請嘗試解決基本問題並手動安裝套件，或與支援團隊聯絡。如要繼續操作但不安裝這些套件，請在來源 VM 上執行 mkdir -p /etc/google/migrate/skip_failed_install。
對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝或更新重要套件 {packages}，否則會破壞依附元件：{error_message} | 請嘗試在來源 VM 上手動安裝套件 {packages}，或與支援團隊聯絡。如要在遷移後修復損毀的套件，請在來源 VM 上執行 mkdir -p
/etc/google/migrate/skip_broken_packages。如要略過安裝程序，請在來源 VM 上執行 mkdir -p /etc/google/migrate/skip_failed_install。請注意，略過安裝步驟可能會導致後續步驟失敗。對來源 VM 所做的變更適用於後續的複製週期。 |
DISM安裝「{driver}」失敗，結束代碼為：
{exit_code} |
請與支援團隊聯絡，或參閱 Microsoft 說明文件「偵錯系統錯誤代碼」，修正錯誤。對來源 VM 所做的變更適用於後續的複製週期。 |
DISM 安裝 {driver} 失敗，結束代碼為 2 |
停用任何防毒或其他安全軟體，以免 DISM 無法存取檔案系統。如果問題仍未解決，請執行 sfc /scannow 和 dism /online /cleanup-image
/restorehealth 指令來修正問題。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法載入這個 VM 的 Windows 登錄檔。「{hive_name}」登錄檔區塊可能不一致。 | 重試複製週期、本機測試副本、轉換作業。如果問題仍未解決，請嘗試使用 Scanregw.exe修正登錄檔，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 載入 Windows 登錄檔 Hive 時逾時。 | 請參閱 Microsoft 知識庫文章 #2498915，瞭解如何壓縮可能過於龐大的登錄檔 Hive，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
無法使用 utf-8
編解碼器解碼 /etc/google/migrate/disk-mappings-hints。 |
重新執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* >
/etc/google/migrate/disk-mappings-hints，並確認寫入的輸出內容是否為有效的 UTF-8。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法在「{mountable}」上掛接檔案系統。這通常表示檔案系統不一致。 | 請使用 {tool_name} 等工具修正檔案系統。如果問題仍未解決，請與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
無法剖析 /etc/fstab，因為第 {line_number} 行的結尾有逗號：{line_content} |
請移除結尾的半形逗號，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
無法剖析 /etc/fstab，因為路徑中含有空白字元，位於第 {line_number} 行：{line_content} |
將空白字元替換為 \040，然後執行 mount -a 進行驗證，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
無法剖析 /etc/fstab，因為引號未在第 {line_number} 行終止或關閉：{line_content} |
移除未終止的報價或關閉報價，然後執行 mount -a 進行驗證，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
無法剖析第 {line_number} 行的「/etc/fstab」：{line_content} |
執行 mount -a 並修正產生的錯誤，或與支援團隊聯絡。
對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法剖析第 {line_number} 行的「{path}」：{line_content} | 請嘗試修正格式，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
即使 /boot 包含有效的 Linux 核心可執行檔，系統仍找不到任何已安裝的核心套件。 |
使用標準套件管理工具重新安裝核心。如果問題仍未解決，請聯絡支援團隊。對來源 VM 所做的變更適用於後續的複製週期。 |
找不到 /boot 底下的任何核心。 |
確認 /boot 包含有效的 Linux 核心可執行檔 (vmlinuz 或 Image)，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
在 /boot 下找不到任何 initrd 或 initramfs 圖片。 |
確認 /boot 包含有效的初始 RAM 磁碟映像檔 (initrd 或 initramfs)，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
/etc/fstab 檔案含有重大項目，缺少卷冊：
{specs}。 |
確認指定的磁碟區存在、更新 /etc/fstab
檔案、嘗試修正邏輯磁碟區設定，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法清除 {volumes_or_disks}。Windows 會將某些磁碟區標示為「Dirty」。 | 在來源 VM 的所有可用磁碟上執行 chkdsk /f。如果問題仍未解決，請與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
找不到「grub-mkconfig」和「grub2-mkconfig」。 |
安裝 grub2-common 套件。對來源 VM 所做的變更適用於後續的複製週期。 |
無法使用 grub-mkconfig 或 grub2-mkconfig 更新開機載入程式：{error_message} |
解決根本問題或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| {devices} 的分割區表無效。 | 使用 FixParts 等工具修正分區表。如果問題仍未解決，請聯絡支援團隊。對來源 VM 所做的變更適用於後續的複製週期。 |
設定 force_skip_verifications 旗標時，OS 無法調整。 |
在來源 VM 上執行下列指令，移除 force_skip_verifications 標記。在 Windows 上：執行 rmdir %SystemDrive%\Google\Migrate\force_skip_verifications，
在 Linux 上：執行 rmdir /etc/google/migrate/force_skip_verifications。 |
不支援 tboot。 |
從系統啟動載入程式設定中移除 tboot。對來源 VM 所做的變更適用於後續的複製週期。 |
無法更新「/etc/sudoers」。這是必要步驟，因為客層環境必須根據 IAM 角色，為使用者新增 sudo 權限。 |
確認來源 VM 上的 /etc/sudoers 可編輯，或執行 touch /etc/google/migrate/skip_editing_sudoers 來略過編輯 /etc/sudoers。
請注意，如果沒有這些變更，透過 IAM 角色授予 sudo 存取權將無法在 VM 上運作。對來源 VM 所做的變更適用於後續的複製週期。 |
無法更新「/etc/sudoers」：權限遭拒。這是必要步驟，因為客層環境必須根據 IAM 角色，為使用者新增 sudo 權限。 |
確認來源 VM 上的 /etc/sudoers 可編輯，或執行 touch /etc/google/migrate/skip_editing_sudoers 來略過編輯 /etc/sudoers。
請注意，如果沒有這些變更，透過 IAM 角色授予 sudo 存取權將無法在 VM 上運作。對來源 VM 所做的變更適用於後續的複製週期。 |
這張圖片已一般化 (已執行)。sysprep.exe /generalize |
請取消選取「generalize」選項，然後再試一次。對來源 VM 所做的變更適用於後續的複製週期。 |
執行 sysprep.exe /generalize 時，無法概括圖片。 |
將來源圖片一般化，然後在不選取「generalize」選項的情況下重試。對來源 VM 所做的變更適用於後續的複製週期。 |
由於套件設定錯誤，無法安裝套件：
{packages}dpkg |
執行 rm /var/cache/debconf/config.dat && dpkg --configure -a 重新建構
dpkg 設定。如果失敗或錯誤持續發生，請移除失敗的套件，再次重建 dpkg 設定，然後視需要重新安裝套件。對來源 VM 所做的變更適用於後續的複製週期。 |
設定「dpkg」時逾時。 |
執行 rm /var/cache/debconf/config.dat && dpkg --configure -a 重新建構
dpkg 設定。如果失敗或錯誤持續發生，請移除失敗的套件，再次重建 dpkg 設定，然後視需要重新安裝套件。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法啟動改編的 VM，完成轉換。 | 快照不一致導致啟動失敗。請嘗試關閉來源 VM、複製來源 VM 的關機狀態副本，或改用磁碟遷移功能。對來源 VM 所做的變更適用於後續的複製週期。 |
| 作業系統無法自動轉換為 Rocky Linux 8。 | 建議您使用 VM 磁碟遷移流程，將 VM 遷移至 Google Cloud。請參閱「遷移 VM 磁碟」。 |
| 執行個體沒有有效的啟動磁碟分割區或 EFI 磁碟分割區。 | 請確認執行個體包含開機磁碟分割區或 EFI 磁碟分割區，或與支援團隊聯絡。 |
OS 調整警告
下表列出您在 OS 調整程序中可能會遇到的警告，以及各項警告的疑難排解資訊。
| 訊息 | 建議採取的行動 |
|---|---|
| 下列套件已損毀，必須移除才能安裝重要套件：{packages} | 移除損壞的套件，並確認 VM 和應用程式是否正常運作。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法將「{requested_license}」授權套用至「{os_info}」。 | 從 {applicable_licenses} 中選擇適用的授權。 |
/etc/fstab 檔案包含不穩定的項目，例如非持續性區塊裝置名稱。 |
在來源 VM 上執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* >
/etc/google/migrate/disk-mappings-hints。對來源 VM 所做的變更適用於後續的複製週期。 |
/etc/fstab 檔案包含 {mount_type} 項目。 |
確認遷移後，目標 VM 可以存取所有 {mount_type} 項目，或目標 VM 成功啟動，但無法存取 {mount_type} 項目。對來源 VM 所做的變更適用於後續的複製週期。 |
| 「{file_path}」檔案包含不穩定的重要項目，例如非永久性區塊裝置名稱。 | 在來源 VM 上執行 mkdir -p /etc/google/migrate && ls -la /dev/disk/*/* >
/etc/google/migrate/disk-mappings-hints。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 google-compute-engine 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 google-osconfig-agent 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 google-cloud-sdk 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 google-cloud-cli 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 google-rhui-client 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 cloud-regionsrv-client：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 google-cloud-sap-agent：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝 dhcp-client 套件：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法安裝套件 {package_name}：{error_message} | 解決根本問題並手動安裝套件，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 缺少 VMware Tools。VM 可能無法正常關機。強制關機可能會導致資料遺失。 | 執行轉換作業前，請先安裝 VMware Tools 或正常關閉 VM。 對來源 VM 所做的變更適用於後續的複製週期。 |
| 安全性軟體「{software}」可能會導致首次啟動設定失敗，以及連線問題。 | 建立測試副本，並確認新的 VM 執行個體可以順利啟動，且網路連線正常。否則，請考慮停用「{software}」，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法將中繼資料伺服器新增至 {hosts_path}。 | 確認 {hosts_path} 存在，且使用者 (管理員) 可編輯。 對來源 VM 所做的變更適用於後續的複製週期。 |
| 無法設定 NTP 特殊輪詢間隔登錄值。 | 確認使用者：管理員可編輯登錄路徑 {path}。 等待系統套用變更，或手動編輯登錄檔，將值設為 {value}。對來源 VM 所做的變更適用於後續的複製週期。 |
| 下列其中一種設定檔類型：{profiles} 的網路輸出遭封鎖，且未與本機防火牆政策合併。這可能會導致首次啟動時設定失敗，以及連線問題。 | 建議您在所有提及的設定檔中將 AllowLocalPolicyMerge 設為 1，允許合併本機防火牆政策。或者，定義允許 RDP 和中繼資料伺服器存取的遠端政策，或與支援團隊聯絡。對來源 VM 所做的變更適用於後續的複製週期。 |
套件 cpio 遺失或設定錯誤，已安裝該套件以正確設定作業系統。已安裝 pax 套件，防止 CVE-2022-41352 安全漏洞。 |
如有需要，遷移作業完成後，可以移除 cpio 和 pax 套件。 |
| 部分套件沒有適當的替代方案，因此已移除、降級或排除在轉換作業之外。檢查 {removed_packages_file_path} 檔案，查看已移除的套件清單；檢查 {downgraded_packages_file_path} 檔案，查看已降級的套件清單；檢查 {excluded_packages_file_path} 檔案，查看已排除的套件清單。 | 視需要在目標 VM 上安裝已移除、降級及排除的套件，以還原應用程式功能。 |
| 系統在 XFS 檔案系統中偵測到不一致或損毀的情況，並已修復：{filesystem} | 您可以使用 xfs_repair 等工具，修復來源中損壞的檔案系統。如不想修復損毀的檔案系統，請使用 disable-xfs-repair 旗標。不過，這麼做可能會導致 OS 無法適應，進而引發其他問題。對來源 VM 所做的變更適用於後續的複製週期。 |