Home > Blogs > Support Insider > Monthly Archives: December 2010

Monthly Archives: December 2010

Changes to Snapshot Consolidation

Another guest post today from Simon Todd, who is a Tech Support Engineer in our Cork, Ireland office who specializes in Storage issues.

Anyone using snapshots has probably run into this issue once, twice or many times:

When trying to perform an online consolidation there is not enough space on the Datastore to perform the consolidation.

This is mainly due to the way snapshots are consolidated. To illustrate this, let’s look at an example where we have a virtual machine residing on a 600Gb VMFS Datastore that has a 500Gb base disk, and that virtual machine has 8 levels of snapshots of the following sizes:

As you can see we are consuming an additional 64Gb on top of the original base disk leaving us at risk to run out of space on the Datastore. The logical thing to do is consolidate these snapshots. So what happens if we consolidate these?  Well, prior to vSphere 4.0 Update 2 the snapshot consolidate process would take the latest snapshot, merge that into the previous snapshot, then merge that combined snapshot and merge it into the previous one, and so on and so forth until complete.

If each of the snapshots contains unique changes that do not exists in previous snapshots then the following diagram would illustrate the worst case scenario for Datastore usage:

As you can see there’s a potential for the snapshot consolidate process to consume 153Gb more than your Datastore allows. This process has been the same all the way back from when the snapshot process was first introduced.

vSphere 4.0 Update 2 changes

As of vSphere 4.0 Update 2 the snapshot consolidation operation has changed, instead of rolling the snapshots into each other, the snapshot process now takes the oldest snapshot and consolidates that into the base disk, removes the snapshot and then processes the next oldest snapshot and merges that into the base disk, so after all the snapshots are consolidated into the base disk they are removed. This not only saves on required disk space, but it also performs better:

Best Practices for licensing ESX 3.x hosts which are being managed by Virtual Center 4.x

Today we have a guest post from Ganesh Shetty, who is a Tech Support Engineer in our Bangalore office who specializes in Licensing issues. He’s currently focused on writing Knowledgebase articles. Today, he brings us some good advice advice in minimizing licensing headaches.

If you previously used Virtual Infrastructure 3, you may remember using license files to license ESX hosts. Although vSphere 4 does not use license files, this does not apply if you are managing ESX 3.x hosts using virtual center 4.x, as most of you may know. We still have a lot of customers using a mixed environment, comprising of ESX 3.x, ESX 4.x hosts managed by Virtual Center 4.x. This introduces some challenges in licensing the Environment.

There are several errors associated with an improperly licensed ESX 3.x host managed by a Virtual Center 4.x. In this post, I will be discussing a few steps to keep in mind when licensing ESX 3.x hosts being managed by a Virtual Center 4.x and I’ll also give you a few tips to fix errors related to this.

License files in place

The first and foremost step is to ensure that your license files are in place. Quite often the source of a lot of licensing issues is a corrupt license file. When in doubt about a license file, it is always better to delete and regenerate that license file. You can refer the knowledge base article Creating a Single Host and Centralized License file on the License Portal (1005132) for a detailed explanation on how to generate server based license files.

If regenerating the license file is not an option, you can check if the license file is valid or not by pasting its content in the server based license checker . Open the URL: http://www.vmware.com/checklicense/ and paste the contents of your license file, in the empty box. Click on validate.

This will tell you if the license file is valid or not. You need not be including a virtual center 2.x license file since you are using virtual center 4.x, so you may get an error message ‘No VC Management License found’ when validating the license file. This error can be ignored. The screenshot below indicates a valid instance of an Enterprise license file for 2 processors.


  • If you generate a VI3 Enterprise license, you will not see the option ‘Enterprise’ in the server based license checker. Instead you see 2 Standard + 2 vMotion +2 DRS + 2 HA + 2 VC Agent + 2 VCB licenses.
  • The license checker can only be used to validate ‘Server based’ license files and not ‘Host based’ license files.


