Edge node Upgrade Pre-check on NSX Manager fails with error: "UUID" vmId is not found on NSX Manager

Products

• VMware NSX

Issue/Introduction

During upgrade pre-check for edges, some Edge nodes will return an error:
Edge node "UUID" vmId is not found on NSX Manager.

Environment

VMware NSX-T Data Center

Cause

The Edge VM's 'vm-Moref id(vm-xxx)' is inaccurately filled in within the metadata of the Edge upgrade unit.

Resolution

Note:

• Please refer the KB below, before following the steps below. 

  NSX-T Edge Pre-check Errors and Upgrade is Stuck at 'switch_os' Step on Edge Nodes

• If the current state requires editing the corfu database and if the number of edges is too large to run the manual operation, you can consider running the script below.

 

1) Check if the vm_id field is actually missing for the Edge VM using the command below, and save the result in a notepad.

corfu_tool_runner.py -t EdgeNodeExternalConfig -n nsx -o showTable

 

2) Check if the entityID (VM Moref_ID) is stale using the command below, and save the result in a notepad.

corfu_tool_runner.py -t DeploymentUnitInstance -n nsx -o showTable

 

3) Download and upload the attached .jar file to the given NSX Manager path using the command below:

opt/vmware/proton-tomcat/webapps/nsxapi/WEB-INF/lib/

 

4) Run the command below.

java -cp "libcorfu-data-corrector-lib.jar:/opt/vmware/proton-tomcat/webapps/nsxapi/WEB-INF/lib/*:/usr/tomcat/lib/*" -Dcorfu-property-file-path=/opt/vmware/proton-tomcat/conf/ufo-factory.properties -Djava.io.tmpdir=/image/corfu-tools/temp com.vmware.nsx.management.migration.impl.MissingEdgeVmIdProblemCorrectorAndDetector

 

5) Re-run the pre-check once again and verify that the previously listed Edges are no longer displayed. (If not, please follow the rest of the steps)

 

6) Check the log to identify the affected Edge nodes after running step 4, using the command below:

less /var/log/proton/corfu-data-corrector.log

 

7) Run the command below

java -cp "libcorfu-data-corrector-lib.jar:/opt/vmware/proton-tomcat/webapps/nsxapi/WEB-INF/lib/*:/usr/tomcat/lib/*" -Dcorfu-property-file-path=/opt/vmware/proton-tomcat/conf/ufo-factory.properties -Djava.io.tmpdir=/image/corfu-tools/temp com.vmware.nsx.management.migration.impl.EdgeVmInfoCorrector

 

8) Re-run the pre-check once again and see if the listed edges are not showing anymore.