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

ESXi hosts without swap enabled cannot be added to a VMware High Availability Cluster (1004177)

  • 30 Ratings


  • ESXi hosts that do not have swap enabled cannot be added to a VMware High Availability (HA) cluster.
  • You may see the error:

    cmd addnode failed for primary node: Internal AAM Error - agent could not start


Starting with VirtualCenter 2.5 Update 1, only ESXi systems with swap enabled can be added to an HA cluster. ESXi systems with swap not enabled cannot be added to HA clusters, and display an error message similar to the following: 
An error occurred during configuration of the HA agent of the host.
The Tasks & Events page of such a ESXi system describes the error with a description similar to the following: 
HA agent has an error : Host in HA Cluster must have userworld swap enabled
To enable swap on your ESXi host system:
  1. On the VirtualCenter Server, select the ESXi host.
  2. Click the Configuration tab.
  3. Click Advanced Settings.
  4. Choose ScratchConfig.
  5. Configure ScratchConfig.ConfiguredScratchLocation to a valid directory with sufficient space (1GB) to hold the userworld swap file. The userworld swap can be configured on local storage or shared storage.

    Note: Each swapfile needs a unique name across all ESX hosts. The path must exist before changing the scratchconfig setting. You can create this directory with the datastore browser.

    For example, /vmfs/volumes/<DatastoreName>.

  6. Select the ScratchConfig.ConfiguredSwapState option.
  7. Click OK.
  8. Reboot the ESXi system.
After you have enabled swap on the ESXi host system, you can add the host to a VMware HA cluster.
Note: This solution also applies for Update 2.


ha-host-failure  configuring-ha-fails  enable-ha

Update History

03/05/2011 - Added ESXi 4.x and vCenter Server 4.x to Products

Request a Product Feature

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


  • 30 Ratings

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

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

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