It is always recommended to not modify the contents of a license file. Manual consolidation of many license files into one file is possible, however, if done incorrectly, can corrupt the license file. As seen in the screenshots below, this license file is corrupt and will certainly give you an error when licensing the host. In such a scenario you must regenerate the license file.

You can also refer the knowledge base article Troubleshooting an error when uploading a license file (1005440) for additional causes of an invalid license file.

The license file is coded in UNIX and contains a number of stanzas which starts with ‘INCREMENT’. The header which follows the word ‘INCREMENT’ indicates the license type (e.g. Foundation, Standard, Enterprise etc.) and the quantity. It is helpful to understand these headers and what they denote. This will come in handy when performing a ‘Status Enquiry’ in the license server. I’ll show you how it is done later in this post.

The KB article Understanding VI3.5 Licensing: Server- and Host-Based Licensing Models (1003295) provides a detailed explanation on what these headers denote in a license file. I have listed a few important ones to keep in mind

· INCREMENT VC_ESXHOST VMWARELM 2005.05 permanent 2 :

2 processors of Virtual Center Agent

· INCREMENT VC_VMOTION VMWARELM 2005.05 permanent 2 :

2 processors of vMotion

· INCREMENT VC_DAS VMWARELM 2005.05 permanent 2 :

2 processors of High Availability

· INCREMENT VC_DRS VMWARELM 2005.05 permanent 2 :

2 processors of DRS


2 processors of Standard


2 processors of VCB


2 processors of Foundation

After you have ensured the license file is valid, save the license file with a .lic extension.

Installing the License Server

If you have already installed the license server and need to upload the license file, simply follow steps 1 to 9 in the KB article Installing Licenses for ESX Server 3.x (1001383)

After you have generated (and saved a copy) of your license file, ensure you have downloaded the license server. The standalone version of the License server is available for download in the VI3 download section. When installing the license server for the first time, you are asked to browse to the source of the license file. Point to the location of the license file and complete the installation.

There have been reported issues of the standalone version of the license server not installing in Windows Server 2008. If you run into this, follow the KB article Unable to install the license server on Windows Server 2008 (1018118) to obtain a workaround.

After uploading the license file to the license server, it is recommended you restart the license server by clicking on Stop Server, Start Server and Reread License File, in the order shown here:

There are some occasions where you get the error message ‘cannot stop the server’ after clicking on Stop Server and subsequently the error message ‘Cannot ReRead license file’ when you click on ReRead License File. In such situations, reinstallation of the license server will fix the issue.

vCenter Server Settings

After the license file has bee
n reread successfully, Login to the virtual center using vSphere Client. Click on Home, vCenter Server Settings and ensure that you have entered the IP address or the name of the machine where the license server is installed. It is also necessary that you check the option Reconfigure ESX 3 hosts using license servers to use this server.

Note: Please ensure that the Virtual Center 4.x is licensed with a valid license key.

To license the ESX 3.x host follow steps 14 and 15 in the KB article Installing Licenses for ESX Server 3.x (1001383) . Finally, ensure that the ESX host is pointing to the correct IP address/name.

If you still get an error not enough licenses, check if the licenses available is greater than or equal to the processor socket count of your ESX 3.x host. This can be done by clicking on Configuration, Processors (Under Hardware) and look at the count next to Processor Sockets

In odd instances I have noticed that there will be sufficient licenses but the ESX 3.x host has not picked up the licenses from the license server. In such scenarios you can check if the issued license files have been assigned or not. This can be done by clicking on Server Status on the license server and then clicking on Perform Status Enquiry

As previously mentioned above, headers in the license file denote the license type and also its quantity. In the above screenshot, it indicates that the licenses and its various features have been issued but not assigned to the ESX 3.x host. This is a good indicator as to why you get an error ‘Not Enough Licenses’ despite having sufficient licenses. Sometimes, only one feature may show up as ‘not assigned’ while the other features may have successfully been assigned to the ESX host. For example VC_ESXHOST (VC Agent) may show up as ‘not assigned’. This means that the ESX host is not able to pick the VC Agent licenses and hence will not allow you to add the ESX host to the Virtual Center (since VC Agent licenses are required to add an ESX host to the Virtual Center) by throwing up an error ‘Not Enough Licenses’.

To fix this, restart the license server from Services.msc. The licenses will start reassigning themselves from scratch and whatever feature was not assigned will be successfully assigned by the license server.

Many KB articles have been referenced here, an they’re all well worth checking out when you have licensing problems.

How to configure vCloud Request Manager

Another straight forward, to the point video. This video discusses and demonstrates how to configure VMware vCloud Request Manager using the initial configuration wizard.

For more information refer to the full Knowledgebase article: Installing VMware vCloud Request Manager (1031100)

How to install vCloud Request Manager

The title says it all here. This video discusses and demonstrates how to install VMware vCloud Request Manager.

For more information refer to the full Knowledgebase article: Installing VMware vCloud Request Manager (1031100)

How to divide and combine vSphere license keys

Here’s a common question our Licensing folks get: How to divide or combine your vSphere license keys.

This video discusses and demonstrates how you can divide and combine vSphere license keys using the online Licensing Web Portal. The video describes the process involved in both dividing and combining the license keys and it also explains some key points of information that you need to be aware of when performing these license administration tasks.

How to download and submit a VMware Account Change Form (ACF)

This video discusses and shows you where the Account Change Form (ACF) can be downloaded, how to fill it out correctly, and how to submit it to VMware.

The video also provides a breakdown of the different pieces of information you need to have and be aware of when filling out the Account Change Form.


VMware allows changes to Customer Accounts in these instances:

  • Where customer has changed their name, excluding as a result of a merger or acquisition, and their old name no longer exist.
  • Due to a spelling error
  • Reseller errors more than 30 calendar days from order date (where Reseller ordered licenses directly from VMware)
  • Reseller errors where Reseller ordered licenses from OEM Partner

For all of these situations, complete the VMware Account Change Form (ACF) .

Purpose-built guest OS datastores – Don’t do it!

Today we have a guest post from Duncan Armstrong, who is a Tech Support Engineer in our Canadian office who specializes in Fault and Storage issues. He’s currently focused on writing Knowledgebase articles as we want to capture as much real-world troubleshooting know-how as possible and share it with everyone. Today, he wants to give us some advice.

Since joining VMware Technical Support several years ago, I have frequently found myself pondering the decision making processes behind some of the various storage configurations that have been employed in VMware Infrastructure/vSphere environments. One particular configuration came up more often than I liked, and while unfortunate, it was hardly surprising to see these deployments/configurations result in unplanned outages or even impact recovery efforts. The version of ESX didn’t matter, nor did the type of storage used (NAS/SAN, iSCSI or FC). This issue did not discriminate any particular technology or branding. It seemed to punish those who preferred to organize their datastores in such a fashion.

I’ll get to the point: Dedicated Guest Operating System datastores are not a good idea, no matter how organized they may appear to be. The same sentiment can sometimes be shared with dedicated Data Disk datastores.


What? Why are these used?

I have the impression these “split” configurations—dedicated Guest OS datastores and Data Disk datastores—were created more for virtual machine file organization, than for performance or even space optimization. Customers with these setups do know very well where their guests and configuration files are (Guest OS Datastore), and where all their data drives are (their remaining Data Datastores). However deployments or consultations that push for this kind of setup are really quite wrong or misinformed.

There are a several ways these configurations can result in problems.

Event and time-based load spikes

After an outage or problem, the upswing of bringing your guests back online is going to take a longer amount of time; all of the reads and writes required for the mass startups are isolated to the few Guest OS Datastores that reside on your storage. Expect load to be maximized until all the guests have completed their startup sequences.

Once these operating systems are up, your guest system drive loads will start to drop, and likely begin to rise from the production data disks. The latter is really quite fine, but the former may translate into extended startup times following an outage.

System disks aside, having too many production-load guest Data disks on a single datastore would likely result in similar performance problems during production hours and especially backup schedules. Or you may see a consistent performance decline as a result of overloading a given disk set throughout your uptime.

I also see some customers dedicate an entire datastore for single virtual machine disks, configuring for a one Datastore to one Guest Data Disk ratio setup. This is also suboptimal and wastes space; delta files are not stored on these locations. The space left on each Data Disk Datastore is never utilized. That may not necessarily be a problem if you planned for it, but you’re also unnecessarily consuming more LUN ID numbers (if you are using VMFS or SAN storage). ESX supports up to 256; check VMware documentation, or specifically the Maximums and Limitations document for more information: Configuration Maximums for VMware vSphere 4.1.

Note: Thin-provisioned disks in vSphere are an exception; they start small and grow over time.

Over-commitment of ESX Server memory results in the utilization of existing Virtual Machine Swap (.vswp) files, which by default reside in the same directory as your virtual machines’ configuration files/directories. Having all your virtual machines across multiple hosts require heavy read/write activity on a common LUN won’t likely be a good experience.

Unexpected space consumption

Like the last point above, you may or may not already expect Virtual Machine Swap (.vswp) files to be created, consuming additional Guest OS Datastore space after virtual machine power-on (1:1 space required to virtual machine memory allocation. An 8GB RAM virtual machine uses an 8GB .vswp file unless if you set up memory reservations). Powering on 20+ Guest OSes with 4GB of memory each on the same datastore results in 80GB of virtual machine swap files being created.

The real killer in these setups is when snapshotting a virtual machine. Each virtual machine disk’s delta file (redo log) is created in the same directory as the virtual machine’s configuration file/directory, much like the .vswp file, above. A titular "OS Datastore" in these storage configurations, by role, effectively contains all of the delta files at once. This quickly becomes a problem, where such a datastore is usually fairly small to begin with (to save room on the SAN/NAS for "Data," of course).

With the actual data virtual disks sitting quite large, and commonly showing demanding performance and space consumption characteristics (the latter is due to increased additional delta/redo logging), they often cause the complete exhaustion of storage space on the "Guest OS Datastore," where the deltas are created and grow, to accommodate for disk changes. Of particular note are delta disks for databases or other "volatile" virtual machines where a lot of delta in a short time frame is going to be created. Datastore space exhaustion results in an outage for every virtual machine that continues to require additional space on the affected datastore. They cannot resume until there is additional space.

Space exhaustion while on snapshots is a common call-generator when this setup is used. Addressing these issues is somewhat trivial for VMware, but is largely demanding on expertise, familiarity with how snapshots function, and really, just thinking on your feet.


Please avoid this storage configuration. If you already have one like this, think about how you can start spreading out your operating system disks, even just a bit more. Mixing up the OS and Data disks isn’t inherently a Bad Thing, generally speaking, but there are always exceptions to the norm out there. So understand what you’re storing, their usage characteristics, and spread out your loads (even across a given day).

Further, by having some room to spare on each of your datastores (nothing is too tight and nothing is over-utilized now, right?), you have some breathing room later if, for any reason, you run into problems. Something I like to be able to anticipate is a mass exodus of all virtual machines from a datastore to my remaining ones. Do I have capacity for this? Or how about: Can I clone the largest virtual machine I have and put it on one or more destination datastores, in the event of an emergency?

I hope that helps a bit, or at least gives you some ideas. Or even more ideally, comfort you in the decisions you have already made to avoid this kind of setup. Don’t get caught setting something like this up. Yes, it will work fine if you avoid using features like snapshots (and accept the performance quirks/behaviors), but it could be done better, and with less effort.

New articles published for week ending 12/18/2010

SUSE Linux Enterprise Server (SLES) for VMware
Error when attempting to update SUSE Linux Enterprise Server (SLES) for VMware: No update repository configured (1031668)
Date Published: 12/15/2010

VMware Consolidated Backup
File level backups fail if a BCD store exists on the Windows 2003 virtual machine (1031734)
Date Published: 12/17/2010

VMware Data Recovery
VMware Data Recovery backups do not start on time (1019139)
Date Published: 12/14/2010

VMware ESX
What is the syntax for vmware-cmd createsnapshot? (738107)
Date Published: 12/16/2010
Poor disk write performance to VMFS filesystems (1001793)
Date Published: 12/15/2010
ESX 3.0 encounters an exception type 0 purple diagnostic screen (1004083)
Date Published: 12/15/2010
How to create a VMware Data Recovery backup on an external location (1014785)
Date Published: 12/14/2010
The vix-async-pipe process in an ESX 4.x host is using high CPU in the service console (1030894)
Date Published: 12/15/2010
Running the esxupgrade.sh script fails with the error: too many arguments given (1031254)
Date Published: 12/18/2010
VMware support for the StorMagic iSCSI Storage Virtual Appliance (SvSAN) (1031319)
Date Published: 12/13/2010
Poor performance and high disk latency with some storage configurations (1031773)
Date Published: 12/16/2010
VMware ESX/ESXi 4.1 host with Broadcom bnx2x driver version 1.60.50.v41.2 experiences intermittent loss of network connectivity on HP Blades with Virtual Connect (1031805)
Date Published: 12/17/2010
Datastore creation error: VmkfsLib_ScanAdapter: Failed to do a volume cache rescan Status: 0xbad003f (1008094)
Date Published: 12/16/2010
CPU shows up as Dormant on the Health Status tab (1023032)
Date Published: 12/15/2010
Using ESX installation media for access to virtual machine files (1030778)
Date Published: 12/15/2010
Quiesced snapshots fail for Windows 2008 R2 guests (1030943)
Date Published: 12/15/2010 
Shutting down a Windows 2000 guest fails when the screen saver is active (1031748)
Date Published: 12/17/2010

VMware ESXi
Using vicfg-cfgbackup to reset an ESXi host may result in an SSL read timeout error (1010937)
Date Published: 12/17/2010
SATA/AHCI and ATA/IDE controller support in ESX 4.0 (1013115)
Date Published: 12/13/2010
Virtual machine conversions on ESX/ESXi 4.0 hosts with Broadcom cards are unstable (1031587)
Date Published: 12/15/2010
vMotion fails with the error: problem detected at CPUID level 0×80000001 (1031744)
Date Published: 12/17/2010
Configuration commands added to the %post section of the installation script do not persist in ESXi 4.1 hosts after reboot (1031414)
Date Published: 12/16/2010

VMware ThinApp
Unable to license VMware Thinapp Starter Edition (1031255)
Date Published: 12/13/2010

VMware vCenter Application Discovery Manager
VMware vCenter Application Discovery Manager Windows Collector stops running (1031667)
Date Published: 12/13/2010

VMware vCenter Configuration Manager
Editing an imported filter fails with the error: Index out of Bounds (1029066)
Date Published: 12/15/2010

VMware vCenter Server
Cannot ping or RDP a Windows 7 virtual machine with Wake on LAN enabled (1030415)
Date Published: 12/15/2010
vCenter Service status reports the error: Unable to retrieve health data from https:///converter/health.xml (1031568)
Date Published: 12/17/2010
Defragmenting clusters for VMware High Availability (1031703)
Date Published: 12/13/2010
Installing or upgrading vCenter Server fails with the error: Error 25017 – Set up has detected that there is a system reboot (1015150)
Date Published: 12/17/2010
Email notification not sent after an alarm state returns to normal (1018607)
Date Published: 12/15/2010
VMware vCenter Converter fails at 98% with the error: unable to create (1030145)
Date Published: 12/16/2010
vMotion of a virtual machine fails with error: Insufficient capacity on each physical CPU (1031306)
Date Published: 12/17/2010
VirtualCenter Server service fails to start with the error: Diagnostic server root (<location>) does not exist! (1031720)
Date Published: 12/15/2010
Linking two vCenter Servers that are split from a single vCenter Server 4.x using a copy of the same database fails (1031846)
Date Published: 12/16/2010

