Avi Upgrade fail due to configuration migration issues with invalid email address

Products

• VMware NSX

Issue/Introduction

Upgrade fails during configuration migration due to an invalid email address format with any Avi user account.

Go to shell mode on Controller Node

# shell
> show upgrade status details filter controller
Error: Unable to complete task migrate_config on ['node.controller.local']

# Logs to check on Controller Node
/var/lib/avi/log/upgrade-coordinator.log
Unable to complete task migrate_config on ['node.controller.local']

# Here take the example for Avi admin user configured with invalid email address
/var/lib/avi/log/task_journal/upgrade_import_config.json
Serializing error {'email': ['Enter a valid e-mail address.']} for UserSerializer

Environment

VMware Avi Load Balancer

Affected Version: 22.1.x, 30.2.x and 31.2.x

Cause

• The Avi user has email set to invalid email format (e.g., admin or abc-xyz). From Version 30.2.x enforces stricter email validation during the migration process.

Resolution

Fix the Email Address BEFORE Upgrade

1. Log into the Avi Controller UI as the admin user
2. Navigate to My Account settings:
3. Click on your profile/username in the top-right corner
4. Select "My Account"
5. Update the Email field:
6. Change from: admin or any invalid email address format
7. Change to: [email protected] (use a valid email format)
8. Click Save
9. Retry the upgrade after the email has been corrected
   
   

 

Additional Information

• Do NOT use Administration > Users > Admin to change this - it won't work
• Only the "My Account" section allows you to bypass the validation check and update the email
• This issue affects any user account with an improperly formatted email address
• Verify all user accounts have valid email formats before attempting the upgrade