Skip to main content

"503 Service Unavailable" error on the vSphere Web Client when logging in or accessing the vCenter Server

  Symptoms

  • Logging in to the vCenter Server or vCenter Server appliance (VCSA) using the vSphere Web Client fails.
  • Accessing the vCenter Server or vCenter Server appliance using the vSphere Web Client fails.
  • You see these errors similar to:

    503 Service Unavailable.
    503 Service Unavailable (Failed to connect to endpoint: [N7Vmacore4Http20NamedPipeServiceSpecE:0x00007fb7d00200a0] _serverNamespace = / action = Allow _pipeName =/var/run/vmware/vpxd-webserver-pipe)
Note: vCenter STS Certificate may expire soon in certain configuration and you will observe the symptoms mentioned in this KB if STS certificate is expired, please refer following KBs to verify the validity of STS / Signing Certificate and replace it if already expired:
Purpose
This article provides insights and troubleshooting steps when you encountered this error while logging in and accessing the vCenter Server using your vSphere Web Client.
Cause
This issue may occur due to a number of reasons such as:
  • The vCenter Server currently down because of maintenance.
  • The reverse Proxy service on vCenter Server is down.
  • The vSphere web client service is down.
  • Mis-configured Firewall settings.

    Notes:
    This mis-configuration can only occur on a Windows installation of vCenter Server.
    A VCSA installation can only have this problem if deliberate changes were made to firewall settings.
Impact / Risks
Managing the vCenter Server or vCenter Server appliance fails.
Resolution
Before troubleshooting, it is critical to understand what a "503 Service Unavailable" error is.
For more insights, see
 
List of HTTP Status Codes
503 Service Unavailable Flow Chart

Disclaimer: VMware is not responsible for the reliability of any data, opinions, advice, or statements made on third-party websites. Inclusion of such links does not imply that VMware endorses, recommends, or accepts any responsibility for the content of such sites.

A 503 Service Unavailable error is an HTTP response status code that indicates that the server is temporarily unable to handle your request. This can be due to a number of reasons already mentioned in the cause section.

There are also different looking 503 pages on other websites:

For example:
  • 503 Service Unavailable (Failed to connect to endpoint: [N7Vmacore4Http20NamedPipeServiceSpecE:0x00007fb7d00200a0] _serverNamespace = / action = Allow _pipeName =/var/run/vmware/vpxd-webserver-pipe)
  • 503 Error
  • Service Unavailable – DNS Failure
  • HTTP Error 503
  • HTTP 503
  • 503 Service Temporarily Available
An important thing to remember is that a 503 error is a server-side error. This means that the problem exists within the vCenter Server or website (server) you are trying to access, and not your computer (client).

Troubleshooting HTTP response status code "503" on the vSphere Web Client when connecting to the vCenter Server. 

  1. Try again in a few minutes.

    Note: it is most likely that the vCenter Server is just busy acknowledging your request. The vCenter server was able to process your request and was able to respond back with the "503 Service Unavailable" error. It is just not able to acknowledge your request either because it is busy with other tasks at the moment or it currently down with very limited services due to maintenance.
  2. Try again in a few minutes on a different client. Confirm if you are still get the same error.
  3. Confirm the status of the VMware vCenter Services. Ensure all required vCenter Server and vCenter Server appliance services are up, running and functional. For more insights, see:
  1. Check if there are an disk space issues on the vCenter Server or the vCenter Server Appliance. 

    Notes

    Disk space issues can cause more than one service to shutdown which can result in the HTTP 503 Error Response Code.
    Disk space issues do not directly cause a 503 Error Response Code, but the services being down due to a failure causes the error. For relevant articles, see:
  1. From the vCenter Server, investigate the vsphere_client_virgo.log file located at:
    • Windows vCenter Server - C:\ProgamData\VMware\vCenterServer\logs\vsphere-client\logs\
    • vCenter Server Appliance - /var/log/vmware/vsphere-client/logs/

      Also, look at the vpxd.log file located at:
      • Windows vCenter Server: C:\ProgramData\VMware\vCenterServer\logs\vmware-vpx
      • vCenter Server Appliance: /var/log/vmware/vpxd
  1. VMware strongly recommends on following Performance Best Practices on VMware vSphere 6.x/7.x
  1. For more insights on Troubleshooting VMware vCenter Server, the vSphere Web Client, Storage and Networking, see the VMware vSphere Troubleshooting Guide.

For Troubleshooting Work Flow , see:

Process to troubleshoot
Additional Resources

Comments

Popular posts from this blog

"Failed to configure vAPI Endpoint Service at the firstboot time" while installing Windows VC 6.5

  Symptoms While configuring the vAPI EndPoint Service, you experience these symptoms: Windows vCenter Server 6.5 installation fails while configuring the vAPI EndPoint Service vCenter Server 6.5 installation on a Windows Server fails during the vAPI EndPoint Service during the firstboot time. You see the error: Error: An error occurred while starting service 'vapi-endpoint'. Failed to start the vAPI Endpoint Service. Failed to configure vAPI Endpoint Service at the firstboot time. Please file a bug against VAPI   In vapi_firstboot.py_2948_stderr.log file, you see entries similar to: No valid files with pathname: C:\ProgramData\VMware\vCenterServer\logs\vapi\endpoint* found. ERROR starting vapi-endpoint rc: 2, stdout: , stderr: Start service request failed. Error: Service crashed while starting^M vapi firstboot failed Traceback (most recent call last): File "C:\Program Files\VMware\vCenter Server\firstbo...

Cloning and converting virtual machine disks with vmkfstools

 Purpose This article provides information and instructions on the use of the vmkfstools command to convert virtual machine disks from one type to another. Resolution The vmkfstools command offers the ability to clone virtual machine content and also convert from one virtual machine disk ( .vmdk ) format into another. Note : The host operating system chosen to perform the conversion may not necessarily support running of virtual machines via the output format defined. vmkfstools maintains the possibility of exporting virtual disks for use in other VMware products which support alternative disk formats. To convert a virtual machine disk from one type to another: Shut down the virtual machine. Virtual machine disk files are locked while in-use by a running virtual machine. Log in to the VMware vSphere Management Assistant (v...

Troubleshooting vpxd service on Windows vCenter Server

  Symptoms You cannot connect to VMware vCenter Server with the vSphere Client. You cannot see the VMware vCenter Server in the inventory in the vSphere Web Client. You see a Microsoft Windows Event error associated with IIS similar to: Event properties - Event 7024, Service Control Manager The VMware VirtualCenter Server service terminated with service-specific error The system cannot find the file specified.. Log Name: System Source: Service Control Event ID: 7024 Level: Error Note : A windows Event ID 1000 may also be reported in relation to this issue.   Connecting to vCenter Server fails with the error: Cannot connect to host server_name : No connection could be made because the target machine actively refused it.   Attempting to start the VMware VirtualCenter Server service fails. You see this error: Windows could not start the VMware VirtualCenter Server service on...