KB10009 RHV/oVirt backup fails with "Failed to establish image transfer session" message

📚

Documentation

Installation guides, configuration steps, and product documentation.

Explore documentation →

🎧

Support

Create a support request or review your existing cases.

Go to support →

⬇️

Download trial

Download the product trial and try it out.

View downloads →

KB10009 RHV/oVirt backup fails with "Failed to establish image transfer session" message

Publish date: Jun 7, 2018
Modification date: Jul 16, 2026
Affected Version: Not specified (Items to verify)

Description

Full and incremental backups may fail on RHV hypervisor managers or virtual machines when the Disk image transfer export/import mode is used. The failure occurs when the ImageProxyAddress value is incorrectly set or missing after an RHV/oVirt update. In this state, the image ticket cannot be added to the imageio-proxy, resulting in the following errors:

  • vprotect-daemon.log: ExternalAPIException: Failed to establish image transfer session

  • engine.log: EVENT_ID: TRANSFER_IMAGE_PAUSED_BY_SYSTEM_FAILED_TO_ADD_TICKET_TO_PROXY(1,070), Transfer was paused by system. Reason: failed to add image ticket to ovirt-imageio-proxy.

As a result, the image transfer session cannot be initialized, causing backup tasks to fail and creating operational downtime for affected backup operations.

Solution

  1. From the RHV/oVirt web admin console, open the upload disk dialog and click the Test Connection button to test the connection between WebAdmin and the proxy.

  2. If the test fails, re-import the certificate to the browser and run the test again.

  3. Verify and correct the ImageProxyAddress value using engine-config. Ensure it is set to engine-hostname:54323 instead of localhost.

Check the current configuration:

engine-config -g ImageProxyAddress

Set the correct address:

engine-config -s ImageProxyAddress=<engine-hostname>:54323

Keywords

RHV, oVirt, Disk image transfer, ExternalAPIException, ImageProxyAddress, imageio-proxy, backup failure, TRANSFER_IMAGE_PAUSED_BY_SYSTEM_FAILED_TO_ADD_TICKET_TO_PROXY.

Additional information

Related references for context: