NSX Manager Upgrade Failed on 'run_migration_tool' Step

Products

• VMware NSX

Issue/Introduction

Symptoms:

• NSX upgrade target version is specified as older than 4.2.3.1
• While NSX edges and ESXi hosts upgraded successfully, the NSX manager upgrade failed.
• The command "get upgrade progress-status" running in NSX manager indicates failure during the "run_migration_tool" step:

run_migration_tool [YYYY-MM-DD HH:MM:SS - YYYY-MM-DD HH:MM:SS] FAILED

• The NSX manager log file /var/log/upgrade-coordinator/logical-migration.log contains the following fault:

YYYY-MM-DDTHH:MM:SS  INFO main MigrationTask 73612 - [nsx@6876 comp="nsx-manager" level="INFO" subcomp="manager"] Segment port: SegmentPort//infra/segments/vm-domain-cXXXXXX-XXXXXX-XXXXXX/ports/XXXXXX-XXXXXX has port type CHILD or INDEPENDENT

YYYY-MM-DDTHH:MM:SS  WARN main UfoCorfuTableMigrator 73612 - [nsx@6876 comp="nsx-manager" level="WARNING" subcomp="manager"] ERROR while running logical migration MappingDetails{name='SegmentPortIpPoolMigrationTask', runForTheseFromVersions='3.2.0,3.2.1,3.2.2,3.2.3,4.0.0,4.0.1,4.1.0,4.1.1,4.1.2', targetVersion='4.2', modelName='null', migrationType=null, reason='This migration task will migrate Ips allocated on proton to policy model.', customMigratorClassName='com.vmware.nsx.management.migration.impl.SegmentPortIpPoolMigrationTask', fieldMappings=null, targetProtoName='null', requiresCustomCode='false', owner='null',
 apiToTest='null', weight='1.0', impactedTables='null', cleanup='false', enabled'false', diskBacked'false', triggerMode'null', supportsResolve'false', component'null'}
java.lang.NullPointerException: null
        at com.vmware.nsx.management.migration.impl.SegmentPortIpPoolMigrationTask.migrateIpPoolInfo(SegmentPortIpPoolMigrationTask.java:242) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.impl.SegmentPortIpPoolMigrationTask.migrate(SegmentPortIpPoolMigrationTask.java:153) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.ufo.UfoCorfuTableMigrator.migrate(UfoCorfuTableMigrator.java:145) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.ufo.UFOMigration.invokeMigrate(UFOMigration.java:256) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.ufo.UFOMigration.migrateData(UFOMigration.java:224) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.ufo.UFOMigration.migrate(UFOMigration.java:158) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.impl.LogicalMigration.executeMigrations(LogicalMigration.java:47) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.impl.Migration.migrate(Migration.java:36) ~[logical-migration.jar:?]
        at com.vmware.nsx.management.migration.impl.LogicalMigration.main(LogicalMigration.java:35) ~[logical-migration.jar:?]

 

Environment

VMware NSX

Cause

The NullPointerException is at SegmentPortIppoolMigrationTask because LogicalPort does not have filed 'addressBindings' set.

Resolution

Please choose NSX 4.2.3.1 or later as upgrade target version to fix the issue.

Additional Information

Please refer to document listed below:

https://techdocs.broadcom.com/us/en/vmware-cis/nsx/vmware-nsx/4-2/release-notes/vmware-nsx-4231-release-notes.html

"

Fixed Issue 3552698: NullPointerException at SegmentPortIpPoolMigrationTask where the LogicalPort::addressBindings is null. This causes NSX Upgrade to fail.
NSX Upgrade failure.

"