Pages

Friday, December 16, 2011

ESXi 4.1 host’s inventory no longer shows up and presents the error: “Configuration Issues” “The virtual machine inventory file on host hostName.domain.com is damaged or unreadable.”

Problem

You have just rebooted your ESXi 4.1 host, logged in and notice that the inventory no longer shows up and presents the error:

Configuration Issues

The virtual machine inventory file on host hostName.domain.com is damaged or unreadable.

image

Solution

I’ve searched around on the internet and was only able to find one post that referenced this error and since I had to get the environment up in a hurry, I ended up opening a case with VMware. The engineer said that this error was rare and the only reason why he knew about it was because his colleague, which happens to sit beside him, ran into this error a week ago. 

This usually happens if the vmInventory.xml, which is located in the directory /etc/vmware/hostd is either corrupted or somehow has another process that has a lock on it which in turn prevents it from being read properly.

We proceeded to perform the obvious checks by trying to cat the file to see if we can read the content:

image

As shown in the screenshot above, we don’t get any content returned so we proceeded to double check to ensure it’s not a disk space issue by executing df -h:

image

As shown in the screenshot above, we did not run out of space so we issued a ls -l to see see what the file size was:

image

As shown in the screenshot above, the file size was listed as 0 bytes so this was when he asked his colleague what he did to correct this problem and what he was told was that he used an editor such as VI to add the line:

<ConfigRoot>

into the vmInventory.xml file, save it, restart the services and the inventory list came back.  I proceeded to try and do this:

image

image

Just before I restarted the services, I tried to cat the file again but only saw the line I put in:

image

I proceeded to restart the services by executing the services.sh restart:

image

… but the inventory didn’t come back.  At this point, I was running out of time so I told the engineer that I was going to proceed with manually adding all the VMs back via the GUI since this was a standalone server with only 10 to 15 VMs:

image

After I added the first VM, I tried to cat the vmInventory.xml file once more and this time saw more content in it:

image

This was when I believed that the file was simply corrupted so I prceeded to add the rest of the virtual machines manually.

I spoke to the engineer a bit later and he said he’s not sure what the root cause was but if it was a lock on the file by some other process, we could use the lsof (list open files) command to find out exactly what processes are may have a lock on the file.

I hope this helps anyone out there who may encounter the same problem.

2 comments:

Greg said...

Thanks Terence,

I ran into the same issue where my vmInventory file was blank. I removed the orphaned vms from inventory, re-added them and restarted the services and everything seems fine.

rockwallet said...

I keep having this same error come up on my server (Esxi v6.0.0 build 3620759)
It happens every couple of months to me. Randomly, I'll log in the vshpere and find I cannot do any admin on my servers. In my case, the vminventory.xml file was looking fine except the last tag was missing. Every time it happens, it is the same line that is missing. Anyways, I put it back in place and restart the server and all is good for another couple of months.

Problem is that it means I need to take my servers offline every couple of months which my client does not want. I wonder if there is a way that I can do a less invasive reset to complete this workaround. There doesn't appear to be any fix available aside from upgrading the version of esxi.