NSX-T Manager fails to restore from backup with the error “doesn't have either a Cluster or a Node file”

Products

• VMware NSX

Issue/Introduction

• NSX-T Manager fails to restore from backup with the error
  
  Error: Folder '####' on a SFTP server, that contains a backup for a selected timestamp - doesn't have either a Cluster or a Node file (Error code: 29317)


• NSX-T Manager /var/log/proton/nsxapi.log shows error log below
  
  INFO http-nio-127.0.0.1-7440-exec-5 UI_LOG 81379 - [nsx@6876 comp="nsx-manager" level="INFO" reqId="db3f1483-c62a-4112-85fc-fdaeaf5b2355" subcomp="manager" username="admin"] {"user":"admin","message":"Api Errors->","messageData
":{"headers":{"normalizedNames":{},"lazyUpdate":null},"status":400,"statusText":"Bad Request","url":"https://####/api/v1/cluster/restore?action=start","ok":false,"name":"HttpErrorResponse","message":"Http failure response for https://####/api/v1/cluster/restore?action=start: 400 Bad Request","error":{"httpStatus":"BAD_REQUEST","error_code":29317,"module_name":"backup-restore","error_message":"Error: Folder '####' on a SFTP server, that contains a backup for a selected timestamp - doesn't have either a Cluster or a Node file (Error code: 29317)","error_data":{"status":400}}},"level":"Error","time":"####","location":"/app/system/home/backup-restore/home"}
  
  
• Checked the SFTP server used for backup, and found that the backup files have been moved to another directory.
  
  cluster_backup-<NSX Manager UUID>-<NSX Manager IP>-nsx-ufo-backup-restore.tar
node_backup-<NSX Manager UUID>-<NSX Manager IP>.tar

Environment

VMware NSX 4.X

Cause

The directory structure and file names of NSX-T backup files must follow strict requirements. Moving the files to a different directory breaks this structure, making the backup unrecoverable.

<NSX-T version>-IPv4-<NSX Manager UUID>-<NSX Manager IP>/backup-<backup time>/cluster_backup-<NSX Manager UUID>-<NSX Manager IP>-nsx-ufo-backup-restore.tar
<NSX-T version>-IPv4-<NSX Manager UUID>-<NSX Manager IP>/backup-<backup time>/node_backup-<NSX Manager UUID>-<NSX Manager IP>.tar

Resolution

Move the backup files back to their original directory, or create a directory that meets the required structure.

Additional Information

For more information, please refer Article Troubleshooting NSX Backup and Restore Failures