The vCenter Host Agent Pre-Upgrade Checker reports known issues that might prevent a successful upgrade of the vCenter Host Agent software.

For more information about the vCenter Host Agent Pre-Upgrade Checker, see About the vCenter Host Agent Pre-Upgrade Checker.

Verify that VirtualCenter 2.5 Update 6 or later or vCenter Server is installed on a Windows machine that is supported by vCenter Server 5.

Verify that the VirtualCenter 2.5 Update 6 or vCenter Server machine has a DSN configured that is compatible with vCenter Server 5.

Verify that the VirtualCenter 2.5 Update 6 or vCenter Server database is supported by vCenter Server 5. If necessary, upgrade the database to work with vCenter Server 5. The MSDE database was supported in experimental mode in VirtualCenter Server 2.0.x, but is not supported in vCenter Server 5. The vCenter Host Agent Pre-Upgrade Checker will not detect the database. Upgrade to a supported database before using the tool. See Supported Database Upgrades.

Verify that the ESX/ESXi hosts are managed by VirtualCenter 2.5 Update 6 or later or by vCenter Server.

Verify that VirtualCenter Agent or vCenter Host Agent software is running on each managed ESX/ESXi host.

Verify that Microsoft .NET Framework Version 2.0 is installed on the VirtualCenter 2.5 Update 6 or later system.

Verify that you have Internet connectivity from the VirtualCenter 2.5 Update 6 or later or vCenter Server system. This allows new updates to be applied to the tool and allows you to view the reports and the Knowledge Base (KB) articles associated with the reports.

1

On the VirtualCenter 2.5 Update 6 or later or vCenter Server system you are upgrading from, download the vCenter Server 5 installation package or insert the vCenter Server 5 installation DVD.

2

Take one of the following actions to start the Pre-Upgrade Checker.

In the installation package or on the DVD, navigate to \vpx\agentupgradecheck and run the AgentUpgradeChecker.exe executable file.

Start the vCenter Server installer autorun.exe and select vCenter Host Agent Pre-Upgrade Checker from the Utility list.

3

Select the DSN for the VirtualCenter or vCenter Server system you are upgrading from and select the login credentials that are appropriate for that DSN.

If you are not sure which credential type to select, check which authentication type is configured for the DSN (Control Panel > Administrative Tools > ODBC Data Sources > System DSN).

4

If the DSN requires a login for the credential type in use, enter a user name and password and click Next.

5

Select an option for scanning all hosts or specific hosts.

Option

Action

Scan all of the hosts

Select Standard Mode and click Next.

Specify hosts to scan

a

Select Custom Mode and click Next.

b

Select the hosts to scan and click Next. To select all hosts in a cluster, double-click the cluster.

6

Click Run Precheck.

The tool takes 30-40 seconds for each host.

7

When the check is complete, click Next.

8

View the pre-upgrade reports.

To view the report for an individual host, click the link next to the host name.

To view a summary report for all hosts, click View Report.

You have a list of issues to resolve before you upgrade to vCenter Server 5.

From the report, use the linked KB articles to research and resolve the issues for each host. After you resolve the issues, rerun the vCenter Host Agent Pre-Upgrade Checker. Repeat this process until you resolve all the reported issues, and proceed with your upgrade to vCenter Server 5.