Vprotect：Hyper-V 备份失败并显示（导出）内部服务器错误

Summary: Hyper-V 备份失败并显示 vProtect 错误“ExternalAPIException：内部服务器错误”

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

备份失败，并显示“ExternalAPIException：内部服务器错误“

检查节点日志中是否存在如下所示的错误： 
[2024-04-10 20:24:18.531] ERROR [pool-5-thread-6] HypervRequestSender.send:43
[e4b640a5-7784-4195-a909-6294d3763d0f] ApiException, code 500

[2024-04-10 20:24:18.531] ERROR [pool-5-thread-6] ExportTask.run:135
[e4b640a5-7784-4195-a909-6294d3763d0f] Backup task failed:

com.dell.vprotect.engine.exception.ExternalAPIException: Internal Server Error
        at com.dell.vprotect.engine.hypervisor.hyperv.HypervRequestSender.send(HypervRequestSender.java:48) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.HypervApi.createAndUploadRctMap(HypervApi.java:283) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.vmexport.DdBoostExport.createAndUploadRctMapToDdBoostAndUpdateBackupFiles(DdBoost
Export.java:221) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.vmexport.DdBoostExport.lambda$exportIncremental$6(DdBoostExport.java:163) ~[engin
e.jar:?]

检查 Hyper-V vProtect 代理日志，错误将类似于以下内容： 
2024/04/10 20:27:06.761 [e4b640a5-7784-4195-a909-6294d3763d0f] Microsoft.Management.Infrastructure.CimException: The WS-Management service cannot process the request. The computed response packet size (585610) exceeds the maximum envelope size that is allowed (512000).
   at Microsoft.Management.Infrastructure.Internal.Operations.CimSyncEnumeratorBase`1.MoveNext()
   at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source)
   at Microsoft.Management.Infrastructure.CimSession.InvokeMethod(String namespaceName, CimInstance instance, String methodName, CimMethodParametersCollection methodParameters, CimOperationOptions options)

Cause

WSMan：\localhost\MaxEnvelopeSizeKb 的默认大小为 500（千字节），即 512,000 字节。

如果代理尝试通过 DDboost 传输的数据超过此数量，则会引发异常。

Resolution

访问托管具有失败备份的虚拟机的虚拟机管理程序。
检查 WSMan：\localhost\MaxEnvelopeSizeKb 的大小（PowerShell 作为管理员） 
PS C:\Users\Administrator> Get-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb


   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost

Type            Name                           SourceOfValue   Value
----            ----                           -------------   -----
System.String   MaxEnvelopeSizekb                              500


PS C:\Users\Administrator>

将值从默认值 500 增加到大于所发送字节数的值 
PS C:\Users\Administrator> Set-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb 600
PS C:\Users\Administrator> Get-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb


   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost

Type            Name                           SourceOfValue   Value
----            ----                           -------------   -----
System.String   MaxEnvelopeSizekb                              600


PS C:\Users\Administrator>

重新运行备份

Affected Products

vProtect
Article Properties
Article Number: 000224451
Article Type: Solution
Last Modified: 06 Mar 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.