Articles in this section

See more

How to backup and restore LEAPWORK databases (version 2018.1 onwards)

Avatar
Praveen Kumar
  • Updated
Follow

Precondition

  1. It is recommended that you create a backup of your LEAPWORK database encryption key. The following article, How to migrate LEAPWORK Controller from one machine to other, explains how to create a database encryption key backup.
  2. To backup and restore your LEAPWORK databases, you must remember at least one admin user account password or create a secondary admin user account. Read more about the admin password here.

Introduction

The backup and restore feature is an essential safeguard for protecting critical data stored in your LEAPWORK databases. To minimize the risk of catastrophic data loss and to preserve data configurations, you should perform a back up your databases on a regular basis. A well-planned backup and restoral strategy for your databases can provide timely protection against the unforeseen:

  • Media failures
  • User errors
  • Hardware failures
  • Natural disasters

Cloud data storage solutions minimize the loss of data when compared to natural disasters affecting on-premise data. Additionally, database backups are useful for performing several routine administrative tasks, such as database migration, mirroring, and archiving.

What data should I backup?

The LEAPWORK Controller holds all data, such as flows, sub-flows, images, schedules, and locators, etc., in the form of multiple .sqlite database files. The Controller also holds automation runs containing test flow execution artifacts, similar to automation run video and screenshots. If you have sufficient disk space, it is recommended that you create a backup of everything under the assets folder, to include AutomationRunMedia.

Note: A backup of all .sqlite files is mandatory.

What is the backup procedure?

You can manually or automatically initiate the backup process using a PowerShell script.

Manual backup

To perform a manual backup:

  • Log in to the Controller machine
  • Stop the LEAPWORK Controller service:
    1. Press the Win+R key combination to open the Run dialog
    2. Type services.msc and press OK to open the Services window
    3. Find the LEAPWORK Controller and stop it by right-clicking the mouse button, then by clicking Stop.
  • Open File Explorer and navigate to the C:\Program Files\LEAPWORK folder
  • Copy the Assets folder
  • Navigate to your selected backup location
  • Paste the Assets folder and wait until the file copy process is completed
  • Start the Controller service:
    1. Press the Win+R key combination to open the Run dialog
    2. Type services.msc and press OK to open the Services window
    3. Find the LEAPWORK Controller and restart it by right-clicking the mouse button, then by clicking Start.

When finished with the previous steps, the LEAPWORK data backup is now complete.

Script-based backup

The script-based backup automatically performs the same process as the manual backup process. The following is an example of the script-based backup in PowerShell script:

##############################################################################################################
# LEAPWORK DATA BACKUP SCRIPT
##############################################################################################################

# Variables to be altered by user
# $assetsFolderPath- This is path to Assets folder in Controller machine- Change only if you custom path
# $backupPath- This is safe location where user should keep backup of Assets(Could be UNC/network path)
##############################################################################################################

Write-Host "Backup Process Started"
Write-Host "Step1: Stopping LEAPWORK Controller Service.."

$ServiceName = "LEAPWORK Controller"
Stop-Service $ServiceName

Write-Host "Step2: Check Controller Service State.."
do
{
Start-Sleep -Seconds 2
Write-Host "Getting the service status.."
$ServiceStatus = (Get-Service -Name $ServiceName).Status
Write-Host $ServiceName "-" $ServiceStatus
}
while ($ServiceStatus -ne 'Stopped')

Write-Host "Step3: Taking Backup.."
$assetsFolderPath = "C:\Program Files\LEAPWORK\Assets" #Path to Assets folder in Controller Machine
$dateTimeOfBackup= Get-Date -format "dd-MMM-yyyy-HH-mm-ss" #Date time to be added in the folder name to identify daily backup
$backupPath = "D:\Backup-$dateTimeOfBackup" #Path of safe location to backup Assets, it can be UNC/network path
Copy-Item -Path $assetsFolderPath -Recurse -Destination $backupPath

Write-Host "Step4: Backup Finished.."

Write-Host "Step5: Starting LEAPWORK Controller.."
Start-Service "LEAPWORK Controller"

Write-Host "Backup Finished !!"

##############################################################################################################

On a Controller machine, you can create a schedule using the Windows task scheduler to run the previously supplied PowerShell script, for creating a backup during a defined interval of time.

What is the Restore procedure?

The restore process copies data from a backup by converting the backup file into a database. Perform the following steps to restore your LEAPWORK databases:

Steps to Restore a Database

  • Navigate to your backup folder location
  • Copy the Assets folder from your backup folder
  • Log in to the Controller machine
  • Stop the LEAPWORK Controller services
    • Press the Win+R key combination to open the Run dialog
    • Type services.msc and press OK to open the Services window 
    • Find the LEAPWORK Controller and stop it by right-clicking the mouse button, then by clicking Stop.
  • Go to C:\Program Files\LEAPWORK folder and replace the existing Assets folder with the backup Assets folder, wait until the file copy has completed
  • Start the LEAPWORK Controller service
    • Press Win+R combination to open the Run dialog
    • Type services.msc and press OK to open Services window
    • Find the LEAPWORK Controller and restart it by right-clicking the mouse button, then by clicking Start.

After performing the previous steps, open LEAPWORK studio and verify that the data is present. You can also automate this process by creating a restore PowerShell script.

Note: It is suggested that you test your strategy by backing up and restoring databases, to better prepare you for any unforeseen disaster situations.

How often should I perform a backup?

The frequency in performing backups depends on how often automation flows and data changes.

  • Automation flows and data that changes frequently may be sufficient for hourly or daily backups
  • Automation flows and data that changes every few days may be sufficient for performing a weekly or monthly backup
  • For some data, a user may run your backup whenever you make a change

If you have any questions, contact our Priority Support.

Related articles

Comments

0 comments

Please sign in to leave a comment.