Backup Verification Scripts

Topic

This article describes the Backup Verification Scripts component of advanced screenshot verification.

Environment

  • Datto SIRIS
  • Datto ALTO

Description

Datto appliances leverage a new screenshot verification engine. This modern architecture is faster, more accurate, and less resource-intensive than the first generation of screenshot verification. It also includes the ability to perform additional validations during the screenshot process to further help in verifying backup integrity.

NOTE  Use script verification with caution. Only deploy scripts in the virtual environment of your Datto appliance. Datto offers template scripts as examples only and is unable to provide support for custom scripting or any unexpected behavior of your production environment as a result of the deployment of a custom script.

NOTE  Service Verification and Script Verification are incompatible with Virtual SIRIS on Hyper-V and with screenshots offloaded to a Hyper-V host; they will not run even if configured to do so.

Description

Advanced Screenshot Verification introduces Script Validation, which allows the appliance to execute scripts upon screenshot verification. As an example, a SQL database could be checked to validate that a given table returns the correct number of rows, or Exchange server could be checked to validate that its services are enabled and the database is accessible. Several example PowerShell scripts for Windows are available for you to download from the Datto Downloads page; you can also develop custom scripts.

Procedure

You can configure backup verification scripting by navigating to the Protect ? Configure Agent Settings ? Verification ? Backup Verification section of the Datto appliance GUI. Use the Upload Scripts button to add the scripts to the protected agent's profile, as shown in Figure 1. Upload the scripts in the order in which they need to run. The scripts will run during the agent's scheduled screenshot verification window.

There are three script verification templates available for download at https://downloads.datto.com/#script-verification-templates, which you can use to create your own scripts. They are:

  • CheckDatabase: Validates that a designated table in a database returns a specified number of rows.
  • Check Web App: Validates that a web application is running, and returns the app homepage.
  • Check Service: Validates that a designated Windows service is available upon boot.

NOTE  For Linux agents only: create the scripts in the Linux environment itself, or remove the CRLF characters from the script before implementing it. Otherwise, the characters will make the script fail to run.

After the verification script runs, and the screenshot completes, the Datto appliance will display the results of the verification in the Manage Recovery Points page of the device GUI, under the Screenshot Verification column. You will receive a "Script Succeeded," or a "Script Failed" message. Clicking the Show Log dropdown will provide more detail about the outcome of the script test.

Additional Resources