vProtect: Hyper-v backup fails with [Export] ExternalAPIException: Internal Server Error

Summary: After initial agent installation, vProtect Hyper-v backup fails with [Export] ExternalAPIException: Internal Server Error

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.

Symptoms

Hyper-v backup fails with [Export] ExternalAPIException: Internal Server Error.

An exception similar to the following is in the node logs:

[2024-03-14 11:01:33.667] ERROR [pool-5-thread-28] HypervRequestSender.send:43
[3eab164e-e3c8-45ea-9fcd-dc8e5f408f7d] ApiException, code 500

[2024-03-14 11:01:33.667] ERROR [pool-5-thread-28] ExportTask.run:135
[3eab164e-e3c8-45ea-9fcd-dc8e5f408f7d] 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.convertSnapshot(HypervApi.java:360) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.vmexport.DdBoostExport.exportIncremental(DdBoostExport.java:206) ~[engine.jar:?] 

The agent logs have an error similar to the following: 

ExceptionMessage:	Could not load type 'DDBoost.ConnectorsPool' from assembly 'DDBoost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null'.
ExceptionType:		System.TypeLoadException
StackTrace:
   at HyperVAgent.FileTransfer.DdBoostService.UploadConfiguration(String vmName, String exportConfPath, String backupFileName, DdBoostBackupDestination ddBoostBackupDestination)
   at HyperVAgent.Controllers.DdBoostController.UploadVmConfiguration(String vmName, DdBoostBackupDestinationDTO ddBoostBackupDestinationDto)
   at lambda_method(Closure , Object , Object[] )

Cause

Required Microsoft Visual C++ Redistributable 2013 and 2015 packages have not been installed on the hypervisor.

Resolution

Agent installation requires .NET Framework 4.7.2 or higher, Microsoft Visual C++ Redistributable 2013 and 2015. 

vcredist_x64 is distributed with the agent, and can be found in the following location:

C:\Program Files\vProtect\Hyper-V Agent\bin

Affected Products

vProtect
Article Properties
Article Number: 000224085
Article Type: Solution
Last Modified: 03 Apr 2025
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.