Launching soon: The world's first vendor agnostic bug scrubLearn more & join waitlist
OPERATIONAL DEFECT DATABASE
...
...
Unable to power on the virtual machine Powering on the virtual machine fails You see one of these errors: A file was not found. Operation not allowed in the current state The <vmname>.vmdk file does not exist, but the <vmname-flat>.vmdk file exists. Deleting snapshot fails with the error:ASSERT /build/mts/release/bora-39823/bora/vmx/snapshot/snapshot_vmx.c:752 VMFS volume becomes inaccessible due to file system corruption
This article describes the various files that make up a virtual machine running on an ESX host. It also provides information on how the integrity of these files may be compromised and the various means of resolving the resulting problems.
Types of files Before ensuring virtual machine file integrity, be aware of the various files that make up a virtual machine running on an ESX host. VMX File The VMX file is the primary configuration file of a virtual machine. Every aspect of your virtual machine is detailed in the VMX file, and any virtual hardware assigned to your virtual machine is present here. Here is an example entry for a virtual floppy drive: floppy0.startConnected = "false"floppy0.clientDevice = "true" Each time you create a new virtual machine using the New Virtual Machine Wizard, the VMX file is appended to with each question you answer regarding the guest operating system, disk sizes, and networking. VMXF File This is a supplemental configuration file for virtual machines. VMDK and -flat.VMDK Files The <vm_name>-flat.vmdk files store the content of the virtual machines actual hard disk drives. Earlier versions of ESX used the extension .dsk for the virtual disk files. The <vm_name>.vmdk files are the disk descriptor files. This file contains all the information about the associated flat file. VMDK Delta Files The <vm_name>-######.vmdk files store the content of the virtual machines disk from the time the snapshot was created. The <vm_name>-######-delta.vmdk files are the disk descriptor files. This file contains all the information about the associated delta flat file. The files tell you the CID of the file, the parent CID of the file, and the type and size of the file amongst other things. This information can be very useful depending on what type of issue you are troubleshooting. It is especially useful when troubleshooting problems with snapshots. VMSD File This is a centralized file for storing information and metadata about a snapshots of a virtual machine. VMSN File This is the file which stores the state of a snapshot. NVRAM File This file contains the BIOS of the virtual machine. Log Files The vmware(-x).log files keep a log of key virtual machine activity. This file can be useful in troubleshooting if you encounter problems. Renaming a virtual machine Renaming your virtual machine can create inconsistencies that can cause issues. To correctly rename a virtual machine: Note: Avoid spaces, brackets, or non UTF-8 characters when naming virtual machines and their associated files. Commit any snapshots. Shutdown the virtual machine. If you are using vCenter Server, remove the virtual machine from the inventory but do not delete the files from disk. Connect to the ESX host on which the virtual machine resides over SSH. For more information, see Opening a command or shell prompt (1003892). Unregister the virtual machine. For ESX, run this command:vmware-cmd -s unregister <path to config file>Where <path to config file> is the path to the configuration file as determined by the vmware-cmd –l command. For more information on the vmware-cmd –l command, see the VMware Scripting API. For example:vmware-cmd -s unregister '/vmfs/volumes/storage1/vm1/vm1.vmx' For ESXi: Log in to the ESXi host where the virtual machine is registered. For more information, see: Tech Support Mode for Emergency Support (1003677) for ESXi 3.5 and ESXi 4.0 Using Tech Support Mode in ESXi 4.1 and ESXi 5.x (1017910) for ESXi 4.1 and above. Unregister the virtual machine with the CLI commands:Note: The getallvms command should return the vmid of the virtual machine to be unregistered.# vim-cmd vmsvc/getallvms# vim-cmd vmsvc/unregister vmidAlternatively, unregister the virtual machine from vCenter Server inventory. To unregister, right-click the virtual machine and choose Remove from Inventory. Rename the folder, .vmx file, and .vmdk (+ flat) file to match the new name:mv /vmfs/volumes/storage1/vm1/ /vmfs/volumes/<perhaps new storage?>/NewVM/cd /vmfs/volumes/<perhaps new storage?>/NewVM/mv vm1.vmx NewVM.vmxmv vm1.vmdk NewVM.vmdkmv vm1-flat.vmdk NewVM-flat.vmdkSee Note below for alternative command for renaming the VMDK file: vmkfstools -E <oldName>.vmdk <newName>.vmdk Edit the .vmx file to reflect the name of the new descriptor file.Locate the scsi0:0.fileName line. It appears similar to:scsi0:0.fileName = "vm1.vmdk"The edit appears similar to:scsi0:0.fileName = "NewVM.vmdk" Save the file and exit. Edit the .vmdk file to reflect the name of the new flat file.Locate the Extent description section of the .vmdk file. It appears similar to:# Extent descriptionRW 8388608 VMFS "vm1-flat.vmdk"Edit this to:# Extent descriptionRW 8388608 VMFS "NewVM-flat.vmdk" Register the virtual machine. For an ESX host run the command:vmware-cmd -s register <path to config file>Where <path to config file> is the path to the configuration file determined by the ‘vmware-cmd –l’ command.For example:vmware-cmd -s register '/vmfs/volumes/<perhaps new storage?>/NewVM/NewVM.vmx' For an ESXi host, see Registering or adding a virtual machine to the inventory on vCenter Server or on an ESX/ESXi host (1006160). Add the virtual machine back into vCenter Server inventory using the vSphere/VMware Infrastructure Client by browsing the data store, finding the .vmx file, right-clicking and adding it to inventory. Note: There are some additional files that you may want to rename such as the .vmxf and the swap file name. Both of these are referenced from the .vmx file. If you decide to change either of these file names, ensure you update the .vmx file while you are completing step 7 in the instructions. To rename a VMDK file, you can also use the command:vmkfstools -E <oldName>.vmdk <newName>.vmdkThis command renames the content file (-flat.vmdk ) and also all references inside the metadata file (.vmdk). Ensure to update your virtual machines .vmx file after completing this step. Corrupt VMX File Issues with a virtual machine's .vmx file can prevent it from being powered on. You may also see these errors: Error when deleting a snapshot: ASSERT /build/mts/release/bora-39823/bora/vmx/snapshot/snapshot_vmx.c:752 Error when attempting to power on a virtual machine: "operation not allowed in the current state" For more information on .vmx files, see Validating the .vmx settings of a virtual machine (1003748). If you suspect your .vmx file is preventing your virtual machine from starting, you can rebuild your virtual machine with a clean .vmx file. Note: If the VM was previously in snapshot mode, be aware before adding disks to the New VM that you are reattaching the disks from the correct delta file. The following sample command grep -i scsi.*file *.vmx can be used to query the original .vmx file (if possible) outputting the delta file that the VM was last running from. To rebuild a virtual machine: Connect to vCenter Server or your ESX host directly with the vSphere Client. Remove the virtual machine from the inventory. Right-click your ESX host and choose New Virtual Machine. Select the Custom option. Create the virtual machine with the same configuration it had before the migration. When you get to the Select a Disk section, choose to Use an existing virtual disk, and point to the original .vmdk file(s). Finish the creation of the virtual machine. Power on the virtual machine. If your .vmx file has become corrupted, or the contents are missing, you can also rebuild the .vmx file if you still have the vmware.log file from the last time it booted correctly. For more information see Rebuilding the virtual machine's .vmx file from vmware.log (1023880). When viewing the log file of the virtual machine, search for the '--- CONFIGURATION' section. The .vmx files is below. You can copy this text to a text editor to create a working configuration file. Note: Do not use an editor that inserts formatting that ESX does not understand (such as Wordpad). If possible, complete the editing on the ESX host. The entries in the log file appear similar to: Feb 28 18:11:47.799: vmx| DICT config.version = 8Feb 28 18:11:47.799: vmx| DICT virtualHW.version = 4Feb 28 18:11:47.799: vmx| DICT floppy0.present = TRUE Remove the preceding section so it becomes: config.version = 8virtualHW.version = 4floppy0.present = TRUE Save it with the same name as the corrupted file and the replace the corrupted version. Corrupt VMDK File Issues with the VMDK file of a virtual machine can prevent it from being powered on. You may see the error: Failed to power on a file was not found This error may occur when the VMFS3 virtual disk descriptor (.vmdk ) files are missing. There are no <vmname>.vmdk files. Only <vmname-flat>.vmdk files exist. You can also see this error if the Extent description section of the .vmdk file is incorrect. The log files show messages similar to: Unable to find file The system cannot find the file specified. For more information on re-creating a missing descriptor file, see Recreating a missing VMDK (header) file (1002511). VMFS Corruption When a VMFS volume becomes inaccessible due to file system corruption, you may be able to migrate your running virtual machines off the filesystem. Powered off virtual machines are inaccessible. Note: This process works if the disk blocks used for the virtual disks haven't been corrupted and the operating system is Microsoft Windows. To migrate your virtual machine: Ensure you have sufficient disk space on another VMFS volume to clone the virtual machine. Connect to the virtual machine using remote desktop. Download and install VMware converter inside the virtual machine.This can also be downloaded to your own laptop, desktop, or another virtual machine as long as you have network access to both the source and destination. Run Converter and select Physical Machine and Local Machine. Choose an ESX Server host as a destination and select a healthy VMFS. Follow the wizard and wait for the process to complete. Note: Do not power-off or restart the virtual machine. When powered-off, the virtual machine cannot start again as the files become inaccessible. If the operating system is not Microsoft Windows, you can use native system tools to copy the whole image to a network share. For example, on Linux: # dd if=/dev/sda of=/mnt/nfs/sda.dd bs=1024kYou must create a new virtual machine and boot it from CD to Linux rescue mode and restore the image: # dd if=/mnt/nfs/sda.dd of=/dev/sda bs=1024kNote: This method creates only crash consistent image. Additional Information: For translated versions of this article, see: Portuguese Verificando a integridade dos arquivos da máquina virtual do ESX/ESXi (2015984) Spanish Verificar la integridad del archivo de la máquina virtual ESX/ESXi (2016450)
For related troubleshooting information, see Troubleshooting import and export failures in VMware vCenter Lab Manager (1006333). Recreating a missing virtual machine disk descriptor fileTech Support Mode for Emergency SupportValidating the .vmx settings of a virtual machineOpening a command or shell promptHow to register/add a VM to the Inventory in vCenter ServerUsing Tech Support Mode in ESXi 4.1, ESXi 5.x, and ESXi 6.xRebuilding the virtual machine's .vmx file from vmware.logVerificando a integridade dos arquivos da máquina virtual do ESX/ESXiVerificar la integridad del archivo de la máquina virtual ESX/ESXi验证 ESX/ESXi 虚拟机文件完整性ESX/ESXi 仮想マシン ファイルの整合性の確認