"OCDoctor.sh --t" reported duplicate ldom guest metadata as error: ERRROR: File /guests/<UUID>/virtimage.xml is of size 0 Bytes! (Doc ID 2590649.1)

Symptoms

While running `OCDoctor.sh --troubleshoot` on a control domain (cdom) we saw the following errors:

# /var/opt/sun/xvm/OCDoctor/OCDoctor.sh --troubleshoot

<<<snip>>>
ERROR: There is an issue within the following Library:
  Library Name: Local Storage Library (<HOSTNAME>)
  Library Path: /guests
  Issue: File /guests/<UUID>/virtimage.xml is of size 0!
  Recommendation: Use the tool .../OCDoctor/toolbox/library-check.sh to analyze the issue in detail.
<<<snip>>>

While running the advised command library-check.sh (from above) we saw error:

# /var/opt/sun/xvm/OCDoctor/toolbox/library-check.sh

Summary of Library /guests/:
Library name: Local Storage Library (<HOSTNAME>)
library.xml contains 1 VirtImages elements
total sum of image subdirs: 1
subdirs with a virtimage.xml file: 0
bestimpl subdirs: 1

ERRROR: File /guests/<UUID>/virtimage.xml is of size 0 Bytes!
  This could have been caused by NFS-Server outages/issues.
  Use an existing good virtimage.xml file as template to manually recreate
  the broken virtimage.xml file or open a SR to get this resolved.

Further details of observed findings:
image <UUID> does not exist !
WARNING: image <UUID>/ does not contain a file virtimage.xml, looks to be a leftover

Changes

 One potential cause noted below.

If Ops Center agent is unconfigured while cdom host is still member of a server pool the meta data for an agent is not cleared from the NFS meta data share.   Upon agent configuration the guest meta data is modeled in the local /guests location.    This meta data can end up inconsistent as only one instance should exist.

Cause

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.