Leapwork Trial to Enterprise Migration

Leapwork offers users three different types of Licenses i.e. Trial, Platform & Enterprise. In this article, we will learn how to smoothly migrate the Leapwork automation tool from a Trial Version to Enterprise Version.

Pre-requisites

1. Download the Leapwork software Click here

2. Download the Migration Tool Click here

3. Make sure the MSSQL server and SSMS are installed with all prerequisite access.

There can be two scenarios one can face while migrating to an Enterprise version of Leapwork:

1. Scenario1: Migrating to the same Leapwork version for Enterprise. E.g.: (Leapwork Trial Version 2021.1.501 to Leapwork Enterprise Version 2021.1.501)
2. Scenario 2: Migrating to an upgraded version of Leapwork Enterprise. E.g.: (Leapwork 2021.1.387 to Leapwork 2021.1.501)

In Scenario 1, there is no need to upgrade the Trial version and we can directly jump to “Backup Process”.

In Scenario 2, Upgrade the Leapwork version to the version on which we are migrating to the enterprise. (Recommended to follow a backup process before upgrading), after the upgrade please follow the process from "Step 1- Backup Process"

Step 1 - Backup Process

To prevent data loss and prepare for any unforeseen problems during the migration, we strongly recommend you perform a backup of Leapwork before starting the migration process.

Recommended Steps:

1. Export all the flows and save them.

2. Stop the controller service and take a backup of C:\Program Files\LEAPWORK\Assets folder, which has the SQLite database files. Refer to this article for backup best practices. Click here.

3. Save the encryption key for the database, including the admin password.

Step 2 - Uninstall the Trial Version

1. Uninstall the Trial version, Go to Control Panel – Program & Features

Select Leapwork and uninstall it

     2. Remove the folder C:\Program Files\LEAPWORK

*Note - Ensure you have taken the backup of the Assets before deleting this folder.

     3. Remove the LEAPWORK folder from the registry editor.

Path - Computer\HKEY_LOCAL_MACHINE\SOFTWARE\LEAPWORK

Step 3 - MSSQL Server Database user permissions:

1. Open SSMS. Connect to the SQL Server. 

2. Go to Security - Logins - Username, Right-click and go to the properties.

3. In Server Roles, the user must have dbcreator and public roles selected.

4. In User Mapping, the user should have a public role map with the master, asset & report database.

Step 3 - Install the Enterprise Version

1. Follow the steps listed in the following article - Click here

   Please open the studio and try to make any flow, save, modify &  delete just to confirm you have all the necessary permissions over the database created in the enterprise installation.

Step 4 - Migration Process

By default in the Migration Tool, the configuration tab will not be enabled. To enable follow the steps in the reference article -Click Here

1. Open the Migration Tool

   

   Encryption Key – Encryption key of Trial version database

   Username – MSSQL username

   Password – MSSQL password

   Server Address – Hostname or IP of the machine on which MSSQL is hosted/installed.

   Initial Catalog – Leave it as default “master”.

   Integrated Security – Leave it as default SSPI.

   Connection Type – Choose “Trusted Connection” if are using windows authentication for MSSQL, else choose “Standard Security” if you use SQL User authentication.

   Asset database name – Choose the database one you have created for Asset during enterprise installation.

   Report database name - Choose the database one you have created for Report during enterprise installation.

   Database – Select MSSQL.

   Click on Test Connection, if it’s successful, click on SAVE.

   Note – If you are using windows authentication for MSSQL, before performing migration go to services. Right on the LEAPWORK_CONTROLLER service, and go to properties, and go Log On Tab. Put the credential used to log on into the MSSQL Server.

    

   

Click OK, and restart the service.

2. Go to the Migration Tool, STOP the controller service on the migration tool, and go to Migration TAB.

3. Explore the “Assets” folder from the backup, select all the SQLite DB listed as shown in the above image.

4. Click on Migrate, a popup will appear for the encryption key. Enter the encryption key for the SQLite database saved in the backup process.

5. Wait for the Migration process to finish.

6. Click Configuration and start the controller service.

7. Launch Leapwork.

8. Click on the hyperlink and generate the license key for the Enterprise Version. Enter the license key and you are ready to use the enterprise version.