Cluster backup failed with BackupAsyncStatus "status=URI_NOT_FOUND"

Products

• VMware NSX

Issue/Introduction

• The URI is a very specific directory path where NSX backup files are placed. It is a required format regardless of the SFTP server
• Backups configured fail with the following error message.
  
• In the proton/nsxapi.log file you will see the following entries.
  • INFO http-nio-exec-49 NapiBackupGenerationServiceImpl 5283 SYSTEM [nsx@6876 comp="nsx-manager" level="INFO" reqId="######-####-####-###-############" subcomp="manager" username="admin"] Exception received from napi statusDetail {"error_code": 36219, "error_message": "Specified uri '/<Directory Path>/cluster-node-backups/<NSX Verion>-IPv4-######-####-####-###-############-<IP Address>/backup-YYYY-MN-DDTHH_MM_SCUTC' not found.", "module_name": "node-services"}
  • WARN http-nio-exec-49 NapiBackupGenerationServiceImpl 5283 SYSTEM [nsx@6876 comp="nsx-manager" level="WARNING" reqId="######-####-####-###-############" subcomp="manager" username="admin"] URI_NOT_FOUND
    
    
• The parent directory is configured in the NSX UI. 
  
  This setting must be found under "/" root directory.  It must also be manually created on the TFTP server first.  NSX will not create this directory.
• The rest of the URI will be built in this directory with the following format.
  <backup-root-directory>/  ⇐Taken from NSX UI Directory Path configuration.
      ├── nsx-backups/
    │     ├── <manager-hostname or cluster-ID>/
    │     │     ├── backup-<timestamp>.tar
    │     │     ├── manifest.json
    │     │     └── ...
  Example:  /<Directory Path>/nsx-backups/<NSX Verion>-IPv4-######-####-####-###-############-<IP Address>/backup-YYYY-MN-DDTHH_MM_SCUTC
• The backup user must have read and write permissions

Environment

• VCF 9
• VMware NSX

Cause

• The Directory Path does not follow the required format.
• The user for backups does not have enough privileges to read and write to the backup location in the SFTP server.
• The SFTP server is not support by NSX for backups.

Resolution

• Ensure that the directory path where you want to store your backups exists and that you have read/write permissions to that directory (/<Directory Path>).
• Verify that the SFTP server
  • $ ssh backup_user@sftp_server
  • $ sftp backup_user@sftp_server
    
    
• For testing purposes the ESX host can be configured as the SFTP destination.
• Use the root user and password for the Backup Configuration.
• Create a directory for the test backup to target.
• If the SFTP test is successful using the EXSi host as the target, then replace the current SFTP server with a supported SFTP server. 
• Currently supported OS

 

Additional Information

Configure Backups

The SFTP client server negotiation will look like the diagram when successful