How to backup and restore Redtrust

Overview

This guide explains how to back up and restore Redtrust. This process is useful to prevent data loss as well as for testing and migration purposes, and it is intended for IT administrators. This guide assumes you have a basic understanding of Redtrust.

Step 1: Backup

There are different ways to back up a system, choose the one that better suits your needs.

Admin console

To obtain a backup of the unit using the admin console:

1. Access Redtrust admin console.
2. Go to System > Unit > Backup.
3. Click the Backup button. The file should be downloaded right after.

Wget

To obtain a backup of the unit using the terminal and Wget.

1. Execute the following command:

   wget --post-data --no-check-certificate 'userLogin=user@domain&password=USER_PASSWORD' https://DEVICE_IP/System/GetDirectBackup -O DESTINATION_FILE.bak 

2. Replace DEVICE_IP with the IP or hostname of the server from which you want to restore Redtrust.

3. Add the userLogin and password values.

warning

The user must have permissions to extract backups.

info

The --no-check-certificate option is required only if the system executing the command does not trust the server's installed certificate.

Powershell

To obtain a backup of the unit using the terminal and a Powershell script:

1. Create a getRedtrustBackup.ps1 file with the following content:

   [System.Net.ServicePointManager]::ServerCertificateValidationCallback = { $true }
   $postParams = @{userlogin='USER@DOMAIN';password='USER_PASSWORD'}
   Invoke-WebRequest -Uri https://IP_DEVICE/System/GetDirectBackup -Method Post -Body $postParams -OutFile DESTINATION_FILE.bak

2. Replace DEVICE_IP with the IP or hostname of the Redtrust server from which you want to restore the backup.

3. Add the user userlogin and password values.

4. Download a backup with this command:

   powershell -executionpolicy bypass -file getRedtrustBackup.ps1 

BackupRequester

To obtain a backup of the unit using the BackupRequester auxiliary tool:

1. Open a command line instance and execute a call to the provided application.

   Usage: rtserver=RTSERVER(without https://) username=BACKUP_USER password=BACKUP_USER_PASSWORD
   [output=OUTPUT_FILE] [overwrite=OPTION_SELECTED](1 = true, another value = false)

2. Specify the server address without specifying the protocol, user and password.

3. Optionally:

   1. Specify the output value with the file name you want for the downloaded file.
   2. Set the overwrite option to 1 to overwrite the file if it already exists on your device.

Step 2: Restore from a backup

In order to restore a backup of the unit:

1. Access the Redtrust admin console.
2. Go to System > Unit > Backup.
3. Click the Recovery file field.
4. In the dialog box, select the backup you want to restore and click Open.
5. Select Restore and Confirm. Add the password when prompted and then click Send.

The restoration process may take a few minutes. Once it is finished, you will see a green notification and you will be required to restart your session with your credentials.

Verification

CLI

You can verify the process using the command line.

To verify the backup file via the command line, you can use any program that allows you to upload the file to the unit. For example, with cURL, the request should follow this format:

curl --form upload=@fichero.bak --insecure https://DEVICE_IP/System/CheckBackup 

If the backup file sent is correct, the answer is OK.

warning

The service has a limitation to one request per minute.

BackupRequester

Backups can be verified using the BackupRequester tool by setting the op parameter to CHECK:

RTBackupCheck.exe rtserver=DEVICE_IP username=USERNAME@DOMAIN password=USER_PASSWORD op=CHECK input=BACKUP_FILE.bak 

If the backup file sent is correct, the answer is OK.

warning

The service has a limitation to one request per minute.

A list of errors can be found in the System documentation.