CBTの要件を満たしていない仮想マシンのエージェントレスバックアップがエラーで失敗する

概要

CBTの要件を満たしていない仮想マシンのエージェントレスバックアップがエラーで失敗します。

原因

ESXiの仮想ゲストでエージェントレスバックアップを行う場合、VMwareのCBTを使用します。

仮想マシン上の変更ブロックのトラッキング（CBT）

https://knowledge.broadcom.com/external/article?legacyId=1020128

上記記事のResolutionに記載の項目を満たさない場合、CBTが正しく機能しないためエラーになります。

例えば、仮想マシンのハードウェアバージョンが7以前のゲストでエージェントレスバックアップを行う場合、赤字のエラーが記録され、Exit Code : -628 のエラーでバックアップは失敗します。

07/22/2024 05:41:31.556 Host name: localhost.localdomain, version: 6.0.0, sslthumbprint: BD:C4:32:36:22:0D:38:3E:42:80:B7:93:07:10:CB:D9:9B:DB:92:C0, port: 902 
07/22/2024 05:41:31.556 Check VM name: aaaa (UUID: 564d98cb-cb5a-d60e-b6db-d07bca699d88) 
07/22/2024 05:41:32.235 Guest OS: Microsoft Windows Server 2008 R2 (64-bit), Guest ID: windows7Server64Guest, CBT enabled: 0, VMXSpec: 6, CPU: 1, RAM: 4096 MB, Host: localhost.localdomain 
07/22/2024 05:41:32.235 Enable CBT for VM aaaa 
07/22/2024 05:41:32.477 Failed to change CBT for VM aaaa, return 0, A specified parameter was not correct: spec.changeTrackingEnabled Level = ERROR[0] 
07/22/2024 05:41:32.477 Skip backup VM aaaa 
07/22/2024 05:41:32.477 No valid backup source VM Level = ERROR[0] 
07/22/2024 05:41:32.477 #### ERROR TestConnectVMs() @ C:\Gitlab-Runner\builds\rzVgP-QGf\0\actiphy\activeimage-protector\Core\AipCopy\AgentlessBackup.cpp(511): -628 Level = ERROR[0] 
07/22/2024 05:41:32.478 {IDS_STRING3018}Exit Code: -628 
07/22/2024 05:41:32.478 [-628] Connect to VM error

vSphere Clientにも同じエラーが記録される

仮想マシンのバージョンの数値は、対象マシンの電源オン時にvmware.logに記録される virtualHW.version で確認可能です。

例) ハードウェア バージョン 4の場合

2024-07-22T05:38:47.703Z| vmx| I120: DICT virtualHW.version = "4"

解決策

仮想マシンバージョンが 7 未満の場合、仮想マシンのバージョンをアップグレードすることで問題は解決しますが、アップグレードによる影響についてはBroadcom社様にご確認下さい。

参考資料

仮想マシンのハードウェアを最新バージョンにアップグレードする（複数のバージョン）

https://knowledge.broadcom.com/external/article?legacyId=1010675

対象製品

- ActiveImage Protector 2018

- ActiveImage Protector 2022