Use the find-orphan-vms command of the cell management tool to find references to virtual machines that are present in the vCenter database but not in the VMware Cloud Director database.
Virtual machines that are referenced in the vCenter database but not in the VMware Cloud Director database are considered orphan VMs because VMware Cloud Director cannot access them even though they may be consuming compute and storage resources. This kind of reference mismatch can arise for a number of reasons, including high-volume workloads, database errors, and administrative actions. The find-orphan-vms command enables an administrator to list these VMs so that they can be removed or re-imported into VMware Cloud Director. This command has provisions for specifying an alternate trust store, which might be needed if you are working with VMware Cloud Director or vCenter installations that use self-signed certificates.
cell-management-tool find-orphan-vms options
Option | Argument | Description |
---|---|---|
--help (-h) | None | Provides a summary of available commands in this category. |
--enableVerifyHostname | None | Enable the host name verification part of the SSL handshake. |
--host | Required | IP address or fully-qualified domain name of the VMware Cloud Director installation to search for orphan VMs. |
--output-file | path name or - |
Full path name of the file to which the list of orphan VMs should be written. Specify a path name of - to write the list to the standard output. |
--password (-p) | Required | VMware Cloud Director system administrator password. |
--port | VMware Cloud Director HTTPS port. | Specify this only if you do not want this command to use the default VMware Cloud Director HTTPS port. |
--trustStore | Full path name to a Java trust store file. | Specify this only if you do not want this command to use the default VMware Cloud Director trust store file. |
--trustStorePassword | Password to specified --trustStore | Required only if you use --trustStore to specify an alternate trust store file. |
--trustStoreType | The type of the specified --trustStore (PKCS12, JCEKS, ...) | Required only if you use --trustStore to specify an alternate trust store file. |
--user (-u) | Required | VMware Cloud Director system administrator user name. |
--vc-name | Required | Name of vCenter to search for orphan VMs. |
--vc-password | Required | vCenter administrator password. |
--vc-user | Required | vCenter administrator user name. |
Finding Orphaned VMs
-
, results are returned on the standard output.
[root@cell1 /opt/vmware/vcloud–director/bin]# ./cell-management-tool find-orphan-vms \ --host 10.20.30.40 -u vcadmin -vc-name vcenter1 -vc-password P@55w0rd --vc-user admin --output-file - Querying for VC by name 10.20.30.40 Querying all vdc's associated with VC: 10.20.30.40 (https://10.20.30.40:443) Querying all vdc<->resource pool mappings associated with VC: 10.20.30.40 (https://10.20.30.40:443) Querying all vdc<->VM Moref mappings associated with VC: 10.20.30.40 (https://10.20.30.40:443) Processing 956 VM's on 5 VDC's across 20 resource pools Analysis complete. VDC: "ExampleOrgVDC [urn:vcloud:vdc:1a97...]" (org: "ExampleOrg") ResPool: primary (1a97...) [moref: "resgroup-30515"] The following 22 orphan VMs were discovered: Orphan VM: "indDisk100-0-95411 (cbc358a0-e199-4024-8fff-2e5cfce20953)" (parent name: "Test VMs", parent moref : "group-v30533") ... Orphan VM: "indDisk12-0-51259 (0bbb4115-673e-4c84-ba26-6875159655e0)" (parent name: "Test VMs", parent moref : "group-v30533")