Vi3!35!25 U2 Upgrade Guide
Vi3!35!25 U2 Upgrade Guide
Vi3!35!25 U2 Upgrade Guide
Upgrade Guide
Revision: 20090213
Item: EN-000028-02
You can find the most up-to-date technical documentation on our Web site at:
http://www.vmware.com/support/
The VMware Web site also provides the latest product updates.
If you have comments about this documentation, submit your feedback to:
docfeedback@vmware.com
© 2007–2009 VMware, Inc. All rights reserved. This product is protected by U.S. and international
copyright and intellectual property laws. VMware products are covered by one or more patents listed
at http://www.vmware.com/go/patents.
VMware, the VMware “boxes” logo and design, Virtual SMP and VMotion are registered trademarks or
trademarks of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names
mentioned herein may be trademarks of their respective companies.
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
2 VMware, Inc.
Contents
About This Book 7
1 Planning a VMware Infrastructure Upgrade 11
VMware Infrastructure at a Glance 12
Ensuring a Safe and Smooth Upgrade 15
Supported Upgrades in This Release 16
Backup and Restore Strategies 16
VirtualCenter Backup 16
ESX Server Backup 17
Virtual Machine Backup 17
Preupgrade Script 18
Downtime for Virtual Machines 18
Understanding Changes to VMware Architecture 19
Virtual Machine File System Format: VMFS2 to VMFS3 19
Upgrading VM2 Virtual Machine Format to VM3 20
Strategies for In‐Place or Migration Upgrades 21
In‐Place Upgrade 21
Advantage of an In‐Place Upgrade 21
Disadvantage of an In‐Place Upgrade 21
Migration Upgrade 21
Advantage of a Migration Upgrade 22
Disadvantage of a Migration Upgrade 23
Understanding the Stages of Upgrading 23
Requirements for Staging 23
Stage 1–Upgrading VMware VirtualCenter 24
Expected Downtime in Stage 1 24
Prerequisites for Stage 1 24
Upgrade Tasks for Stage 1 25
Considerations for Stage 1 25
Stage 2–Upgrading Your ESX Server Hosts and Datastores 25
Upgrade Strategy for ESX Server Host with Local Disks 25
Upgrade Strategy for ESX Server Host with SAN 26
Expected Downtime in Stage 2 27
VMware, Inc. 3
Upgrade Guide
2 ESX Server 3 and VirtualCenter
Upgrade Scenarios 33
Major Upgrades 33
Scenario 1: Upgrading In‐Place 33
HVL Alignment 34
Scenario 2: Upgrading Hosts on a SAN Using Upgrade VMotion 37
Scenario 3: Upgrading Hosts on a SAN and Upgrading a VMFS Volume
In‐Place 38
Considerations for Scenario 3 39
Minor Upgrades 40
Scenario 4: Upgrading a Local Disk In‐Place 40
Scenario 5: Upgrading Hosts on a SAN Using VMotion without DRS and
HA 40
Scenario 6: Upgrading Hosts on a SAN Using VMotion with DRS and HA 41
3 ESX Server 3i and VirtualCenter
Upgrade Scenarios 43
Major Upgrades 43
Scenario 1: Upgrading Using Upgrade VMotion 44
Scenario 2: Upgrading Using Cold Migration 44
Minor Upgrades 45
Scenario 3: Performing a Minor Upgrade Using VMotion 45
Scenario 4: Assigning a LUN to an ESX Server 3i Host 46
Scenario 5: Upgrading Hosts on a SAN with DRS and HA 46
Changing the ESX Server Version 47
4 VMware, Inc.
Contents
4 Upgrading VirtualCenter 49
Release Upgrade Support 49
Before You Upgrade VirtualCenter 51
Performing the VirtualCenter Upgrade 53
Upgrading VirtualCenter 54
Upgrading the VirtualCenter Database 55
Upgrading Oracle and SQL Databases 56
End of Life for Access Database 56
Using the Database Upgrade Wizard 57
Repairing the Database DSN 59
Upgrading VirtualCenter Clients to VI Clients 59
Downtime for a VI Client Upgrade 59
Troubleshooting the VI Client 60
Upgrading VMware Infrastructure to Use the License Server 60
Downtime for a License Server Installation 60
5 Upgrading ESX Server 61
Release Upgrade Support 61
Before You Upgrade ESX Server 62
Follow Upgrade Steps in the Order Given 63
Host Configuration Requires a VI Client 63
Support for Scripted Installations 63
Support for Legacy Hardware 63
Components Installed by the Upgrade 63
Upgrade Requirements 64
Using Remote Management Applications 65
Adjusting ESX Server 2.x Host Security Property to Allow RPM
Transaction 65
Selecting the Boot Drive 65
Host Drive and LUN Requirements 66
Verifying Hardware Support 66
Allocating PCI Devices 67
Debug Mode Is Not Installed with an Upgrade from ESX Server 2.x 67
Commit or Discard Changes to Virtual Disks in Undoable Mode 67
Restoring NFS Mounts After Upgrade 67
Reloading USB Controllers After Upgrade 67
Reconfiguring Virtual Machines with SCSI Passthroughs After Upgrade 68
Upgrading Virtual Machines with RAW Disks 68
Performing the ESX Server Host Upgrade 69
Machine Downtime for a Host Upgrade 69
VMware, Inc. 5
Upgrade Guide
Virtual Machine Downtime for a Host Upgrade 69
Host Upgrade Methods 69
Running the Preupgrade Script 70
Upgrading Using the Graphical Installer 71
Upgrading Using the Text‐Based Installer 73
Upgrading from ESX Server 2.x Using a Tarball 76
Upgrading from ESX Server 3.x Using esxupdate 77
Useful esxupdate options 77
Upgrading Datastores 78
Relocating Virtual Machines 80
6 Upgrading Virtual Machines 81
Upgrading Virtual Hardware to VM3 Format 81
Upgrading VMware Tools 82
Upgrading Hardware and VMware Tools in Multiple Virtual Machines 82
Specifying Host or Virtual Machine Names 84
Usage Examples 85
Unexpected Hardware Changes When Upgrading Virtual Adapter 85
Upgrading Virtual Machine Templates 86
Using Workstation or GSX Server Virtual Disks with ESX Server 3.x 87
Appendix: Upgrade Preparation Checklists 89
Index 95
6 VMware, Inc.
About This Book
This manual, the Upgrade Guide, describes how to upgrade existing configurations of
VMware® VirtualCenter and ESX Server.
The Upgrade Guide covers both ESX Server 3.5 and ESX Server 3i version 3.5. For ease of
discussion, this book uses the following product naming conventions:
For topics specific to ESX Server 3.5, this book uses the term “ESX Server 3.”
For topics specific to ESX Server 3i version 3.5, this book uses the term “ESX Server
3i.”
For topics common to both products, this book uses the term “ESX Server.”
When the identification of a specific release is important to a discussion, this book
refers to the product by its full, versioned name.
When a discussion applies to all versions of ESX Server for VMware
Infrastructure 3, this book uses the term “ESX Server 3.x.”
Intended Audience
This manual is intended for anyone who needs to upgrade from earlier versions of
ESX Server and VirtualCenter to ESX Server 3.5, ESX Server 3i, and VirtualCenter 2.5.
The information in this manual is written for experienced Windows or Linux system
administrators who are familiar with virtual machine technology and datacenter
operations.
VMware, Inc. 7
Upgrade Guide
Document Feedback
VMware welcomes your suggestions for improving our documentation. If you have
comments, send your feedback to:
docfeedback@vmware.com
Table 1. Abbreviations
Abbreviation Description
database VirtualCenter database
datastore Storage for the managed host
dsk# Storage disk for the managed host
hostn VirtualCenter managed hosts
SAN Storage area network type datastore shared between managed hosts
tmplt Template
user# User with access permissions
VC VirtualCenter
VM# Virtual machines on a managed host
http://www.vmware.com/support/pubs.
8 VMware, Inc.
About This Book
http://www.vmware.com/support
Customers with appropriate support contracts should use telephone support for the
fastest response on priority 1 issues. Go to:
http://www.vmware.com/support/phone_support.html
Support Offerings
Find out how VMware support offerings can help meet your business needs. Go to:
http://www.vmware.com/support/services
http://mylearn1.vmware.com/mgrreg/index.cfm
VMware, Inc. 9
Upgrade Guide
10 VMware, Inc.
1
Planning a VMware
Infrastructure Upgrade 1
This chapter discusses planning and preparations for upgrading
VMware Infrastructure from earlier version of ESX Server and VirtualCenter to an
ESX Server 3.5 and VirtualCenter 2.5 environment. Upgrading is a multistage process
in which procedures must be performed in a particular order. The upgrade path
depends on your ESX Server host and datastore configurations. The information in this
chapter can help you plan a smooth upgrade with a minimum of system downtime.
CAUTION VMware recommends that you read this chapter before attempting to
upgrade. If you do not follow appropriate safeguards, you might lose data and lose
access to your servers. Without careful planning, you might incur more downtime than
is necessary.
This chapter contains the following sections:
“VMware Infrastructure at a Glance” on page 12
“Ensuring a Safe and Smooth Upgrade” on page 15
“Understanding Changes to VMware Architecture” on page 19
“Strategies for In‐Place or Migration Upgrades” on page 21
“Understanding the Stages of Upgrading” on page 23
“Upgrade Scenarios” on page 31
VMware, Inc. 11
Upgrade Guide
license server
ESX
Server
hosts
VirtualCenter
database
Web browser
One VirtualCenter Server manages multiple ESX Server hosts.
Each shaded block represents a separate installer or procedure. The VMware
Infrastructure Client (VI Client) appears twice, because you can download it from a
VirtualCenter Server or ESX Server host.
12 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
The major components of VMware Infrastructure are:
ESX Server – ESX Server provides a virtualization layer that abstracts the
processor, memory, storage, and networking resources of the physical host into
multiple virtual machines.
VirtualCenter Server – This server installs on a Windows machine, either physical
or virtual, to centrally manage your VMware ESX Server hosts. The
VirtualCenter Server allows the use of advanced VMware Infrastructure features
such as VMware Distributed Resource Scheduler (DRS), VMware
High Availability (HA), and VMware VMotion™.
A VMware SDK Web service is installed with the VirtualCenter Server.
VirtualCenter Plugins – Optional applications that provide additional capabilities
and features to VirtualCenter. Generally, plugins are released separately, install on
top of VirtualCenter, and can be upgraded independently. You can install server
components of plugins on the same computer where the VirtualCenter Server
resides, or on a separate one. After the server component of a plugin is installed,
you can activate the plugin’s client component, which enhances the VI Client with
appropriate UI options.
Documentation provided with each plugin offers information on how server
components of plugins are installed.
For information on how to install the client component, verify which plugins are
already installed, and how to disable or uninstall plugins that you are not using,
see Basic System Administration.
The following plugins are available:
VMware Converter – Enables you to convert physical or virtual machines into
ESX Server virtual machines. After converting the virtual machines, you can
add them to your VirtualCenter inventory.
VMware Update Manager – Provides security monitoring and patching
support for ESX Server hosts and virtual machines. In addition to an
independent server component installation, this release supports the
combined installation for the VirtualCenter Server and Update Manager.
See “Upgrading VirtualCenter” on page 54. For general information, see the
VMware Update Manager Administration Guide.
VMware, Inc. 13
Upgrade Guide
VI Client – The VI Client installs on a Windows machine and is the primary
method of interaction with VMware Infrastructure. The VI Client acts as:
A console to operate virtual machines.
An administration interface into VirtualCenter hosts and ESX Server hosts.
Web browser – A browser allows you to download the VI Client from the
VirtualCenter Server or ESX Server hosts. When you have appropriate login
credentials, a browser also lets you perform limited management of your
VirtualCenter Server and ESX Server hosts.
License server – This server installs on a Windows system to authorize the
VirtualCenter Server machines and ESX Server hosts appropriately for your
licensing agreement. There is no direct interaction with the license server.
Administrators make changes to software licenses using the VI Client.
Database – The VirtualCenter Server uses a database to organize all the
configuration data for the VMware Infrastructure environment. For small
deployments, the bundled Microsoft SQL Server 2005 Express database allows you
to set up a limited numbers of hosts and virtual machines (5 hosts and 50 virtual
machines). VirtualCenter supports several other database products for larger
deployments.
The following manuals provide information about installing VMware Infrastructure,
configuring licensing, and configuring your VirtualCenter database:
14 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
These guides provide information about the following functionality that effects
upgrades:
Installation wizard for installing VirtualCenter, VI Client, and plug‐in components
A feature that detects plugins installed on a VirtualCenter Server during a
VI Client installation
Licensing changes, including centralized licensing and a new unlicensed
evaluation mode
VMFS3 changes
VMware Tools updates and upgrades
Other new features do not impact any upgrade processes.
Order is also important within each upgrade stage. Even when an exact sequence is
optional, VMware makes recommendations. For example, to minimize downtime,
follow VMware recommendations for completing and repeating certain steps in a
stage.
Generally, the upgrade process has only one direction. After you upgrade part of your
VMware Infrastructure, that upgraded part cannot be reverted for use with older
VMware software.
With appropriate backups and planning, you can restore your original versions of
ESX Server and VirtualCenter.
VMware, Inc. 15
Upgrade Guide
VirtualCenter upgrades are supported from most released versions of
VirtualCenter to VirtualCenter 2.5. For a compatibility list, see “Before You
Upgrade VirtualCenter” on page 51.
A subset of ESX Server 2.x versions support the migration upgrade using the new
feature in ESX Server 3.x and ESX Server 3i and higher that enables upgrade
VMotion with simultaneous relocation to a new datastore. See “Migration
Upgrade” on page 21.
Unsupported upgrades can fail with lost data, lost network connections, and
unusable configurations. Do not upgrade an unsupported configuration that
contains important data or is a production machine.
VirtualCenter Backup
Before upgrading, make a full backup of the VirtualCenter database. See your database
documentation.
Back up any virtual machine templates that reside on the VirtualCenter Server
repository.
1 Completely uninstall VirtualCenter 2.5.
2 Restore the previous version of VirtualCenter database from the backup.
3 Reinstall your original version of VirtualCenter, selecting the restored database
during the installation process.
16 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
The following manuals provide information about installing and uninstalling
VirtualCenter:
The /etc/passwd and /etc/groups files
Custom scripts
.vmx files
Local images: templates, exported virtual machines, and .iso files
1 Reinstall the original version of ESX Server on the host.
2 Restore the backed‐up service console and local VMFS files.
See http://www.vmware.com/pdf/esx_backup_wp.pdf.
Back up virtual machine files – Back up your virtual machine files, including the
.vmdk or .dsk and .vmx files. If the ESX Server you are upgrading uses the
VMFS2 file system, the .vmdk or .dsk files are located on your VMFS2 partitions
while the .vmx files are stored with the service console.
Backup agent – Using a backup agent, back up each virtual machine at the
operating system level. This method requires you to recreate the .vmx and .vmdk
files for the virtual machine before you restore from the backup.
Cloning – Clone the virtual machine to another datastore. (Note that this changes
the UUID and so does not produce a virtual machine that is identical to the original
in every respect.)
VMware, Inc. 17
Upgrade Guide
Preupgrade Script
ESX Server 3.5 includes a preupgrade script, which verifies that your system can be
upgraded and alerts you to problems that you need to address before upgrading.
The preupgrade script is valid for major upgrades, not minor upgrades. Specifically,
use the preupgrade script before you upgrade from ESX Server 2.x to ESX Server 3.x.
Do not use the preupgrade script on ESX Server 3.0.x hosts.
Before performing a major upgrade on an ESX Server host, run the preupgrade script
as described in “Running the Preupgrade Script” on page 70 and address problems
flagged by the script.
Depending on your upgrade strategy, you might not have to shut down more than a
single virtual machine at any given time. You can stagger or offset individual virtual
machine downtimes to accommodate a schedule convenient to you and your
customers.
For example:
If your virtual machine users are located in diverse time zones, you can prepare by
migrating virtual machines to specific hosts to serve a given time zone. This way
you can arrange host upgrades so virtual machine downtime occurs transparently
outside business hours for that time zone.
If your virtual machine users operate around the clock, you can delay downtime
for their virtual machines to normally scheduled maintenance periods. There is no
requirement that any upgrade stage be completed within a certain time period.
You can take as long as needed at any given stage.
Two strategies for upgrade are discussed in “Strategies for In‐Place or Migration
Upgrades” on page 21.
18 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
To help you understand why upgrade order is important, the next sections describe
differences in architecture from previous versions.
Two types of VMFS file systems are:
Converting a file system to VMFS3 takes approximately 15 minutes and requires
downtime for all virtual machines remaining on the volume.
By moving all virtual machine files, including .vmx configuration files, to central,
shared storage such as NAS or VMFS3 on Fibre Channel SAN and iSCSI SAN, an
ESX Server host receives benefits for larger storage environments enabled by SAN,
NAS, and iSCSI. Now all information about a virtual machine is centrally stored, and it
is easier to manage, backup, restore, migrate, and copy virtual machines than it was in
ESX Server 2.x. Having all virtual machine data stored centrally on the VMFS3
datastore is also essential to newer VMware Infrastructure functionality, such as
VMware HA.
NOTE VMFS3 file systems are restricted to a block size of no greater than 8MB. You
cannot directly upgrade a VMFS2 file system with a block size of greater than 8MB to
VMFS3. To upgrade a VMFS2 file system with a block size greater than 8MB, use a
migration upgrade strategy as described in “Migration Upgrade” on page 21.
VMware, Inc. 19
Upgrade Guide
Converting the file system on a volume is Procedure 2B from “Understanding the
Stages of Upgrading” on page 23.
CAUTION You cannot revert from VMFS3 to VMFS2. After it is upgraded, the VMFS3
volume is usable only with ESX Server 3.x hosts.
VM2 Virtual Machine – The VM2 format is used by virtual machines created with
ESX Server 2.
VM3 Virtual Machine – The VM3 format is used by virtual machines created with
ESX Server 3.x. VM3 enhancements include improved snapshot support and
support for new hardware.
Upgrading the virtual machine format is Stage 3, from “Understanding the Stages of
Upgrading” on page 23.
CAUTION You cannot revert from VM3 to VM2. After it is upgraded, a VM3‐format
virtual machine is usable only with ESX Server 3.x.
20 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
In-Place Upgrade
The in‐place upgrade is a software upgrade.
For multiple ESX Server hosts sharing SAN LUNs, an in‐place upgrade is more
complex. You upgrade one or more of your ESX Server 2.x hosts to ESX Server 3.x.
Then, at an appropriate time, you upgrade one SAN LUN from VMFS2 to VMFS3.
Downtime for all virtual machines on that LUN begins at that time.
Migration Upgrade
The migration upgrade is more of a managed transition than a strict upgrade. The
migration upgrade reduces virtual machine downtime to the bare minimum by moving
virtual machines directly from a production host running ESX Server 2 to a production
host running ESX Server 3 or ESX Server 3i.
VMware, Inc. 21
Upgrade Guide
A migration upgrade requires that you have extra machines and storage capacity that
are not yet part of your production environment:
Empty host storage sufficient to hold a portion of your production virtual
machines. This storage capacity should be as large as possible. A larger capacity
for virtual machines on this extra storage means fewer operations are required
before all your virtual machines are migrated.
To use upgrade VMotion to migrate powered‐on virtual machines while
simultaneously relocating them from a VMFS2 to a VMFS3 datastore, you must meet
the following requirements:
Migrate virtual machines only from the following supported ESX Server versions:
ESX Server 2.5.3
ESX Server 2.5.4
ESX Server 2.5.5
Make sure that the virtual machines to be migrated have persistent‐mode disks.
22 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
“Stage 1–Upgrading VMware VirtualCenter” on page 24
“Stage 2–Upgrading Your ESX Server Hosts and Datastores” on page 25
“Stage 2B–Upgrading a Datastore from VMFS2 to VMFS3” on page 27
“Stage 3–Upgrading Your Virtual Machines” on page 28
“Stage 4–Upgrading VMware Tools Within the Guest Operating System” on
page 30
You must complete one stage before you move to the next stage.
After you start an upgrade stage, you cannot revert to the previous stage. Each of
these stages is an irreversible process.
Some major stages have minor steps within them. Follow the directions within
each stage regarding the required sequence of minor steps.
CAUTION Because certain commands can simultaneously upgrade more than one
stage, VMware recommends that you thoroughly understand the irreversible changes
at each stage before you upgrade your production environments.
VMware, Inc. 23
Upgrade Guide
In‐place upgrade – VMware estimates that the upgrade requires the
VirtualCenter Server to be out of production for ten minutes. No reboot is
required. The downtime can be scheduled at your convenience.
Migration upgrade – You can avoid Stage 1 downtime if you have an extra
supported machine. Install VirtualCenter 2.5 on the extra machine before you
take the earlier version of VirtualCenter out of service.
CAUTION VMware does not support management of one ESX Server host by
multiple VirtualCenter Server machines. While there are safeguards, you
might inadvertently find a host to be managed by VirtualCenter 1.x and
VirtualCenter 2.x at the same time. If so, shut down VirtualCenter 1.x
immediately or remove the host from the VirtualCenter 1.x to prevent
corruption of virtual machines or the VirtualCenter database.
VMware license server – No downtime is required.
ESX Server hosts – No downtime is required.
Virtual machines – No downtime is required.
VMware VirtualCenter 2.5 installation media.
License keys for all purchased functionality.
These keys can include VirtualCenter, ESX Server, Virtual SMP, VMotion, DRS,
and HA.
Login credentials, the database name, and the database server name used by the
VirtualCenter database. The database server name is typically the ODBC System
data store name (DSN) connection name for the VirtualCenter database.
24 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
2 Upgrade the VirtualCenter database.
3 Install the VI Client for users of the VirtualCenter client.
Legacy clients – VMware Management Interface users and remote console clients
cannot connect to VirtualCenter 2.5. However, any browser can connect to the
VirtualCenter 2.5 URL and download a Windows VI Client. The Management
Interface and remote console clients can still connect directly to ESX Server 2.x
hosts, even if those hosts are now managed by VirtualCenter 2.5.
ESX Server (in‐place)
VMFS (in‐place)
The following components are not upgraded:
Your virtual machines
VMware Tools inside each machine
VMware, Inc. 25
Upgrade Guide
One approach is to upgrade all the servers first, and then upgrade the disk. Although
this approach is possible, it incurs a large amount of downtime. All virtual machines in
your environment must be brought down for the duration of the process, due to a key
limitation that ESX Server 3.x hosts cannot run virtual machines residing on legacy
VMFS2 storage.
There are other strategies that can minimize and mitigate the downtime for your virtual
machines. These approaches require additional thought and planning.
A migration upgrade to a separate VMFS3 datastore involves migrating virtual
machines from your legacy environment to your new environment.
Advantage – Avoids downtime for virtual machines at this step.
Disadvantage – Migrating each virtual machine is time‐consuming. Additional
disk resources are needed. Each virtual machine’s virtual disk is copied from a
VMFS2 volume to a VMFS3 volume.
NOTE The migration scenarios described in this chapter make use of a new feature in
ESX Server 3.x. This feature is supported only for upgrades from specific ESX Server 2.x
versions.
An in‐place upgrade essentially involves upgrading a subset of your ESX Server hosts
and then upgrading their associated VMFS2 volumes in‐place. This process can be
repeated multiple times over subsets of ESX Server hosts and disks.
Advantage – An in‐place upgrade is faster than a migration upgrade. No
additional disk or server resources are needed.
Disadvantage – A group of virtual machines must experience downtime
simultaneously while the VMFS2 volume on which they reside is upgraded.
Whatever strategy you take, you need to use two basic procedures. The remainder of
this section discusses upgrading a VMware ESX Server host and upgrading a datastore
from VMFS2 to VMFS3.
26 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
Procedure 2A – Whether you choose a migration or an in‐place upgrade, each
host must be rebooted for the upgrade, and then rebooted after the upgrade is
installed. VMware estimates the upgrade requires each host to be out of
production for approximately 40 minutes. Virtual machines can be migrated
with VMotion to prevent downtime.
Procedure 2B – For an in‐place upgrade, each datastore file system partition
must be unavailable to all ESX Server hosts except the one performing the
upgrade for the duration of the upgrade. For a migration upgrade, the VMFS2
datastore is emptied of virtual machines before it is upgraded, so the upgrade
does not affect any ESX Server hosts.
Virtual Machine – For an in‐place upgrade, downtime occurs when you upgrade
the host and continues until you have upgraded the VMFS2 datastore to VMFS3.
For a migration upgrade, virtual machine downtime need not occur during the
host or datastore upgrade.
VM2 virtual machines – VM2‐format virtual machines remain on VMFS2
datastores. An ESX Server 3.x host cannot power on a VM2‐format virtual
machines on a VMFS2 datastore. If you attempt to power on a VM2‐format virtual
machine before moving it to a VMFS3 datastore, you receive an error.
VMFS2 datastores – VMFS2 datastore must be upgraded or they are read‐only on
ESX Server 3.x hosts at the end of stage 2. The required VMFS2 to VMFS3 upgrade
is accomplished in the next stage.
Legacy clients – VMware Management Interface users and remote console clients
cannot connect to an ESX Server 3.x host. However, any browser can connect to the
ESX Server 3.x host URL and download a Windows VI Client.
VMware, Inc. 27
Upgrade Guide
Before you begin procedure 2B, consider the following:
VM2‐Format virtual machines – Can be powered on in legacy mode if they are
relocated to VMFS3 datastores.
Non‐upgraded (VM2 format) virtual machines remain in the appropriate
ESX Server inventory. Manual VM3 upgrades occur in stage 4.
VMFS2 datastores – Are no longer supported for running virtual machines.
VMFS2 datastores are upgraded or removed from service. All virtual machines on
VMFS2 partitions remain registered with the appropriate ESX Server 3.x host.
However, any attempt to power on a VM2‐format virtual machine fails with an
error message IncompatibleVersion.
VMFS3 datastores – Contain all usable virtual machines at the end of
procedure 2B. All virtual machines are on VMFS3 partitions registered with the
appropriate ESX Server 3.x host.
CAUTION Do not move to stage 3 until all virtual machines are relocated onto VMFS3
datastores. The stage 3 upgrade is irreversible. Upgraded virtual machines can never be
powered on by an ESX Server 2 host, even if relocated to a VMFS2 datastore. Make sure
to back up any virtual machine you need to use again on an ESX Server 2 host.
ESX Server hosts – No downtime is required.
VMware license server – No downtime is required.
Virtual machines – VMware estimates the upgrade requires each virtual machine
to be out of production for 30 minutes. The downtime can be concurrent for
multiple virtual machines.
28 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
A virtual machine can be upgraded if:
It is stored on VMFS3 or NFS datastores.
No suspend files exist.
At least one virtual disk exists.
Results of Stage 3
VM2‐format virtual machines – Have been upgraded at the end of this stage.
VM3‐format virtual machines – This is the format of all virtual machines.
2 Choose Inventory > Virtual Machine > Upgrade Virtual Hardware.
See “Upgrading Datastores” on page 78.
Alternatively, you can upgrade multiple virtual machines from VM2 to VM3 and
upgrade their VMware Tools versions. See “Upgrading Hardware and VMware Tools
in Multiple Virtual Machines” on page 82.
Upgrading to VM3 virtual hardware format results in these actions:
The .vmx configuration file is updated to VM3 format.
The .vmdk virtual disk file is updated to VMDK3 format. This allows operation of
features such as multiple snapshots.
CAUTION Do not move to stage 4 until all virtual machines are upgraded to VM3
format.
VMware, Inc. 29
Upgrade Guide
ESX Server hosts – No downtime is required.
VMware license server – No downtime is required.
Virtual machines – Must be rebooted once as part of the VMware Tools upgrade.
A supported guest operating system must be installed on the virtual machine.
You must have a license installed that allows you to power on virtual machines.
2 Install or upgrade VMware Tools.
Alternatively, you can run a script to upgrade multiple virtual machines from VM2 to
VM3 and upgrade their VMware Tools versions.
See “Upgrading VMware Tools” on page 82 and “Upgrading Hardware and VMware
Tools in Multiple Virtual Machines” on page 82.
VMware Tools 3 – Is used by all virtual machines.
30 VMware, Inc.
Chapter 1 Planning a VMware Infrastructure Upgrade
Upgrade Scenarios
The upgrade scenarios listed in Table 1‐2 provide detailed guidance on how to upgrade
your VMware Infrastructure components in various environments.
VMware, Inc. 31
Upgrade Guide
32 VMware, Inc.
2
“Major Upgrades” on page 33
“Minor Upgrades” on page 40
Major Upgrades
Major upgrades involve upgrading from VMware Infrastructure 2 to
VMware Infrastructure 3.
VMware, Inc. 33
Upgrade Guide
A typical environment for this upgrade is illustrated in Figure 2‐1.
ESX 2 ESX 2
VMFS2 VMFS2
SAN SAN
HVL Alignment
Before performing this type of upgrade, it might be useful to perform a host‐virtual
machine‐LUN (HVL) alignment, that is, to migrate virtual machines so that all virtual
machines on a given LUN are associated with only one ESX Server host. When hosts,
virtual machines, and LUNs are aligned in this way, you can upgrade hosts and VMFS2
datastores in pairs without having to consider effects on other hosts and datastores.
Often, an HVL alignment can be achieved using VMotion to realign the virtual
machines with hosts. If this is not possible, then cold migration is necessary. The extra
virtual machine downtime incurred by cold migration might outweigh the benefits of
performing the HVL alignment.
34 VMware, Inc.
Chapter 2 ESX Server 3 and VirtualCenter Upgrade Scenarios
Figure 2‐2 shows the typical environment before an HVL alignment.
ODBC
VirtualCenter 1.x database
VMware, Inc. 35
Upgrade Guide
Figure 2‐3 shows the typical environments after an HVL alignment.
ODBC
VirtualCenter 1.x database
For VirtualCenter 1.2, upgrade to VirtualCenter 1.4.1 before upgrading to
VirtualCenter 2.5.
For VirtualCenter 1.3 and higher, upgrade directly to VirtualCenter 2.5.
2 Upgrade the VirtualCenter database.
3 Choose a host and datastore pair to upgrade.
4 Power off all virtual machines on the host.
6 Perform an in‐place file system upgrade from VMFS2 to VMFS3.
7 Upgrade the virtual hardware from VM2 format to VM3 format.
This step also relocates all virtual machine files to the VMFS3 datastore.
8 Upgrade VMware Tools 2 to VMware Tools 3.
36 VMware, Inc.
Chapter 2 ESX Server 3 and VirtualCenter Upgrade Scenarios
In this scenario, you use upgrade VMotion (also known as VMotion with datastore
relocation) to copy the virtual machines over the network. A typical environment for
this upgrade is illustrated in Figure 2‐4.
NOTE You cannot use this type of migration upgrade for virtual machines residing on
a shared mode VMFS2 datastore. For more information on upgrading with shared
VMFS2 volumes, see Setup for Microsoft Cluster Service.
ESX 2 ESX 2
VMFS2
VM2 VM2
SAN
1 Upgrade VirtualCenter 1.x to 2.5.
For VirtualCenter 1.2, upgrade to VirtualCenter 1.4.1 before upgrading to
VirtualCenter 2.5.
For VirtualCenter 1.3 and higher, upgrade directly to VirtualCenter 2.5.
2 Upgrade the VirtualCenter database.
VMware, Inc. 37
Upgrade Guide
3 Evacuate the first ESX Server 2.x host using VMotion.
5 Use the first host to create a new VMFS3 volume on the SAN.
This volume must be equal or greater in storage capacity to the VMFS2 volume to
be upgraded.
6 Use upgrade VMotion to move the virtual machines from the VMFS2 datastore to
the host with the new VMFS3 datastore.
7 Power off the virtual machines and upgrade the virtual hardware from VM2
format to VM3 format.
8 From within the guest operating systems, upgrade VMware Tools 2 to VMware
Tools 3.
10 After all the remaining virtual machines are evacuated, upgrade the ESX Server to
ESX Server 3.x.
1 Use VMotion to evacuate all virtual machines from one host to other hosts.
4 For the virtual machines whose .vmdk files are located on this VMFS 2 LUN, power
them off (on the other ESX Server 2 hosts).
38 VMware, Inc.
Chapter 2 ESX Server 3 and VirtualCenter Upgrade Scenarios
6 When prompted, select Keep virtual machine configuration files and virtual
disks in their current locations.
The relocate operation copies only the configuration (.vmx) files, because both the
ESX Server 3.x host and the ESX Server 2.x host see the common VMFS2
volume/LUN. The virtual machines are now in the following state: The .vmx files
are in the EXT3 partition of the ESX Server 3.x service console, and .vmdk files are
on VMFS2. They cannot be powered on at this point.
The virtual machines can now be powered on in the legacy virtual hardware VM2
format.
VMware supports only limited operations on the virtual machine at this level:
Power‐ons, connect/disconnect removable devices and point them at file images
and relocate.
8 Upgrade the virtual hardware from VM2 format to VM3 format and upgrade
VMware Tools 2 to VMware Tools 3.
Performing an in‐place upgrade allows you to save the time otherwise required for
copying disks over the network.
Suppose you have eight servers and eight LUNs. You can iterate through this
process for server 1 and LUN 1, server 2 and LUN 2, server 3 and LUN 3, and so
on. When you have two or three servers remaining, it might not be possible to
perform Step 1 (evacuate the servers using VMotion). You can use upgrade
VMotion for the final few servers. See “Scenario 2: Upgrading Hosts on a SAN
Using Upgrade VMotion” on page 37.
VMware, Inc. 39
Upgrade Guide
Minor Upgrades
(SEE UPDATE) Minor upgrades involve upgrading from VirtualCenter 2.5/ESX Server 3.x
to VirtualCenter 2.5 and ESX Server 3.5.
2 Upgrade the VirtualCenter database.
3 Power off all virtual machines on the ESX Server host.
5 Upgrade VMware Tools version 2 to VMware Tools version 3.
2 Upgrade the VirtualCenter database.
3 Use VMotion to evacuate virtual machines from the ESX Server 3.0.x host.
5 Use VMotion to move the virtual machines back to the ESX Server host.
6 Upgrade VMware Tools 2 to VMware Tools 3.
40 VMware, Inc.
Chapter 2 ESX Server 3 and VirtualCenter Upgrade Scenarios
2 Upgrade the VirtualCenter database.
3 Place the ESX Server host into maintenance mode.
4 Wait until the software evacuates all the virtual machines from the ESX Server host.
6 Add the upgraded ESX Server to the DRS cluster.
VMware, Inc. 41
Upgrade Guide
42 VMware, Inc.
3
“Major Upgrades” on page 43
“Minor Upgrades” on page 45
“Changing the ESX Server Version” on page 47
Major Upgrades
Major upgrades involve upgrading from VMware Infrastructure 2 to
VMware Infrastructure 3. Specifically, these scenarios discuss upgrades from
ESX Server 2.5.x and VirtualCenter 1.x to ESX Server 3i version 3.5 and
VirtualCenter 2.5.
VMware, Inc. 43
Upgrade Guide
For VirtualCenter 1.2, upgrade to VirtualCenter 1.4.1 before upgrading to
VirtualCenter 2.5.
For VirtualCenter 1.3 and higher, upgrade directly to VirtualCenter 2.5.
2 Upgrade the VirtualCenter database.
3 Add an ESX Server 3i host to the VirtualCenter 2.5 inventory.
5 Use upgrade VMotion to migrate a virtual machine from the ESX Server 2.5.x host
to the ESX Server 3i host.
6 Power off the virtual machine.
7 Upgrade the virtual hardware from VM2 format to VM3 format.
8 Power on the virtual machine.
9 Upgrade from VMware Tools 2 to VMware Tools 3.
For VirtualCenter 1.2, upgrade to VirtualCenter 1.4.1 before upgrading to
VirtualCenter 2.5.
For VirtualCenter 1.3 and higher, upgrade directly to VirtualCenter 2.5.
2 Upgrade the VirtualCenter database.
44 VMware, Inc.
Chapter 3 ESX Server 3i and VirtualCenter Upgrade Scenarios
5 Power off the virtual machines on the ESX Server 2.5.x host.
7 When prompted, select Keep virtual machine configuration files and virtual
disks in their current locations.
The relocate operation copies only the configuration (.vmx) files, because both the
ESX Server 3i host and the ESX Server 2.5.x host see the common VMFS2
volume/LUN. The virtual machines are now in the following state: The .vmx files
are in the VMFS3 partition of the ESX Server 3i host, and .vmdk files are on VMFS2.
They cannot be powered on at this point.
11 Upgrade the virtual hardware from VM2 format to VM3 format.
13 Upgrade VMware Tools 2 to VMware Tools 3.
Minor Upgrades
Minor upgrades involve upgrading from VirtualCenter 2.0.x and ESX Server 3.0.x to
VirtualCenter 2.5 and ESX Server 3.5 and adding ESX Server 3i version 3.5.
2 Upgrade the VirtualCenter database.
5 Upgrade VMware Tools version 2 to VMware Tools version 3.
VMware, Inc. 45
Upgrade Guide
2 Upgrade the VirtualCenter database.
4 Power off the virtual machines on the LUN.
5 Assign the LUN to the ESX Server 3i host.
7 Power on the virtual machines on the LUN.
8 Upgrade VMware Tools 2 to VMware Tools 3.
2 Upgrade the VirtualCenter database.
The upgraded ESX Server is part of the DRS cluster.
46 VMware, Inc.
Chapter 3 ESX Server 3i and VirtualCenter Upgrade Scenarios
1 Do one of the following:
For information about uninstalling ESX Server 3, see the Installation Guide. For
information about installing ESX Server 3i Installable, see the Setup Guide.
See the Basic System Administration Guide.
See the VI Client Help.
1 Do one of the following:
See the Basic System Administration Guide.
See the VI Client Help.
VMware, Inc. 47
Upgrade Guide
48 VMware, Inc.
4
Upgrading VirtualCenter 4
This chapter describes important considerations to be aware of and preparations to
make before you begin a VirtualCenter upgrade. This chapter includes procedures for
upgrading VMware VirtualCenter:
“Release Upgrade Support” on page 49
“Before You Upgrade VirtualCenter” on page 51
“Performing the VirtualCenter Upgrade” on page 53
CAUTION You must upgrade VMware VirtualCenter before you upgrade VMware
ESX Server. However, some upgrade procedures in this chapter must occur after you
install VMware ESX Server. If you do not upgrade in the stages described in this
manual, you can lose data and lose access to your servers. See “Understanding the
Stages of Upgrading” on page 23.
VirtualCenter upgrades are supported from VirtualCenter 1.x to the latest
VirtualCenter release.
Unsupported upgrades include all VirtualCenter beta releases. Upgrading from
these releases can fail with lost data and unusable configurations.
VMware, Inc. 49
Upgrade Guide
Table 4‐1 lists versions of VirtualCenter that are supported for upgrade.
VirtualCenter beta release (any) No upgrade support
VirtualCenter 1.0 No upgrade support
VirtualCenter 1.1 No upgrade support
VirtualCenter 1.2 Upgrade to VirtualCenter 1.4.1 before upgrading to
VirtualCenter 2.5.
VirtualCenter 1.3 Yes
VirtualCenter 1.3.x Yes
VirtualCenter 1.4 Yes
VirtualCenter 1.4.x Yes
VirtualCenter 2.0 Yes
VirtualCenter 2.0.1 Yes
VirtualCenter 2.0.2 Yes
VirtualCenter 2.5 Yes
VirtualCenter 2.5 Update 1 Yes
50 VMware, Inc.
Chapter 4 Upgrading VirtualCenter
VirtualCenter 2.5 Uses TCP/IP Ports 80 and 443
Previous releases allow you to run the VirtualCenter Server on the same machine
as a Web server using TCP/IP port 80 (http) or port 443. This configuration is no
longer allowed because it causes a port conflict. The VirtualCenter Server uses
TCP/IP ports 80 and 443 for the VMware Infrastructure Web client.
VirtualCenter 2.x Cannot Run on a GSX Server Host
VirtualCenter 2.x server cannot exist on a GSX Server host. These VMware
applications use the same TCP/IP ports (notably 80 and 902). You can remove GSX
Server software after you perform the VirtualCenter Server upgrade. However,
with both products operating on the same machine, errors can include the
following:
No Web access to VirtualCenter 2.x.
Connections using VI Client produce the message
530 Please Login with USER and PASS.
Dropped or unsuccessful connections occur when using the GSX Server client.
VirtualCenter Database Must Be Upgraded
As part of upgrading your VirtualCenter Server, you must upgrade the
VirtualCenter database. You cannot use the same database for VirtualCenter 1.x
and 2.x.
CAUTION When the VirtualCenter Database Upgrade wizard runs, it updates the
database with extra fields, making the database unusable by VirtualCenter 1.x.
VMware, Inc. 51
Upgrade Guide
Make sure that your database meets the requirements shown in Table 4‐2.
Microsoft SQL Server 2000 Standard Install SP4 for Microsoft SQL Server 2000.
Microsoft SQL Server 2000 Enterprise For Windows 2000 and Windows XP, apply MDAC 2.8
SP1 to the client.
Use the SQL Server driver for the client.
Microsoft SQL Server 2005 Standard Install SP1 or SP2 for Microsoft SQL Server 2005.
Microsoft SQL Server 2005 Enterprise For Windows 2000 and Windows XP, apply MDAC 2.8
SP1 to the client.
Use the SQL Native Client driver for the client.
Microsoft SQL Server 2005 Express SP2 For Windows 2000 and Windows XP, apply MDAC 2.8
SP1 to the client.
Use the SQL Native Client driver for the client.
Oracle 9i release 2 Standard Apply patch 9.2.0.8.0 to the server and client.
Oracle 9i release 2 Enterprise
Oracle 10g Standard Release 1 (10.1.0.3.0) None
Oracle 10g Enterprise Release 1 (10.1.0.3.0)
Oracle 10g Standard Release 2 (10.2.0.1.0) First apply patch 10.2.0.3.0 to the client and server.
Oracle 10g Enterprise Release 2 (10.2.0.1.0) Next apply patch 5699495 to the client. (SEE UPDATE)
Make sure that the database user has the following permissions:
Oracle – Either grant dba permission to the user, or grant the following
permissions to the user:
grant connect to <user>
grant resource to <user>
grant create view to <user>
grant create any sequence to <user> # For VirtualCenter upgrade only
grant create any table to <user> # For VirtualCenter upgrade only
grant execute on dbms_job to <user>
grant execute on dbms_lock to <user>
grant unlimited tablespace to <user> # To ensure space limitation is
not an issue
52 VMware, Inc.
Chapter 4 Upgrading VirtualCenter
Microsoft SQL Server 2000 – Make sure that the database user has the
db_owner fixed database role on the VirtualCenter database and the MSDB
database. The db_owner role on the MSDB database is required for
installation and upgrade only. You can revoke this role after the installation or
upgrade process is completed. Do not grant the System Administrators server
role to the database user. However, if the System Administrators role was
previously granted while the database was used with VirtualCenter 2.0.x, do
not revoke the System Administrators role. Leave it as is.
Microsoft SQL Server 2005 – Make sure that the database login has either the
sysadmin server role or the db_owner fixed database role on the VirtualCenter
database and on the MSDB database. The db_owner role on the MSDB
database is required for installation and upgrade only. You can revoke this role
after the installation or upgrade process is complete.
If you are installing a new database, read the detailed instructions for preparing
your database. These instructions are included in the Setup Guide for ESX Server 3i
and the Installation Guide for ESX Server 3.
The VirtualCenter upgrade includes upgrading VirtualCenter, the VirtualCenter
database, the VI Client, and the license server.
Upgrading VirtualCenter
The VMware Infrastructure Management installer detects any previous VirtualCenter
release and uninstalls it. After the uninstall, the actual installation of VirtualCenter
begins.
This operation requires downtime for the VirtualCenter Server that you are upgrading.
No virtual machines need to be powered off.
If a previous VirtualCenter release was installed, the VirtualCenter installation wizard
presents you with several screens that are specific to the upgrade procedure:
1 As Administrator on the Windows system, insert the VMware Infrastructure
Management Installer CD.
2 When the VMware Infrastructure Management Installer screen appears, click
Next.
VMware, Inc. 53
Upgrade Guide
If the VMware Infrastructure Management Installer screen does not appear,
double‐click the autorun.exe icon.
3 A dialog box appears with the message, “Would you like to remove the VMware
VirtualCenter database settings from this machine? Select ʹNOʹ if you would like to
preserve these settings for future install.”
Click No to preserve the VirtualCenter database for upgrading by the
Database Upgrade wizard.
Click Yes if you had a Microsoft Access database and no longer need it.
CAUTION If you click Yes, the data store name (DSN) is deleted, and the
Database Upgrade wizard cannot upgrade the VirtualCenter database. To
recover the DSN, follow the instructions in “Repairing the Database DSN” on
page 58.
4 Select Launch the VMware VirtualCenter Server 2.5 database upgrade wizard to
upgrade your database after the installation is finished. Click Finish to complete
the installation of the VirtualCenter Server.
The Database Upgrade wizard launches.
5 Continue with “Using the Database Upgrade Wizard” on page 57.
The following manuals provide information about installing VMware Infrastructure:
To restore a database DSN that you have deleted, follow the steps in “Repairing the
Database DSN” on page 58.
NOTE You must first upgrade a VirtualCenter Server version 1.2 to version 1.4.1. If you
are upgrading from VirtualCenter 1.1 or lower, first upgrade to version 1.2, then to
version 1.4.1.
54 VMware, Inc.
Chapter 4 Upgrading VirtualCenter
When migrating an existing VirtualCenter database to one of the database formats
supported by VirtualCenter 2.5, keep in mind the following:
If you select the database upgrade option, the appropriate scripts for a database
upgrade are launched, and progress, status, and any error messages encountered
appear in the VirtualCenter installer.
If you are upgrading a SQL database, you must first enable bulk logging in the
database.
a Open SQL Server Enterprise Manager.
b Right‐click the database and click Properties > Options > Recovery Mode.
c Select Bulk‐logged.
If a database chosen for upgrade appears to be corrupted or somehow
incompatible with the database upgrade process, a warning appears in the
VirtualCenter Server installer. You are given the option to cancel the database
upgrade process.
If you upgrade on a Windows 2000 Server SP4 machine, Windows 2000 Server
SP4 requires installation of Microsoft Data Access Components (MDAC) 2.8 or
higher. Before you upgrade VirtualCenter on Windows 2000, you should upgrade
to the latest version of MDAC. This issue does not appear to affect other Windows
versions, only Windows 2000.
VirtualCenter release 1.0 or 1.1 – VirtualCenter 2.5 cannot upgrade your database.
Click No. The installer creates an empty database, using your existing database
configuration and login credentials.
VirtualCenter release 1.2 and 1.3 – VirtualCenter 2.5 can upgrade your database,
or you can create an empty database:
Click OK to upgrade the existing database for VirtualCenter 2.5.
Click No to have the installer create an empty database, using your existing
database configuration and login credentials.
VMware, Inc. 55
Upgrade Guide
If you have data in an Access database that you want to use with your upgraded
VirtualCenter 2.5 installation, you can migrate to an Microsoft SQL Server 2005 Express
or SQL Server database.
1 Install Microsoft SQL Server 2005 Express or SQL Server.
2 Create and configure a new database to store the VirtualCenter repository.
3 Shut down the VirtualCenter Server.
4 Reinstall VirtualCenter 1.2 or 1.3, selecting the database you created in Step 2 as
your database.
Do not start the VirtualCenter service after reinstallation.
5 Use the Microsoft Access Upsizing wizard to migrate your old database to the new
database:
a Open the database that you want to migrate in Microsoft Access.
b Choose Tools > Database Utilities > Upsizing Wizard.
c Select Use existing database and click Next.
d In the Select Data Source dialog box, click the Machine Data Source tab, select
the DSN you created as part of Step 2, and click OK.
e Click >> to move all available tables to the Export to SQL Server column and
click Next.
f Do not select any table attributes to data options to include and click Next.
g Select No application changes and click Next.
h Click Finish.
6 Review the report. If no errors are reported, migration is complete.
After your Microsoft Access database has been migrated to an Microsoft SQL Server
2005 Express or SQL Server database, it can be upgraded as part of the upgrade to
VirtualCenter 2.5.
56 VMware, Inc.
Chapter 4 Upgrading VirtualCenter
NOTE The Microsoft Access Upsizing wizard is available in Microsoft Access 2000 and
higher versions. For information on using the Upsizing wizard on earlier versions of
Access and for other known issues, refer to the following Microsoft knowledge base
articles: http://support.microsoft.com/default.aspx?kbid=241743 and
http://support.microsoft.com/?kbid=237980.
The following manuals provide information about configuring Microsoft SQL Server
2005 Express:
1 Open the command prompt.
2 Change the working directory to the VirtualCenter installation directory.
3 Run the VCDatabaseUpgrade.exe command with the following parameters:
> VCDatabaseUpgrade.exe DSN=<dsn-name> UID=<DB-Username>
PWD=<DB-user-password>
1 On the first page of the wizard, review the supported database types.
If your database is not one of these supported types, click Cancel, convert the
database to one of those types, and restart the wizard.
On the first three wizard pages, you can click Cancel at any time to cancel the
upgrade process and close the wizard. If you do not upgrade your
VirtualCenter 1.x database, you cannot use the VirtualCenter 2.5 with that
database.
2 After you determine that your database is one of the supported database types,
click Next.
VMware, Inc. 57
Upgrade Guide
3 On the Upgrade Information page of the wizard, select one or both of the following
options if you want to include either of these types of data in your upgraded
database:
Preserve events and tasks – Ensures that all events and tasks associated with
the ESX Server hosts, virtual machines, and VirtualCenter 1.x are preserved
after the upgrade.
Preserve performance data – Ensures that all performance data for the
ESX Server hosts and virtual machines is preserved after the upgrade.
The tables for events/tasks and performance data can be large. For that reason,
you might decide not to save them. If you do not preserve the tables, you
cannot view historical performance statistics and events/tasks for the time
when the database was maintained in VirtualCenter 1.x.
4 Click Next after you have selected the options you want to use.
5 On the Ready to Complete page of the wizard, review the summary information.
To change any information, click Back or click the Upgrade Information link to
return to the Upgrade Information panel.
6 When the summary information is correct, click Start to begin the upgrade process.
The Upgrade Status page appears and shows you the progress of the upgrade as it
occurs. When the upgrade has completed, a message about the success or failure
of the upgrade process appears.
After a successful database upgrade, the system tries to start the vpxd service. If
the service times out because the database is large, you see an error message noting
that the upgrade has failed. The upgrade has not failed, however. The installer
timed out waiting for the service to start.
7 Click Finish to close the Database Upgrade wizard.
1 Create a DSN and configure it with the same options used for your original
VirtualCenter 1.x DSN.
2 Start the VirtualCenter Server installer again.
58 VMware, Inc.
Chapter 4 Upgrading VirtualCenter
3 Select the Repair/Modify option and provide database details in the Database
Information page.
4 Complete the remaining steps of the VirtualCenter upgrade, and launch the
Database Upgrade wizard.
Follow the steps described in “Using the Database Upgrade Wizard” on page 57.
1 (Optional) Use Add/Remove Programs from the control panel to remove any
previous VMware client.
Older VMware clients do not need to be removed. The VI Client can coexist with
the VirtualCenter Client version 1.x, 2.0.x, the GSX Server Client version 3.x, and
the VMware remote console.
2 Install the VI Client.
VMware, Inc. 59
Upgrade Guide
60 VMware, Inc.
5
This chapter includes the following sections:
“Release Upgrade Support” on page 61
“Before You Upgrade ESX Server” on page 62
“Performing the ESX Server Host Upgrade” on page 69
“Upgrading Datastores” on page 78
“Relocating Virtual Machines” on page 80
CAUTION If you have an enterprise using VMware VirtualCenter, you must upgrade
the VirtualCenter Server before you upgrade any ESX Server hosts. Otherwise, you
might lose data and host access.
VMware, Inc. 61
Upgrade Guide
This section discusses important issues to consider before you upgrade an ESX Server
host.
62 VMware, Inc.
Chapter 5 Upgrading ESX Server
This manual assumes you have a multiple‐server production environment to upgrade
your VMware ESX Server, one host at a time. However, even if you have only one
ESX Server host, your upgrade steps should follow the same order.
The service console (ESX Server) – Installs, configures, and administers
third‐party add‐ons for ESX Server. This is a modified version of Red Hat
Enterprise Linux 3.0 with a single purpose: configuring the ESX Server host.
VMkernel – Manages system hardware and the virtual machines running on the
server. Users communicate with the VMkernel through the service console.
VMkernel modules – Support high‐performance device I/O and allow you to add
functionality at runtime to the VMkernel (for example, network traffic filters).
VMware, Inc. 63
Upgrade Guide
Upgrade Requirements
To upgrade VMware ESX Server, you need:
A computer running ESX Server 2.x or later that meets the system hardware
requirements for ESX Server 3.5. For information about hardware requirements,
see the following guides:
To upgrade your VMFS2 volumes to VMFS3 as described in “Upgrading Datastores”
on page 78, you must have at least 1200MB of free space on the VMFS2 volumes. Run
the preupgrade script as described in “Running the Preupgrade Script” on page 70. The
script checks that your VMFS2 volumes meet the minimum space requirements.
If the VMFS2 volume does not have sufficient free space, the upgrade to VMFS3 fails.
An error message is displayed. To proceed, free up space on the VMFS2 volume.
1 Log in to the service console through SSH or a local console.
2 Unload the vmfs2 and vmfs3 modules by typing vmkload_mod -u vmfs2 and
vmkload_mod -u vmfs3 at the command line.
3 Load the fsaux module in VMFS‐2 unlink mode by typing vmkload_mod fsaux
fsauxFunction=fs2unlink.
4 Move or remove files on the volume to make at least 1200MB available on it.
Use the rm and mv commands.
5 Unload the fsaux module by typing vmkload_mod -u fsaux.
6 Reload the vmfs2 and vmfs3 modules by typing vmkload_mod vmfs2 and
vmkload_mod vmfs3.
7 Try the upgrade again.
64 VMware, Inc.
Chapter 5 Upgrading ESX Server
SCSI disk drive or RAID – Supported for installing ESX Server and for storing
virtual machines.
SANs – Supported for installing ESX Server and for storing virtual machines. For
important considerations about LUN requirements, see the following guides the
Installation Guide.
iSCSI disk drive – Supported for installing ESX Server and for storing virtual
machines.
SATA – If connected through specified SAS controllers, are supported for
installing ESX Server and for storing virtual machines.
NOTE If you are upgrading an ESX Server system with an IDE drive that has the master
boot record (MBR) on it, and a SCSI drive that has the ESX Server service console
installed on it, you might experience boot problems after upgrading, such as booting
into a grub boot loader menu. The ESX Server 3 upgrade installer selects the disk
containing the service console as the default boot device. To avoid problems, either
select the IDE drive as the boot device during the upgrade or change the settings in the
system BIOS after the upgrade to set the SCSI drive as the boot device.
VMware, Inc. 65
Upgrade Guide
Serial ATA (SATA) disk drives – When plugged into dual SATA/SAS controllers,
supported for installing ESX Server 3i and for storing virtual machines on VMFS
partitions. Ensure that your SATA drives are connected through supported
controllers.
IDE and ATA drives are not supported for VMFS3 partitions. SATA drives do not
support VMFS volumes shared across multiple ESX Server hosts.
Although ESX Server supports up to 256 LUNs for operation, the installer supports a
maximum of 128 SCSI, Fibre Channel SAN, and gatekeeper LUNs. If you have more
than 128 LUNs, connect them after the installation is complete.
66 VMware, Inc.
Chapter 5 Upgrading ESX Server
Allocated to the VMkernel for use by virtual machines
Allocated to the service console
Allocated to the VMkernel but shared with the service console
When you upgrade from ESX Server 2.x, all PCI devices are allocated to the VMkernel
and shared with the service console as necessary.
VMware ESX Server
Service Console only (troubleshooting mode)
VMware, Inc. 67
Upgrade Guide
1 Using a PS/2 keyboard or logging in to your system remotely, open the
/etc/modules.conf file in a text editor.
2 Add the following line to the /etc/modules.conf file:
alias usb-controller usb-uhci
If you have a Compaq machine, which uses the Open Host Controller Interface,
add the following line:
alias usb-controller usb-ohci
3 Run the following command:
modprobe usb-[o|u]hci
If upgrading from ESX Server 2.5, convert the RAW disk to a raw device mapping
before upgrading. See the ESX Server 2.5 Administration Guide.
If upgrading from ESX Server 2.1, remove the RAW disk from the virtual machine
before upgrading. When you have finished upgrading, add the RAW disk back as
a raw device mapping.
68 VMware, Inc.
Chapter 5 Upgrading ESX Server
NOTE VMware recommends that for each ESX Server 2 host, you perform
Procedure 2A and Procedure 2B together. Upgrade one host and its datastores, then
another host and its datastores, and so on. This technique prevents a situation in which
you have a long time with no access to any virtual machine.
If you have a VMotion license, use it to migrate all virtual machines to a different
ESX Server host before you upgrade this ESX Server binary. Migrating prevents
virtual machine downtime during Procedure 2A.
If you do not have VMotion, all virtual machines have unavoidable downtime at
this step. You can minimize the downtime for a production virtual machine by
preparing an ESX Server host with a VMFS3 partition before you begin upgrading
the production ESX Server hosts.
For procedures to minimize downtime, see “Understanding the Stages of Upgrading”
on page 23.
Graphical installer from CD – Use a graphical, mouse‐based installation program
to upgrade ESX Server. This is the recommended installation method.
See “Upgrading Using the Graphical Installer” on page 71.
Text‐mode installer from CD – Use a text‐based interface to upgrade ESX Server.
Choose this upgrade method if your video controller, keyboard, or mouse does not
function properly using the graphical installer. See “Upgrading Using the
Text‐Based Installer” on page 73.
VMware, Inc. 69
Upgrade Guide
Tarball installer from download – Use the service console to upgrade ESX Server.
See “Upgrading from ESX Server 2.x Using a Tarball” on page 76.
Scripted upgrade from CD or PXE server – Use a scripted installation method to
upgrade ESX Server. For information about scripted installations and upgrades,
see the Installation Guide.
2 Mount the CD:
mount /mnt/cdrom
3 Run the upgrade script:
perl /mnt/cdrom/scripts/preupgrade.pl
After you run the script, review any warnings or error messages, and take appropriate
action. If there are no problems with the system, the script informs you that it is safe to
upgrade.
70 VMware, Inc.
Chapter 5 Upgrading ESX Server
1 Run the preupgrade script, and address any problems flagged.
2 Verify that the network cable is plugged into the Ethernet adapter that you are
using for the service console.
The ESX Server installer needs a live network connection to properly detect certain
network settings, such as the machine name under DHCP.
3 Power on the machine with the VMware ESX Server CD in the CD drive.
ESX Server begins its boot process until the mode selection page appears.
If this page does not appear:
a Reboot the machine.
b Press the key required to enter your machine’s BIOS Setup page.
This key is often F1, F2, or F10.
c Set the CD as the first boot device.
d Reboot the machine.
4 Press Enter.
A series of installation messages scroll past until the Test Media page appears.
5 Select Test to have the installer inspect the installation CD media for errors.
If you select Skip, continue with Step 6.
If you select OK, a progress bar appears. The CD media is being tested for
errors. When testing is complete, a Media Check Result dialog box appears
and click OK.
Anaconda system installer messages appear.
6 Click Next at the Welcome page.
The Select Keyboard page appears.
7 Choose the language for your keyboard from the list and click Next.
The Mouse Configuration page appears.
VMware, Inc. 71
Upgrade Guide
8 Select your mouse.
Mouse configuration is not a critical setting. After ESX Server is installed, the
setting is ignored. The X Window System is not supported from the service
console.
9 Select Upgrade and click Next.
10 Read through the end user license agreement, select the I accept the terms of the
license agreement check box and click Next.
You cannot install this product unless you accept the license agreement.
If the installer does not detect that your drive has been partitioned, you see the
following dialog box.
11 If you are upgrading, do not click Yes. If you expected to upgrade a previous
ESX Server installation and you see this dialog box, click No and exit from the
installation.
The installer does not recognize your existing ESX Server installation, and the disk
partitioning or file system needs repair before any upgrade can occur.
12 Select how the ESX Server will boot:
From a drive (install on the MBR of the drive) – Use this option for most
installations.
This drive must match the first boot device set in the host BIOS. If these
settings do not match, the host cannot boot into ESX Server. If these settings
are not properly configured, the host boots into a grub boot loader menu
instead of ESX Server.
From a partition – Use this option for legacy hardware that stores BIOS
information in the MBR.
Do not select an optical drive as the location for the boot loader.
72 VMware, Inc.
Chapter 5 Upgrading ESX Server
13 Select the boot options.
To add default options to the boot command, enter them into the General kernel
parameters field. These options are passed to the ESX Server kernel every time it
boots.
14 Review and confirm your entries and click Next.
With an upgrade, you do not have to configure disk partitions, network, time zone,
or root password. All these settings are preserved from your previous installation.
CAUTION This is the last opportunity to cancel the upgrade and return to your
previous configuration. When you click Next, the installer begins upgrading your
existing installation.
A progress bar appears with a percentage indicator to show the status of the
upgrade. A dialog box informs you when the installation completes.
15 Click Finish to exit and reboot.
NOTE If the system reboots and displays a boot loader prompt, such as LILO or LI, the
BIOS boot setting is set to a different disk than the one you specified during Step 12 of
the upgrade. Change the BIOS settings so that the correct disk is selected for booting.
To navigate and perform actions in the ESX Server text installer, press the Tab key,
spacebar, arrow keys, or Enter key:
Move the highlight between selection fields using the Tab key.
Make a selection within a field using the arrow keys or by typing a value.
Press Tab until the highlight is in the OK box, and then press the spacebar or Enter.
1 Download the ESX Server installer CD image and burn a CD for it.
2 Verify that the network cable is plugged into the Ethernet adapter that you are
using for the service console.
The ESX Server installer needs a live network connection to properly detect certain
network settings, such as the machine name under DHCP.
VMware, Inc. 73
Upgrade Guide
3 Power on the machine with the VMware ESX Server CD in the CD drive.
The ESX Server begins its boot process until the mode selection page appears.
If this page does not appear:
a Reboot the machine.
b Press the key required to enter your machine’s BIOS Setup page.
This key is often F1, F2, or F10.
c Set the CD as the first boot device.
d Reboot the machine.
4 Type esx text, and press Enter.
A series of installation messages scroll past until the Test Media page appears.
5 Click Test to have the installer inspect the installation CD media for errors.
If you click Skip, continue with Step 6.
If you click Test, a progress bar appears. The CD media is being tested for
errors. When testing is complete, a Media Check Result dialog box appears
and click OK.
6 Click OK at the Welcome page.
7 Select your keyboard language and click OK.
8 Select your mouse and click OK.
If the installer detects a previous installation of ESX Server, a dialog box appears
allowing you to select Install or Upgrade.
9 Select Upgrade and click OK.
The license agreement appears.
10 Read through the end user license agreement, select the I accept the terms of the
license agreement check box and click Next.
You cannot upgrade this product unless you accept the license agreement.
74 VMware, Inc.
Chapter 5 Upgrading ESX Server
11 Select the location for the boot loader record.
From a drive (install on the MBR of the drive) – Use this option for most
installations.
This drive must match the first boot device set in the host BIOS. If these
settings do not match, the host cannot boot into ESX Server. If these settings
are not properly configured, the host boots into a boot loader menu instead of
ESX Server.
From a partition – Use this option for legacy hardware that stores BIOS
information in the MBR.
Do not select an optical drive as the location for the boot loader.
12 Click OK.
13 Configure the boot loader options and click OK.
14 Confirm your entries and click OK.
CAUTION This is the last opportunity to cancel the upgrade and return to your
previous configuration. When you click Next, the installer begins upgrading your
previous installation.
A progress bar appears with a percentage indicator to show the status of the
installation. A dialog box appears when the installation completes.
15 Click Finish to exit and reboot.
NOTE If the system reboots and displays a boot loader prompt (such as LILO or LI),
the BIOS boot setting is set to a different disk than the one you specified during Step 11
of the upgrade. Change the BIOS settings so that the correct disk is selected for booting.
VMware, Inc. 75
Upgrade Guide
Previous releases allowed you to upgrade using a tarball with one script and two
reboots. Due to the added complexity of upgrading from ESX Server 2.x to
ESX Server 3.5, upgrading now requires two scripts and three reboots.
NOTE When upgrading using an upgrade tarball, do not interrupt the upgrade
process. If the upgrade script is interrupted in the middle of an upgrade, you might not
be able to restart it due to a lack of free disk space.
In this case, either attempt to free up disk space and try again, or force the upgrade by
passing the --force option to upgrade.pl.
1 Reboot the ESX Server host into Linux mode.
2 Run the script upgrade.pl.
3 Reboot the ESX Server host into Service Console only mode.
4 Run the script upgrade2.pl.
Both scripts have the same syntax, and accept the same arguments.
The form of these commands is:
./upgrade.pl
Available options include:
-h, --help: Display a help message.
--accept-eula: Accept the end user licensing agreement.
--reboot=[yes|no]: Do not prompt for reboot. If yes, reboot. If no, do not reboot.
Defaults to yes if neither is specified.
76 VMware, Inc.
Chapter 5 Upgrading ESX Server
Other useful options:
-n/--noreboot
Disable the automatic reboot after update. If you include this option, you must
reboot the host manually for the changes to take effect.
-x <pkgname>
Exclude a package.
1 Download the esxupdate zip file.
This zip file is not the same as the tarball used to upgrade from ESX Server 2.x to
ESX Server 3.5. Ensure that you have downloaded the correct file before
proceeding.
2 Extract the compressed zip file and change to the newly created directory.
The easiest way to do this is to run the unzip command:
unzip VMware-esx-upgrade-from-esx3-<build>.zip
3 Type esxupdate update.
When the update command completes, the software reboots the ESX Server host.
For detailed information on the esxupdate utility, see the ESX Server 3 Patch
Management Guide. For information on the vihostupdate utility for ESX Server 3i, see
the Setup Guide.
VMware, Inc. 77
Upgrade Guide
Upgrading Datastores
This section describes the procedures for upgrading an ESX Server datastore from
VMFS2 to VMFS3.
This Procedure 2B requires downtime for all virtual machines on the datastore being
upgraded. However, an ESX Server 3 host with multiple datastores can operate virtual
machines already stored on VMFS3 datastores while upgrading a VMFS2 datastore to
VMFS3.
You can minimize downtime for virtual machines by migrating them to another
datastore while this one is upgraded. See “Migration Upgrade” on page 21.
When upgrading an ESX datastore from VMFS2 to VMFS3, keep in mind the following:
If you have a virtual machine with disks on multiple VMFS2 volumes, the first virtual
disk and the .vmx file are relocated to a subdirectory when the VMFS2 volume on which
they reside is upgraded to VMFS3. Other virtual disks located on other VMFS2 volumes
are not relocated, even when those disks are upgraded to VMFS3.
You must upgrade all of the VMFS2 datastores on which a virtual machine’s disks
reside before you power on that virtual machine.
VMFS3 file systems are restricted to a block size of no greater than 8MB. You cannot
directly upgrade a VMFS2 file system with a block size of greater than 8MB to VMFS3
using the procedure described below. To upgrade from a VMFS2 file system with a
block size greater than 8MB, use a migration upgrade strategy.
On ESX Server 3i hosts, if you configure system swap on the VMFS3 volume, an
upgrade from VMFS2 to VMFS3 fails. To fix this problem, disable the system swap
before you upgrade your VMFS2 volume. To do this, reboot the ESX Server 3i host.
While the host is powering on, press the o key. Pressing the o key allows you to perform
an advanced system reboot by specifying options for the reboot. Run the nouwswap
command. After the host is powered on, retry the datastore upgrade.
An inconsistency exists between the maximum file sizes allowed in VMFS2 and
VMFS3. For example, on a 1 MB block size VMFS2 volume, you can store a file with the
size up to 456GB, while the maximum file size on a 1 MB block size VMFS3 volume
should not exceed 256GB. If your VMFS2 file system stores .vmdk files with a size
greater than the VMFS3 file system with the corresponding block size allows, use the
migration upgrade strategy to upgrade from VMFS2. Otherwise, your upgrade can fail.
78 VMware, Inc.
Chapter 5 Upgrading ESX Server
Table 5‐2 lists the maximum allowed file sizes.
Table 5-2. Maximum Allowed File Sizes for VMFS2 and VMFS3
Maximum .vmdk File Size
1 456GB 256GB
2 912GB 512GB
4 1.78TB 1TB
8 3.56TB 2TB
To upgrade a datastore
1 Connect to the ESX Server host using the datastore you want to migrate to VMFS3.
2 If shared, the datastores must be disconnected from other hosts before you attempt
the VMFS upgrade.
3 Put the ESX Server host into maintenance mode:
a Right‐click the appropriate host in the inventory, and choose Enter
Maintenance Mode from the drop‐down menu.
b Click Yes to confirm the dialog box that appears.
4 Select the volume you want to upgrade:
a Select the Configuration tab.
b Select Storage from the Hardware list.
c Click the appropriate item in the Storage pane.
d Click Upgrade to VMFS3.
When the file system is converted, the file system is VMFS3.
If any file on the VMFS2 file system is locked, the upgrade fails with an error
message identifying which ESX Server host is using the locked files.
5 Repeat this process until you have only VMFS3 datastores on this ESX Server host.
6 Exit maintenance mode:
a Select the Summary tab.
b Click Exit Maintenance Mode in the Commands area.
VMware, Inc. 79
Upgrade Guide
When the relocation is complete, a dialog box appears with the following message:
“The virtual machine files for host <hostname> have been relocated successfully.”
2 Click OK to dismiss the dialog box.
80 VMware, Inc.
6
“Upgrading Virtual Hardware to VM3 Format” on page 81
“Upgrading VMware Tools” on page 82
“Upgrading Virtual Machine Templates” on page 86
CAUTION You must upgrade the ESX Server host and datastore on which a virtual
machine resides before you upgrade a virtual machine.
NOTE Performing a virtual hardware upgrade on nonpersistent, append, and
undoable mode virtual machines converts the redo logs of the virtual machines to
snapshots. You can find the corresponding snapshots under the snapshot manager after
the upgrade. However, VMware recommends committing the redo logs before
performing the virtual hardware upgrade.
VMware, Inc. 81
Upgrade Guide
1 From the VI Client, right‐click a virtual machine in the inventory, and choose
Upgrade Virtual Hardware from the drop‐down menu.
A confirmation dialog box appears with the warning message.
2 Click Yes.
A progress bar appears in the Recent Tasks pane at the bottom of the client
window.
Repeat this procedure for all virtual machines on this host.
VMware recommends that you upgrade all virtual machines with the latest version of
VMware Tools. A virtual machine with an older version of VMware Tools, when
powered on an ESX Server 3 host or higher, might not have full network connectivity
and might display incorrect connectivity information.
For a description of the installation or upgrade of VMware Tools in each individual
virtual machine, see Basic System Administration.
2 Click Inventory in the navigation bar and expand the inventory.
3 In the inventory list, select the host on which virtual machines you want to
upgrade reside.
4 Click the Virtual Machines tab.
5 Select the virtual machines you want to upgrade with the new version of VMware
Tools.
If you are installing VMware Tools in the virtual machines, make sure that the
virtual machines are powered on.
82 VMware, Inc.
Chapter 6 Upgrading Virtual Machines
6 Right‐click the virtual machines and choose Install/Upgrade Tools.
VirtualCenter provides two options to upgrade VMware tools:
Interactive tools upgrade – Requires some user interaction and requires you
to reboot the guest operating system manually.
Auto tools upgrade – Upgrades tools without user interaction and reboots the
guest operating system, if required. Auto tools upgrade is supported for tools
version ESX 3.0.0 and above on Windows and Linux guest operating systems.
7 (SEE UPDATE) (Optional) Enter command‐line options in the Advanced field (see
Table 6‐1).
-u user Specifies a user with sufficient privileges on the target virtual
machine, including VirtualMachine.Config.*,
VirtualMachine.Interact.*, and VirtualMachine.Provisioning.*
-p password Specifies a password on the command line. If this is omitted, the tool
immediately prompts for a password.
-n vmname Specified the name of the virtual machine to upgrade. This name
corresponds to the display name of a virtual machine. Specify
multiple virtual machines using multiple -n parameters. The -n
option is ignored if -h is specified.
-h host Attempts to upgrade all the virtual machines on a particular host.
Fails if the specified host is not ESX Server 3.0 or greater.
-m maxpowerons On a particular host, powers on only this number of virtual machines
at a time.
-o port Specifies the VirtualCenter Server port, if a port other than the default
port 902 has been configured.
-t maxpowerontime Allows a user to set the maximum amount of time for a virtual
machine to be powered on in case the guest is unable to power off the
machine itself.
After the tools upgrade is scheduled on a virtual machine, the virtual
machine is powered on and allowed to run through the tools
installation process. In most cases, the guest powers down the
machine when the process completes.
-s Skips the tools and does only the virtual hardware upgrade.
-q Works quietly. Doesn’t produce status or completion messages on
shutdown.
VMware, Inc. 83
Upgrade Guide
After you install or upgrade VMware Tools in virtual machines, you need to reboot
guest operating systems to be able to use the new drivers.
For more information about installing and upgrading VMware Tools, see Basic System
Administration.
For the case illustrated in Figure 6‐1, the path for the host testserver3.eng.vmware.com
is /Datacenter1/Folder1/testserver3.eng.vmware.com.
Figure 6-1. Example Hosts and Clusters Inventory View, Showing the Path for a Host
For the case illustrated in Figure 6‐2, the path for the virtual machine vm1 is
/Datacenter1/MyVMs/vm1.
Figure 6-2. Example Virtual Machines and Templates Inventory View, Showing the
Path for a Virtual Machine
84 VMware, Inc.
Chapter 6 Upgrading Virtual Machines
Usage Examples
The following are some usage examples for the vmware-vmupgrade command:
To upgrade a single virtual machine named myvm, in datacenter DC, in the root
virtual machine folder:
vmware-vmupgrade -u user -n /DC/myvm
To upgrade a single virtual machine named vm1 in the folder My VMs, in
datacenter DC, in the folder dcFolder:
vmware-vmupgrade -u user -n /dcFolder/DC/MyVMs/vm1
To upgrade two virtual machines, vm1 and vm2, both in datacenter DC, and to
force all virtual machines to power off after 5 five minutes. One virtual machine is
a Linux virtual machine that does not have Advanced Power Management
configured, so that when the guest is shutdown, the virtual machine doesnʹt power
off.
vmware-vmupgrade -u user -n /DC/vm1 -n /DC/vm2 -t 5
To upgrade all (powered‐off) virtual machines on host myhost.vmware.com in the
root host folder of datacenter DC, while powering‐on at most two virtual machines
at a time on the host:
vmware-vmupgrade -u user -h /DC/myhost.vmware.com -m 2
To upgrade powered‐off virtual machines on host host1.vmware.com in cluster
myCluster in the datacenter folder /DC/folder1:
vmware-vmupgrade -u user -h /DC/folder1/myCluster/host1.vmware.com
While this behavior occurs mostly on Windows guest operating systems, it can occur
on older releases of Linux guest operating systems.
VMware, Inc. 85
Upgrade Guide
1 From the VI Client, log in to your VirtualCenter Server.
2 Choose Administration > Upgrade Legacy Templates.
The Legacy Template Upgrade wizard starts.
3 Select the template to upgrade and click Next.
4 If the template currently resides on the VirtualCenter Server disk, select an
ESX Server host to relocate to and click Next.
The Select Datastore page appears.
5 Select a disk on which to place the upgraded template and click Next.
6 Select the destination folder on the host and click Next.
7 Review your choices and click Finish.
The template is upgraded and relocated to the location you have chosen.
When you upgrade templates residing on the VirtualCenter Server disk, the upgraded
template is relocated to the disk you have chosen, but the original template remains on
the VirtualCenter Server disk. VMware recommends deleting this original after you
have verified that your template upgrade was successful.
86 VMware, Inc.
Chapter 6 Upgrading Virtual Machines
VMware, Inc. 87
Upgrade Guide
88 VMware, Inc.
Appendix: Upgrade Preparation
Checklists
This appendix contains tables detailing components that change in each of the four
upgrade stages. The tables describe the tasks to be completed at each stage and list the
VMware Infrastructure components that are supported at each stage of the tapered.
This appendix contains the following tables:
“Upgrading VirtualCenter Components” on page 90
“Upgrading ESX Server Host” on page 91
“Upgrading File Systems on a Datastore” on page 92
“Upgrading Virtual Machines to VM3 Format” on page 93
“Upgrading Guest Operating Systems with VMWare Tools 3” on page 94
VMware, Inc. 89
Upgrade Guide
Server 1.x Task: Remove from service.
Client 2.5 Task: Install in Stage 1.
Server 2.5 Task: Install in Stage 1.
Issues: Access database is not supported.
WebCenter Task: Install in Stage 1.
Issues: Runs virtual machines with limited functionality.
Oracle database No change.
SQL database No change.
Access database Task: Remove from service.
Microsoft SQL Server Task: Install in Stage 1 (optional).
2005 Express database
VMFS2 volumes No change.
VM2 virtual machines No change.
VMDK2 virtual disk No change.
ESX Server MUI No change.
VMware Tools 2.5 No change.
VMFS3 volumes Not supported in this environment.
VM3 virtual machines Not supported in this environment.
VMDK3 virtual disk Not supported in this environment.
VMware Tools 3.x Not supported in this environment.
90 VMware, Inc.
Appendix: Upgrade Preparation Checklists
Server 1.x Not supported in this environment.
Client 2.5 No change.
Server 2.5 No change.
WebCenter No change.
Oracle database No change.
SQL database No change.
Access database Not supported in this environment.
MSDE database No change.
VMware Tools 2.5 No change.
VMware, Inc. 91
Upgrade Guide
Server 1.x Not supported in this environment.
Client 2.5 No change.
Server 2.5 No change.
WebCenter No change.
Oracle database No change.
SQL database No change.
Access database Not supported in this environment.
MSDE database No change.
VMFS2 volumes Task: Upgrade all datastores to VMFS3 in this stage.
Issues: Read‐only allowed from ESX Server 3.x hosts.
VM2 virtual Issues: Supported with limited operations, such as
machines power‐on, power‐off, suspend, resume and relocate
(migrate).
VMDK2 virtual disk Issues: Virtual disk files on VMFS2 remain in the VMDK2
format
VMware Tools 2.5 No change.
VMFS3 volumes No change.
VM3 virtual No change.
machines
VMDK3 virtual disk No change.
VMware Tools 3.x No change.
92 VMware, Inc.
Appendix: Upgrade Preparation Checklists
Server 1.x Not supported in this environment.
Client 2.5 No change.
Server 2.5 No change.
WebCenter No change.
Oracle database No change.
SQL database No change.
Access database Not supported in this environment.
MSDE database No change.
VMFS2 volumes Not supported in this environment.
VM2 virtual machines Task: Upgrade to VM3 format in this stage.
VMDK2 virtual disk Not supported in this environment.
VMware Tools 2.5 No change.
VM3 virtual machines No change.
VMDK3 virtual disk No change.
VMware Tools 3.x No change.
VMware, Inc. 93
Upgrade Guide
Server 1.x Not supported in this environment.
Client 2.5 No change.
Server 2.5 No change.
WebCenter No change.
Oracle database No change.
SQL database No change.
Access database Not supported in this environment.
MSDE database No change.
VMFS2 volumes Not supported in this environment.
VM2 virtual machines Not supported in this environment.
VMDK2 virtual disk Not supported in this environment.
VMware Tools 2.5 Task: Upgrade to VMware Tools 3.x in this stage.
VM3 virtual machines No change.
VMDK3 virtual disk No change.
VMware Tools 3.x No change.
94 VMware, Inc.
Index
Numerics DRAC 65
530 Please Login with USER and
PASS 51 E
end user license agreement 74, 76
B ESX Server
backup strategies 16 upgrade support 61
block size, restrictions for VMFS3 19, 78 esxupdate 77
boot loader EULA 74, 76
grub 72
location 75 G
record 75 grub, boot loader 72
GSX Server virtual disks, using with ESX
C Server 87
cd test 71
I
D IDE disks 66
Database Upgrade wizard 57 ILO 65
databases 51 in-place upgrades 21, 24
debug mode 67 iSCSI disks 65
disks
GSX Server 87
K
local 21, 25, 40 keyboards 71, 74
partitions 72
M
persistent mode 22, 67
master boot record 75
RAID 65
media test 71
RAW 68
Microsoft Access database
SATA 65
migrating 56
SCSI 65
migration upgrade 21, 24
shared VMFS 26
mouse 72
virtual 20, 26, 39, 45, 67
VirtualCenter 86 N
VMDK 90
NFS mounts, restoring after upgrade 67
Workstation 87
VMware, Inc. 95
Upgrade Guide
P stage 3 28
PCI devices, allocating 67 stage 4 30
ports support 49, 61
80 51 templates 86
preupgrade script 18, 70 VI Client 90
virtual hardware 81, 93
R virtual machines with RAW disks 68
RSA II 65 VirtualCenter 90
VirtualCenter database 51, 55
S VirtualCenter Server 54
SANs 65 VMFS2 to VMFS3 27, 78, 92
SAS disks 66 VMware Tools 82, 94
SATA disks 66 use cases 31, 33, 43
scenarios 31, 33, 43
scripts 76 V
SCSI disks 65, 66 virtual machines
SDK 13 downtime during upgrade 18
supported upgrades VM2 virtual machine format 20, 81
ESX Server 61 VM3 virtual machine format 20, 81
VirtualCenter 49 VMFS2 19
VMFS3 19
T block size 19, 78
tarballs 76 VMware architecture, changes to 19
TCP/IP 51 VMware Tools, upgrading 82
templates, upgrading 86
test, media 71 W
Windows 2000 Server SP4 55
U Workstation virtual disks, using with ESX
upgrade requirements, ESX Server 64 Server 87
upgrade scenarios 31, 33, 43
upgrade VMotion 21
upgrade.pl 76
upgrading
ESX Server 27, 69, 91
ESX Server hosts with a SAN 26
ESX Server hosts with local
disks 25
stage 1 24, 90
stage 2 25, 91, 92
96 VMware, Inc.
Updates for the Upgrade Guide
Last Updated: February 13, 2009
This document provides an update to the Update 2 release for ESX Server 3.5,
ESX Server 3i version 3.5, and VirtualCenter 2.5 version of the Upgrade Guide. Updated
descriptions and procedures are organized by page number so that you can easily
locate the areas of the guide that have changes. If the change spans multiple sequential
pages, this document provides the starting page number only.
The following is a list of updates to the Upgrade Guide:
Update for the Minor Upgrades Section on Page 40
Update for the Scenario 6: Upgrading Hosts on a SAN Using VMotion with DRS
and HA Section on Page 41
Update for the Scenario 5: Upgrading Hosts on a SAN with DRS and HA Section
on Page 46
Update for the Table of Supported Database Formats on Page 52
Update for the Procedure To Install or Upgrade VMware Tools in Multiple Virtual
Machines on Page 83
If you can accept some degradation of virtual machine availability, disable strict
admission control, perform ESX Server upgrades, then re‐enable strict admission
control.
If you must ensure that all virtual machines remain available during the
ESX Server upgrade, add another host to the cluster, thereby adding more capacity.
This allows the software to perform migrations of virtual machines without
violating strict admission control.
HA strict admission control is enabled by default. You can disable it in the VI Client by
opening the HA section of the cluster’s Settings dialog box and selecting Allow VMs to
be powered on even if they violate availability constraints.
If you can accept some degradation of virtual machine availability, disable strict
admission control, perform ESX Server 3i host upgrades, then re‐enable strict
admission control.
If you must ensure that all virtual machines remain available during the
ESX Server 3i upgrade, add another host to the cluster, thereby adding more
capacity. This allows the software to perform migrations of virtual machines
without violating strict admission control.
HA strict admission control is enabled by default. You can disable it in the VI Client by
opening the HA section of the cluster’s Settings dialog box and selecting Allow VMs to
be powered on even if they violate availability constraints.
Oracle Database 10g Release 2 (10.2.0.1.0) Apply patch 10.2.0.3.0 to the client and server and
Standard Edition then apply patch 5699495 to the client.
Oracle Database 10g Release 2 (10.2.0.1.0) Note: VMware supports 10.2.0.3.0 and later
Enterprise Edition versions of Oracle Database 10g Release 2.