How to Identify Orphan or Stale Host Entries in NSX Manager?

Products

• VMware NSX
• VMware NSX-T Data Center

Issue/Introduction

This article aims to provide instructions on how to identify if any orphan or stale host entries present in NSX Manager. These stale host entries can cause an upgrade pre-check to fail, resulting in an error indicating the presence of a host that should not exist.

Environment

VMware NSX

VMware NSX-T Data Center

Resolution

There are two scenarios to consider to identify stale host entries in NSX Manager:

1. Stale Presence on the UI

This occurs when a host is no longer part of the vCenter inventory or is scheduled for decommissioning, and NSX has already been uninstalled. To detect such stale host entries, follow these steps:

• Access the NSX management UI, and navigate to the inventory or host section.

• Look for any hosts that do not exist in the vCenter inventory or have NSX uninstalled.

• If any such hosts are found, they can be considered stale entries and should be removed from the NSX inventory.

These host entries can be removed from the UI by selecting the host in question and clicking "Remove NSX" or using the API:

DELETE "https://localhost/api/v1/transport-nodes/<UUID>?force=true"

2. Stale Host Entry Present Within the Database but Not in the NSX Management UI

To identify and validate stale host entries in the database, follow these steps:

1. From the NSX Manager root CLI, run the following command to validate the stale entries:

/opt/vmware/bin/corfu_tool_runner.py --tool corfu-editor -n nsx -o showTable -t HostTransportNode | grep "host-transport-nodes"

2. Return to the NSX Management UI, navigate to the inventory or host section and ensure the number of hosts matches.
   
   If the stale Transport node entry exists, kindly follow the KB: https://knowledge.broadcom.com/external/article?articleNumber=319975 resolution section to clear the stale entries.

If still issue exists and you need assistance deleting any of the stale database entries, please open a Broadcom Technical Support case. For more information, see How to Submit a Support Request