Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Extending the default timeout periods for vCenter Server, ESX/ESXi hosts, and vCenter Update Manager (1017253)

Details

The default timeout value for tasks performed and managed by VirtualCenter / vCenter Server is 15 minutes. If you run an Update Manager host task, such as scanning or remediating an ESXi/ESX host, the task may time out or fail if it takes more than 15 minutes to complete.

Any of these factors can cause such a timeout or failure:
  • The task takes more than 15 minutes to complete.
  • A slow connection between the vCenter Server and the ESXi/ESX host.
  • A network environment with low bandwidth, high latency, or in which packets are lost.
  • Conditions that prevent the task from completing within the default 15 minute time frame.

Solution

To resolve this issue, you can increase the vCenter Server and ESXi/ESX host timeout values. Three hours (10800 seconds) is generally sufficient, but in some environments, you might need to increase the timeout values to a longer period.

Increasing the vCenter Server timeout value

To increase the vCenter Server timeout value:
  1. Log in to your vCenter Server with administrator privileges.
  2. Back up the vpxd.cfg file. The default location is:
    • For Windows-based vCenter Server:
      • Windows 2003: C:\Documents and Settings\All Users\Application Data\VMware\VMware VirtualCenter\vpxd.cfg
      • Windows 2008: C:\ProgramData\VMware\VMware VirtualCenter\vpxd.cfg

    • For the vCenter Server Virtual Appliance: /etc/vmware-vpx/

  3. Open the vpxd.cfg file in a text editor.
  4. Paste these lines before the </config> tag:

    Note: If the vpxd.cfg file already has a section for the <task> tag, place the <timeout> edit in the existing <task> section to avoid duplicate section tags. If you have duplicate section tags, the VMware VirtualCenter Server service may not start.

    Caution: Do not make other changes to the configuration file.

    <task>
    <timeout>10800</timeout>
    </task>
    <vmomi>
    <soapStubAdapter>
    <blockingTimeoutSeconds>10800</blockingTimeoutSeconds>
    </soapStubAdapter>
    </vmomi>


  5. Restart the VMware VirtualCenter Server service. For more information, see:

    For the Windows-based vCenter Server: Stopping, starting, or restarting vCenter services (1003895)
    For the vCenter Server Virtual Appliance: Stopping, starting, or restarting vCenter Server Appliance services (2054085)

Increasing the ESXi/ESX timeout value

To increase the ESXi/ESX timeout value:
  1. Log in to your ESXi/ESX host with root privileges using the console or an SSH session. For more information, see:


  2. Back up the vpxa.cfg file.

    • The default path is /etc/opt/vmware/vpxa/vpxa.cfg
    • For ESXi 5.0, the default path is /etc/vmware/vpxa/vpxa.cfg

  3. Open the vpxa.cfg file in a text editor.
  4. Paste this line between the <task> and</task> tags:

    Caution: Do not make other changes to the configuration file.

    <timeout>10800</timeout>

  5. Paste these lines between the <vmomi> and </vmomi> tags:

    <soapStubAdapter>
    <blockingTimeoutSeconds>10800</blockingTimeoutSeconds>
    </soapStubAdapter>


  6. Restart the management services on your ESXi/ESX host. For more information, see Restarting the Management agents on an ESX or ESXi Server (1003490).

Increasing the timeout value in Update Manager 4.0 Update 2

In Update Manager 4.0 Update 2 and later, the default timeout period is 40 hours. You can change the default 40-hour timeout period using the <PatchTaskTimeoutSeconds> tag in the vci-integrity.xml file.

Note: The <PatchTaskTimeoutSeconds> tag is not present in earlier versions of Update Manager.

  1. Log in to the machine where Update Manager server is installed with administrator privileges.
  2. Back up the vci-integrity.xml file.

    • The default path in 32-bit Windows is C:\Program Files\VMware\Infrastructure\Update Manager
    • The default path in 64-bit Windows is C:\Program Files(x86)\VMware\Infrastructure\Update Manager

  3. Open the vci-integrity.xml file in a text editor.
  4. Set the timeout value in the <PatchTaskTimeoutSeconds> tag:

    <PatchTaskTimeoutSeconds>timeout_value_in_seconds</PatchTaskTimeoutSeconds>

    Caution: Do not make other changes to the configuration file.

  5. Restart the Update Manager service:

    1. In Windows, click Start > Run.
    2. Type services.msc and press Enter.
    3. Right-click VMware Update Manager Services and click Restart.
    4. Wait for the service to restart.
For more information about the time required for host operations, see Update Manager host task might fail in slow networks (1021050).

Update History

04/15/2010 - Added path to vpxd.cfg on Windows 2008. 02/08/2013 - Added path for ESXi 5.0 03/29/2013 - Added ESXi 5.1 and vCenter Server 5.1 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.

Feedback

  • 20 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)
  • 20 Ratings
Actions
KB: