C Backup and restore script examples

C.1 Sample backup script

As an alternative to using Settings→Actions→Create backup from the appliance UI, you can write and run a script to automatically create and download an appliance backup file.

Example 8 “Sample backup.ps1 script” provides a sample PowerShell script that uses REST calls to create and download an appliance backup file. Cut and paste this sample script into a file on a Windows system that runs PowerShell version 3.0, and edit the script to customize it for your environment.

You can schedule the backup script to run automatically in interactive or batch mode on a regular basis (HP recommends daily backups). Only a user with Backup administrator or Infrastructure administrator privileges can run the script interactively.

•To run the script interactively, do not include any parameters. The script prompts you to enter the appliance host name, appliance user name and password, and the name of a file to store these parameters for batch mode executions. Enter the name and password of a user with the Backup administrator or Infrastructure administrator role. The user name and password are stored encrypted.

HP recommends that you run the script interactively the first time. Then, you can schedule the script to run automatically in the background using the parameter file created by the first run.

•To run the script in batch mode, specify the name of the file containing the parameters on the command line.

HP recommends that you install cURL with the SSL option to improve performance. The sample script works without cURL, but it might take several hours to download a large backup file. To download cURL, see:

http://curl.haxx.se/download.html

NOTE: You might also need to install Microsoft Visual C++ Redistributable, the MSVCR100.dll file, available here:

•64 bit: http://www.microsoft.com/download/en/details.aspx?id=14632

•32 bit: http://www.microsoft.com/download/en/details.aspx?id=5555 Make sure the path environment variable includes the path for cURL.

Sample script

The sample script makes the following calls to create and download a backup file:

1.Calls queryfor-credentials()to get the appliance host name, user name, and password by either prompting the user or reading the values from a file.

2.Calls login-appliance()to issue a REST request to obtain a session ID used to authorize backup REST calls.

3.Calls backup-appliance()to issue a REST request to start a backup.

4.Calls waitFor-completion()to issue REST requests to poll for backup status until the backup completes.

5.Calls get-backupResource()to issue a REST request to get the download URI.6.Calls download-backup()to issue a REST request to download the backup.

C.1 Sample backup script 271