Management Plane component pre-check fails due to data migration pre-check failure

Products

• VMware NSX

Issue/Introduction

• You're upgrading your existing NSX deployment to a version earlier than 4.1.0.2 or 4.1.1
• Pre-check fails with below error observed under  /var/log/upgrade-coordinator/upgrade-coordinator.log:

...
2023-08-27T12:31:26.041Z  WARN pool-52-thread-3 UpgradeServiceImpl 26553 SYSTEM [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="upgrade-coordinator"] [PUC] Pre-upgrade check InspectionTaskInfo[id=upgradeEvaluationToolCheck,name=Upgrade Evaluation Tool execution check,description=Prompts user to execute Upgrade Evaluation Tool before proceeding with upgrade.,componentType=MP,needsAcknowledgement=false,acknowledgement=false,needsResolution=false,resolution=false,resolutionError=<null>] failed with result BasicInspectionTaskResult{status=FAILURE, taskInfo=InspectionTaskInfo[id=upgradeEvaluationToolCheck,name=Upgrade Evaluation Tool execution check,description=Prompts user to execute Upgrade Evaluation Tool before proceeding with upgrade.,componentType=MP,needsAcknowledgement=true,acknowledgement=false,needsResolution=false,resolution=false,resolutionError=<null>], failureMessages=null, failures=[{"moduleName":"upgrade-coordinator","errorCode":36000,"errorMessage":"NSX Manager upgrade dry run failed. Do not proceed with the upgrade. Please collect the support bundle and contact VMWare GS. Failed migrations: OwnershipMigrationTask: null
Exception during Data migration
"}]}
....

• You observe similar error under /var/log/upgrade-coordinator/upgrade-coordinator/logical-migration.log

...
2023-08-27T12:31:19.557Z  WARN pool-9-thread-1 UfoCorfuTableMigrator 28978 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] ERROR while running logical migration MappingDetails{name='OwnershipMigrationTask', runForTheseFromVersions='3.2,4.0', targetVersion='4.1', modelName='null', migrationType=null, reason='Segment add ownerId and Origin Site ID', customMigratorClassName='com.vmware.nsx.management.migration.impl.OwnershipMigrationTask', fieldMappings=null, targetProto
Name='null', requiresCustomCode='false', owner='null', apiToTest='null'}
java.lang.IllegalArgumentException: Invalid UUID string: Site01NSX
        at java.util.UUID.fromString(UUID.java:194) ~[?:1.8.0_342]
        at com.vmware.nsx.management.migration.impl.OwnershipMigrationTask.handlingGlobalInfra(OwnershipMigrationTask.java:337) ~[logical-migration.jar:?]
...

Environment

VMware NSX-T Data Center

Cause

If the string UUID is not in a hexadecimal generated format (i.e, similar to b9ae8813-####-####-####-060d683ae414) the logical migration process would fail.

...
java.lang.IllegalArgumentException: Invalid UUID string: Site01NSX
        at java.util.UUID.fromString(UUID.java:194) ~[?:1.8.0_342]
...

Resolution

This issue is fixed starting NSX 4.1.0.2 and 4.1.1