VMware vCenter Update Manager
Replacing SSL certificates for VMware vCenter Update Manager (1023011)
Date Published: 12/17/2010

VMware vCloud Director
Changing the MTU size on a VLAN backed network pool fails with the error: Cannot set MTU on vNetwork Distributed Switch which is not enabled for Host Spanning (1031510)
Date Published: 12/17/2010
Powering on a virtual machine or starting a vApp in VMware vCloud Director fails with an Internal Server Error (1031617)
Date Published: 12/17/2010
Virtual machine fails to power on with the error: Code: 70556 (1031618)
Date Published: 12/17/2010

VMware View Manager
Recomposing and refreshing virtual machines fails after adding a new ESX host into a cluster (1018947)
Date Published: 12/16/2010
Dual monitors configured using PCoIP does not span both the monitors (1027899)
Date Published: 12/13/2010
The Event log on the View Connection Server contains the error: Problem processing HTTP connection (1020304)
Date Published: 12/16/2010
Troubleshooting Conflicting vCenter Unique IDs (1029897)
Date Published: 12/16/2010

VMware Virtual Desktop Manager
Removing cached user logins from View desktop sessions (1017992)
Date Published: 12/16/2010
Pool Creation fails with a No datastores found error (1021813)
Date Published: 12/13/2010

VMware vShield Manager
Error when viewing the vShield tab of an ESX host in vSphere Client: Operation for this portgroup is not supported (1031400)
Date Published: 12/13/2010

VMware vSphere CLI
About the -Start parameter in the Get-VIEvent cmdlet (1030958)
Date Published: 12/16/2010

VMware vSphere Web Services SDK
MAC address for a host in a Distributed Virtual Switch environment (1030957)
Date Published: 12/16/2010

2 must-have VMware Tech Support tools

This serves as a reminder to many, but new readers of this blog should take notice of two tools we’ve created that extend our Knowledgebase beyond the traditional web site.

VMware Toolbar

First announced here, our browser toolbar gives you:

  • Instant access to patches, documentation, and more.
  • Built-in RSS and Twitter updates direct from Tech Support.
  • Custom search capabilities (be sure to try!).

Two versions:

  1. Click here if you use VMware Datacenter products mostly (vSphere, View, ESX)
  2. Click here if you use VMware Desktop products primarily (Workstation, Fusion)

VMware KB Mobile App

Announced back in November, our Mobile App works on any HTML5 capable smartphone. That’s iPhone and Android for sure, and more are being added each day.

Our VMware KB app gives you the ability to:

Here’s how the toolbar looks in Safari. Notice we just clicked the ‘Mobile App’ button. Up pops a window with everything you need to get the mobile app on your phone!  You can SMS the app to yourself, email it, or scan the QR code and voila!

What other tools would you like to see from the support guys?

Predictive Search – would you like it?

We’d like your input on this one. We are contemplating a new feature for the next update to the VMware Knowledgebase called Predictive Text. The idea is that as you type in your search criteria, a list is dynamically generated from the system that predicts what it is that you are searching for, based on the content we have on the search phrase.

We’ve found from our usage stats that most searches using the KB search are vague and single-termed, and many customers use web searches such as Google, which have this feature, instead of the built-in KB search.

Below we have included a mock-up of how this could look.  In this example I have typed in the words ‘vmotion fails’. As I typed in the words, the list updates in real-time.

Which approach do you think makes more sense?

What you see below are actually KB article titles. You can select any one you wish, and a search is performed on the terms in that title phrase. Article title is only one choice we have for how to populate this list. We could instead draw from a stack of common search terms. We’re going to need to decide how to implement this. How would you approach this?

We want your input!

  • Take out quick Poll! Is this a feature you want?
  • Add your comments in the form below