Troubleshooting appliance backup and restore

If an unrecoverable error occurs while the appliance is being restored, the appliance reboots and then resets to factory default settings. In that situation, use the user interface or REST APIs (Configure the appliance) to reconfigure the appliance.

After reconfiguring the appliance, use a different backup file to restore the appliance.

Resolving HTTP errors

The following table lists REST API error codes and resolutions.

HTTP error Response body error code Description and resolution
400 Bad Request INVALID_PARAMETER Description:

An invalid parameter was specified.

Resolution:

Specify a valid backup ID. It must be in the form:

hostname_backup_YYYY-MM-dd_HHmmss

401 Unauthorized AUTHORIZATION Description:

An incorrect user name or password was specified.

Resolution:

Verify the credentials.

Specify the correct user name and password.

404 Not Found RESOURCE_NOT_FOUND Description:

The incorrect URI was specified.

Resolution:

Specify the correct URI. You may need to wait for the appliance software to start. You can find out the correct URI using this document. It might help to issue the REST request to obtain the last backup resource.

409 Conflict BACKUP_IN_PROGRESS Description:

The requested operation cannot be performed because a backup is in progress. A backup cannot be uploaded or restored while the appliance is taking a backup.

Resolution:

Wait until the backup finishes or cancel the backup, then retry the operation.

BACKUP_DOWNLOAD_IN_PROGRESS Description:

The requested operation cannot be performed because a backup is being downloaded. A backup file cannot be uploaded or restored while a download is in progress.

Resolution:

Wait until the download finishes, then retry the operation.

BACKUP_UPLOAD_IN_PROGRESS Description:

The requested operation cannot be performed while a backup file is uploaded.

Resolution:

Wait until the upload finishes, then retry the operation.

BACKUP_RESTORE_IN_PROGRESS Description:

The requested operation cannot be performed while a restore operation is in progress.

Resolution:

Wait until the restore operation finishes, then retry the operation.

500 Internal Server Error Various Description:

An internal error occurred.

Resolution:

Create a support dump. Try to restore a different backup.