Adjusting VCF Management Services Runtime Proxy Read Timeout to support large file downloads by VCF Software Depot Service

Products

• VMware Cloud Foundation

Issue/Introduction

Downloading large files through the enterprise proxy server on VMware Cloud Foundation (VCF) 9.1 fails due to timeouts. The connection drops after 15 minutes, preventing the completion of long-running file downloads.

Environment

• Product: VMware Cloud Foundation (VCF)
• Version: 9.1
• Component: VCF Management Services Runtime

Cause

The VCF Management Services Runtime proxy server is configured with a default read timeout of 15 minutes. Any operation requiring a persistent connection longer than this interval results in a connection termination.

Resolution

The proxy server read timeout can be extended by modifying the VCF Management Services Runtime configuration using the Component Management APIs. The timeout can be adjusted to a value between 15 and 480 minutes.

Prerequisites:

• Ensure administrative access to the VCF Services Runtime.
• The [email protected] password is required for authentication.

Steps:

1. Execute the configuration script on the management host. Replace <platform_host>, <proxy_host>, and <proxy_port> with your environment-specific details:

$ ./proxy-read-timeout-config.sh \  --platform-host <platform_host> \  --proxy-host "<proxy_host>" \  --proxy-port <proxy_port> \  --read-timeout <timeout_in_minutes>

2. When prompted, provide the admin password for [email protected].
3. Review the configuration summary provided by the script.
4. Confirm the changes by entering y when prompted to proceed.
5. Once the task completes, retry the failed image download.

 

Additional Information

• The read-timeout value must be an integer between 15 and 480 minutes.
• Ensure that firewall settings allow for extended connection durations if the proxy timeout is increased significantly.