本文說明如何排解「遷移至虛擬機器」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 數量不足。 | 請確認至少有 {required_free_inodes} 個 inode 可供 {mount_point} 檔案系統使用。對來源 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 OS 的 VM，但 Google Cloud不支援該作業系統。如要遷移 VM，作業系統必須轉換為支援的作業系統。您可以透過實驗計畫將 Amazon Linux 2 VM 遷移至 Google Cloud，將 OS 轉換為支援的 OS。如要執行轉換作業，請在來源 VM 上執行 mkdir -p
/etc/google/migrate/elevate_amazonlinux2_to_rocky 指令。對來源 VM 所做的變更會在後續的複製週期中生效。 |
| {os_description} 不支援將 BIOS 轉換為 UEFI。 | 如需 BIOS 轉換至 UEFI 的支援作業系統清單，請參閱產品說明文件 - 支援的作業系統。 |
| 不支援的作業系統：{os_description}。 | 如需支援的作業系統清單，請參閱產品說明文件 - 支援的作業系統。或者，您可以考慮使用磁碟遷移功能來遷移資料磁碟，請參閱「遷移 VM 磁碟」。 |
| {os_type} 作業系統不支援架構 {architecture}。 | 如需支援的架構清單，請參閱產品說明文件 - 支援的作業系統。 |
| 在架構為 {architecture} 的 {os_type} 作業系統上，不支援 BIOS 到 UEFI 的轉換。 | 如需 BIOS 轉換至 UEFI 的支援架構清單，請參閱產品說明文件 - 支援的作業系統。 |
| 無法偵測支援的 Linux 系統啟動載入程式，例如 Grub。這可能發生在舊版作業系統中，或是已安裝的作業系統不支援所選的啟動類型 (BIOS/UEFI) 時。 | 請參閱產品說明文件，查看支援的作業系統清單，並確認作業系統的啟動類型 (BIOS/UEFI) 已正確設定 - 支援的作業系統。 |
| 無法安裝 google-compute-engine 套件：{error_message} | 請嘗試解決潛在問題，然後手動安裝套件，或與支援團隊聯絡。如果您想繼續操作而不安裝這些套件，請在來源虛擬機器上執行 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} | 請嘗試解決潛在問題，然後手動安裝套件，或與支援團隊聯絡。如果您想繼續操作而不安裝這些套件，請在來源虛擬機器上執行 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 登錄檔巢狀結構體時逾時。 | 請參閱 Microsoft KB #2498915，壓縮可能膨脹的登錄檔巢狀結構，或與支援團隊聯絡。對來源 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 所做的變更會在後續的複製週期中生效。 |
由於第 {line_number} 行的尾隨逗號，無法剖析 /etc/fstab：{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 標示為髒磁碟分割區。 | 在來源 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 權限。 |
請確認 /etc/sudoers 可在來源 VM 上編輯，或執行 touch /etc/google/migrate/skip_editing_sudoers 來略過編輯 /etc/sudoers。請注意，如果未進行這些變更，透過身分與存取權管理角色授予 sudo 存取權，就無法在 VM 上運作。對來源 VM 所做的變更會在後續的複製週期中生效。 |
無法更新 /etc/sudoers：權限遭拒。這項設定是必要的，可讓訪客環境根據 IAM 角色為使用者新增 sudo 權限。 |
請確認 /etc/sudoers 可在來源 VM 上編輯，或執行 touch /etc/google/migrate/skip_editing_sudoers 來略過編輯 /etc/sudoers。請注意，如果未進行這些變更，透過身分與存取權管理角色授予 sudo 存取權，就無法在 VM 上運作。對來源 VM 所做的變更會在後續的複製週期中生效。 |
這張圖片已完成泛化 (sysprep.exe /generalize 已執行)。 |
請不要選取 generalize 選項，再重試。對來源 VM 所做的變更會在後續的複製週期中生效。 |
執行 sysprep.exe /generalize 時無法泛化圖片。 |
將來源圖片設為通用圖片，然後在未選取 generalize 選項的情況下重試。對來源 VM 所做的變更會在後續的複製週期中生效。 |
dpkg 套件設定錯誤，因此無法安裝套件：
{packages} |
執行 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 工具。VM 可能無法安全關閉。強制關機可能會導致資料遺失。 | 在執行切換前，請先安裝 VMware 工具或安全關閉 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 上安裝已移除、降級和排除的套件，以便還原應用程式功能。 |