NSX-T Manager 4.x restore failed

Products

• VMware NSX

Issue/Introduction

While you are restoring NSX-T Manager 4.x, you may encounter the following error message:

Error: upstream connect error or disconnect/reset before headers. reset reason: connection termination (Error code: 503)

This error may disappear after a short time. However, the restore process continues and then fails with the following error:

Error copying inventory backup file from/to remote/local server: {/upload/NSX-ESX-R/inventory-summary/4.0.0.1.0.20159694-<UUID>-<IP Address>/inventory-<date&time>UTC.json=/image/backup/cluster/inventory_backup.json}.

Environment

VMware NSX

Resolution

To workaround this issue, you must bypass the automated download process by manually transferring the backup files from the SFTP server directory to the NSX-T Manager local file system.

• Log in to the NSX-T Manager via SSH as root or admin.
  • If you are logged in as root, switch to engineering mode using st en and provide root credentials.
• Move to the /image/backup/cluster/ folder:

  cd /image/backup/cluster/

• Connect to the SFTP server using the SFTP credentials:
  • sftp <username>@<sftpserver>
  • For a specific port number, use the following syntax:

    sftp -P <port-number> <username>@<sftpserver>

  • Move to the folder where your inventory file is located:

    cd /<sftppath>/inventory-summary/

  • Execute the get command:

    get 4.#.#.#.####-<UUID>/inventory-<date>.json

  • Type exit and press Enter.
• Rename the inventory file to inventory_backup.json:

  mv 4.#.#.#.####-<UUID>/inventory-<date>.json inventory_backup.json

• Navigate to System > Backup & Restore in the NSX-T UI and retry the backup using the same exact date as the file you copied.
  • Follow the restore procedure as usual.
• The restore process now completes successfully.

Additional Information

You cannot restore the NSX-T Manager when this error occurs.

For additional information, see Troubleshooting NSX Backup and Restore Failures.