HP Insight Control Server Provisioning 7.3 Update 1 Administrator Guide

5. Issue the REST request to start the restore.
6. Check the response to the restore request to make sure the restore started successfully. The
restore will fail if the backup version is incompatible with the firmware running on the appliance
or if the backup is corrupted. If the backup is incompatible with the firmware on the appliance,
update the firmware and then retry the restore or upload a different backup. If the backup is
corrupt, upload a different backup.
7. Issue REST requests periodically to get restore progress information. A restore can take several
hours to complete. The amount of time required depends on the size of the managed
environment. The REST API returns the percentage complete and a description of the restore
step in progress.
8. Once the restore completes, the REST API returns a message reporting the restore completed
successfully.
9. After the restore completes, users can log in to the appliance. A restore resets the user names
and passwords to those in effect at the time of the backup.
10. There will be an alert indicating the restore completed successfully.
11. During the restore, the appliance firmware automatically reconciles the data in the backup
with the current state of the managed environment. If there are any discrepancies that cannot
be resolved automatically, resolve them manually after the restore. After the restore completes,
log in to the appliance to check for alerts related to inconsistencies. Follow the instructions in
the alert messages to resolve the discrepancies.
12. After resolving any discrepancies detected by the restore, perform a new backup. Restart the
regularly scheduled backups.
13. If an unrecoverable error occurs during a restore, the restore REST API calls will fail. An error
message will be displayed indicating the restore failed and that it is necessary to deploy a
new appliance from the HP-provided template as described in the HP Insight Control Server
Provisioning Installation Guide available at http://www.hp.com/go/insightcontrol/docs.
Restore REST API overview
IC server provisioning provides REST APIs and sample scripts for use in restoring an appliance
from backup .
NOTE: You can also use the Insight Control server provisioning UI to restore an appliance from
a backup file. From the Settings screen, select ActionsRestore from backup (see the online help
for details).
The restore REST API provides REST calls to the following:
upload a backup to the appliance
start a restore
check the restore status.
These calls are summarized in the following table. The REST API calls to start a restore require a
session ID for authorization. The session ID is obtained by issuing the REST request to log in to the
appliance as a user with the role of Infrastructure Administrator. The REST API calls to get restore
status information do not require a session ID.
DescriptionResponse body
Response
headersRequest bodyRequest headersREST call
Upload a
backup to
A backup resource that
contains the upload
N.A.Multipart form data
containing the
backup file.
auth: session ID,
content-type:
multipart/
POST
https://{appl}/rest/backups/
archive
Restoring the appliance 53