the guest os has reported an error during quiescing. the error code was 3 in linux machines


Snapshot quiescing fails on Linux guests

  • Linux based virtual machines fail to take quiesced snapshots after upgrading ESXi and VMware Tools to 5.1.
  • Using the vSphere Client to take a quiesced snapshot fails immediately with the error:

The guest OS has reported an error during quiescing. The error code was: 3 The error message was: Error when enabling the sync provider.

  • The hostd.log of the host running the virtual machine contains errors similar to:

[3CB9EB90 verbose ‘vm:/vmfs/volumes///.vmx’] Handling message _vmx##: The guestOS has reported an error during quiescing.
–> The error code was: 3
–> The error message was: Error when enabling the sync provider.

Cause

This issue occurs due to a problem with the FIFREEZE/FITHAW ioctl feature within the guest that is utilized to quiesce the Linux filesystem, affecting kernel 2.6.32-24 and lower.

Resolution

To resolve this issue, update the kernel of your Linux guest virtual machine to 2.6.35-22 or higher.

To work around this issue without updating the kernel:

  1. Open the tools.conf file, located in the /etc/vmware-tools directory, using a text editor.

Note: If the tools.conf file does not exist, create a new, empty file.

  • Add these lines to the file:

[vmbackup]
enableSyncDriver = false

About Alex Hunt

Hi All I am Manish Kumar Jha aka Alex Hunt. I am currently working in VMware Software India Pvt Ltd as Operations System Engineer (vCloud Air Operations). I have around 5 Years of IT experience and have exposure on VMware vSphere, vCloud Director, RHEL and modern data center technologies like Cisco UCS and Cisco Nexus 1000v and NSX. If you find any post informational to you please press like and share it across social media and leave your comments if you want to discuss further on any post. Disclaimer: All the information on this website is published in good faith and for general information purpose only. I don’t make any warranties about the completeness, reliability and accuracy of this information. Any action you take upon the information you find on this blog is strictly at your own risk. The Views and opinions published on this blog are my own and not the opinions of my employer or any of the vendors of the product discussed.
This entry was posted in Vmware. Bookmark the permalink.

3 Responses to the guest os has reported an error during quiescing. the error code was 3 in linux machines

  1. S says:

    The resolution you are offering only works because it disables the quiescing.
    After setting syncdriver to false the backups are only crash consistent

    Like

    • Alex Hunt says:

      The other option can be upgrading the Linux kernel if you dont want to set syncdriver to false. Every environment has different mechanism for taking the VM backups, so it is not necessary that backup will crash for every software.

      Like

  2. S says:

    There doesn’t seem to be a kernel update high enough to solve this with centos 6.7
    The problem seems to be related to FIFREEZE/FITHAW ioctl in the kernel.
    I’m trying to determine whether disabling syncdriver (VMware quiescing module) actually solves the conflict and the quiescing is handled correctly by Linux kernel.
    Or if quiescing really is disabled completely.

    Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s