NSX-T 3.1.3.7 to 3.2.1.2 upgrade fails on the management plane upgrade during the data migration step

Products

VMware NSX

Issue/Introduction

During the upgrade from 3.1.3.7 to 3.2.1.2, if LDAP is configured for user authentication, the upgrade may fail at the data migration step with error messages similar to:

log file: /var/log/proton/data-migration.log

2024-04-19T04:35:00.829Z  INFO main UFOMigration 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] --------------- Migrating table :nsx-manager LdapIdentitySource 90fb to UFO Store ---------------
2024-04-19T04:35:00.830Z  INFO main UfoCorfuTableMigrator 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] mappingDetails: null
2024-04-19T04:35:00.830Z  INFO main UfoCorfuTableMigrator 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] tableSchema :nsx-manager LdapIdentitySource 90fb
2024-04-19T04:35:00.830Z  INFO main UfoCorfuTableMigrator 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Found 1 objects
2024-04-19T04:35:00.830Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] In loadClass for class com.vmware.nsx.management.ldapidentitysources.model.LdapIdentitySource
2024-04-19T04:35:00.830Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] In loadClass for class com.vmware.nsx.management.container.model.AbstractManagedResourceModel
2024-04-19T04:35:00.830Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Not loading class class com.vmware.nsx.management.container.model.AbstractManagedResourceModel
2024-04-19T04:35:00.831Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Finding ufo msg name for class com.vmware.nsx.management.ldapidentitysources.model.LdapIdentitySource, mapping details null
2024-04-19T04:35:00.831Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] getUfoStoreMsgName :vmware.nsx.ufostore.ldapidentitysources.model, class com.vmware.nsx.management.ldapidentitysources.model.LdapIdentitySource, null, LdapIdentitySource
2024-04-19T04:35:00.831Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] outerClassName: LdapIdentitySourceProto
2024-04-19T04:35:00.831Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] returning: vmware.nsx.ufostore.ldapidentitysources.model.LdapIdentitySourceProto$LdapIdentitySourceMsg

2024-04-19T04:35:00.840Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Finding ufo msg name for class com.vmware.nsx.management.ldapidentitysources.model.IdentitySourceLdapServer, mapping details null
2024-04-19T04:35:00.840Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] getUfoStoreMsgName :vmware.nsx.ufostore.ldapidentitysources.model, class com.vmware.nsx.management.ldapidentitysources.model.IdentitySourceLdapServer, null, IdentitySourceLdapServer
2024-04-19T04:35:00.840Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] outerClassName: IdentitySourceLdapServerProto
2024-04-19T04:35:00.840Z  WARN main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] returning: vmware.nsx.ufostore.ldapidentitysources.model.IdentitySourceLdapServerProto$IdentitySourceLdapServerMsg
2024-04-19T04:35:00.843Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] >>>>> Find getter for url of type class java.lang.String
2024-04-19T04:35:00.843Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Found MethodHandle(IdentitySourceLdapServer)String
2024-04-19T04:35:00.843Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Looking for setter for url of type java.lang.String
2024-04-19T04:35:00.843Z  INFO main UfoMigrationUtils 4079 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Found setterMethodHandle for wrapperTypes: MethodHandle(Builder,StringValue)Builder

Exception

2024-05-08T18:02:36.982Z ERROR main Migration 4182 - [nsx@6876 comp="nsx-manager" errorCode="MP217" level="ERROR" subcomp="manager"] Migration failed com.vmware.nsx.management.common.exceptions.BaseException: Failed to find the table name for message class vmware.nsx.ufostore.ldapidentitysources.model.ActiveDirectoryIdentitySourceProto$ActiveDirectoryIdentitySourceMsg        

at com.vmware.nsx.management.migration.ufo.UfoCorfuTableMigrator.getTableName(UfoCorfuTableMigrator.java:239) ~[common-data-migration.jar:?]

Environment

VMware NSX-T Data Center

Cause

The corfu db table ActiveDirectoryIdentitySourceProto is not expected to be populated during the data migration step. If this table is populated, the data migration fails because the software does not have a place to properly map the table's contents and the data migration is considered a failure.

Resolution

If you are contacting Broadcom support about this issue, please provide the following:

Retrieve log bundles from all NSX Managers
Date and time of reported failure
Text and screenshots of any log messages or on screen errors that appear

Handling Log Bundles for offline review with Broadcom support