Search the VMware Knowledge Base (KB)
View by Article ID

Upgrading to vSphere Web Client 5.5 on a Microsoft Windows platform (2058265)

  • 1 Ratings


This article provides step-by-step guidance for upgrading to vSphere Web Client 5.5 using the Custom Install method.

This article assumes that:
  • You have reviewed the vSphere Installation and Setup Guide.
  • You have met all minimum software and hardware requirements for vSphere 5.5. For more information, see the System Requirements section in the vSphere Installation and Setup Guide.
  • You have configured both a forward and reverse lookup zone for this Microsoft Windows Server on your Domain Name System (DNS) Server(s). For more information on configuring reverse lookup zones in a Microsoft Active Directory domain, see the Microsoft TechNet article Adding a Reverse Lookup Zone.

    Note: The preceding link was correct as of September 19, 2013. If you find a link is broken, provide feedback and a VMware employee will update the link.

  • You have decided on using the Custom Install method to upgrade the vSphere Web Client.
  • You have already upgraded to vCenter Single Sign-On (SSO) 5.5. For more information, see Upgrading to vCenter Single Sign-On 5.5 on a Microsoft Windows platform (2058249).

Important: Having the services located on multiple Microsoft Windows servers increases the complexity of maintaining the environment. Additional complexity comes in the form of administration overhead and licensing costs. In addition, this configuration introduces points of failure, such as network connectivity and name resolution related issues which may involve engaging additional vendors during outages and maintenance windows. Please make sure that your infrastructure is configured in a redundant manner and you allocate appropriate resources considering these factors.


Upgrade steps for the vSphere Web Client 5.5

  1. Mount the vSphere 5.5 installation media. The installation wizard appears.
  2. In the left pane, under Custom Install, click vSphere Web Client and then click Install.

    Note: If any of the prerequisites are not met, they are listed in the right pane under Prerequisites.

  3. Select the appropriate language from the dropdown and click OK.

    Note: The installer window may disappear for a lengthy period of time, but is still running in the background.

  4. In the welcome screen, click Next. If a previous version of the vSphere Web Client is installed, the welcome screen displays this message:

    An earlier version of vSphere Web Client is already installed on this computer and will be upgraded to vSphere Web Client 5.5

  5. Review the End User License Agreement. If you agree, select the I accept the terms in the license agreement option and click Next.
  6. Optionally, provide an alternative TCP port number for the vSphere Web Client Service and click Next.

    Note: Changing the default ports is recommended only if you have an unchangeable port conflict in the same system.

  7. Enter the SSO Lookup Service URL and SSO administrator username and password. You may be prompted to install the Lookup Service Certificate. Click Next.

    • This dialog shows information related to a domain by the name vsphere.local. This is not a domain that is auto-detected within the existing environment, but a net new domain used internally by vSphere. The administrator@vsphere.local account performs the same function as the admin@System-Domain account in previous versions of vSphere.

      For more information about the administrator@vsphere.local account, see the vSphere Software Components section of the vCenter Server and Host Management Guide.

    • You must use the Fully Qualified Domain Name (FQDN) and not the IP address.  Providing the IP address may allow you to proceed with the upgrade, but may result in certificate related errors when starting vCenter Server. 

    • If you are configuring a HA SSO configuration, you must provide the FQDN of the load balancer. Providing the FQDN of a single node may allow you to proceed with the upgrade, but may result in certificate related errors when starting vCenter Server. 

  8. When prompted, verify the fingerprint of the certificate and click Yes to proceed.
  9. In the Ready to Install screen, click Install.
  10. When the installation completes, click Finish.

Post upgrade of vSphere Web Client 5.5

After installing the vSphere Web Client:

  • Ensure that the browsers of the vSphere administrators meet all of the requirements to run the vSphere Web Client.  For more information, see, Using the vSphere Web Client section in the vCenter Server and Host Management Guide.

  • Log into the vSphere Web Client and authenticate using the administrator@vsphere.local domain to verify that the SSO and vSphere Web Client are working correctly. You may also add an external identity source, such as Open LDAP and Active Directory, before deploying vCenter Server and Inventory Services. For more information on the different types of Identity Sources for vSphere 5.5, see the Add a vCenter Single Sign-On Identity Source section of the vSphere Installation and Setup Guide.  

  • Upgrade the vCenter Inventory Service. For more information, see Upgrading to vCenter Inventory Service 5.5 on a Microsoft Windows platform (2058272).

    : You may choose to postpone the upgrade of the vCenter Server and vCenter Inventory Service services to version 5.5. In this case, after upgrading SSO and the vSphere Web Client to version 5.5, you must restart both the vCenter Inventory Service 5.1 and vCenter Server 5.1, so that they can communicate with the upgraded vSphere 5.5 services.

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 1 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 1 Ratings