HCX Internet Proxy Error

Products

• VMware HCX

Issue/Introduction

• Configuring a Proxy Server in HCX Manager 9443 page as outlined in Configure a Proxy Server

• In the Proxy Server configuration, http:// or https:// is used before the proxy FQDN, example:

• When attempting to test connection, the following error is observed:

• HCX Manager log shows similar to the following under /common/logs/appliance-management/appliance-management.log:

  2025-11-07 22:16:13.685 UTC [https-jsse-nio-9443-exec-7, , ] DEBUG o.s.w.s.m.m.a.HttpEntityMethodProcessor- Writing ["{"isSuccess":false,"message":"Unable to reach https:\/\/vcsa.vmware.com\/ from the proxy server http (truncated)..."]
  2025-11-07 22:16:13.685 UTC [https-jsse-nio-9443-exec-7, , ] DEBUG o.s.web.servlet.DispatcherServlet- Completed 500 INTERNAL_SERVER_ERROR
  2025-11-07 22:23:40.886 UTC [https-jsse-nio-9443-exec-3, , ] DEBUG o.s.web.servlet.DispatcherServlet- POST "/api/admin/global/config/verifyProxy", parameters={}
  2025-11-07 22:23:40.886 UTC [https-jsse-nio-9443-exec-3, , ] DEBUG o.s.w.s.m.m.a.RequestMappingHandlerMapping- Mapped to com.vmware.hybridity.admin.config.ServiceConfigRestController#verifyProxyConfiguration(String)
  2025-11-07 22:23:40.939 UTC [https-jsse-nio-9443-exec-3, , ] ERROR c.v.h.a.config.ProxyConfigValidator- Unable to connect using the proxy.
  java.net.UnknownHostException: http://<proxy-server-fqdn>.test.local

Environment

VMware HCX

Cause

Proxy Server configuration field does not support the http:// or https:// protocol as the code already adds the prefix to the entered URL

Resolution

Remove the http:// or https:// protocol from the Proxy Server configuration field