There are a few ways of activating your license for Test Data Manager and its capabilities.

Contents

Common step

In order to perform any of the below you need to have been allocated a license in your Redgate account page.

How to create environment variables?

1. In your Windows search bar, type in environment  and you should see Edit the system environment variables.
   • If you don't see it, press Win + R  and type sysdm.cpl, then navigate to Advanced  section.
2. Press Environment Variables... button.
3. To create a system environment variables, you can simply click New...  in the System variables  section.

Using a personal access token (PAT) (recommended)

A personal access token (PAT) can be used to supply a valid licence. To do this, you will first need to create a PAT.

To use the PAT, you will need to create two system environment variables:

How to create environment variables (Windows)

1. In your Windows search bar, type environment and select Edit the system environment variables
   • If you don't see it, press Win + R and type sysdm.cpl, then navigate to Advanced tab
2. Click Environment Variables... button
3. In the System variables section, click New... to create each variable as detailed above
4. Restart the Test Data Manager service:
   • Open Services (type services.msc in the Windows search bar)
   • Find Redgate Test Data Manager
   • Right-click and select Restart

Online activation (CLI tools only)

Each CLI tool has an auth  command which can be used to perform online activation of a license.

Run the auth command making sure to agree to the EULA by passing the --i-agree-to-the-eula  flag, and logging in on the page that opens in your browser.

Here's an example command-line to run the auth command:

rgsubset.exe auth login --i-agree-to-the-eula

This login will be cached locally for a day. When you run any other command for that capability it will be able to request a license using this login.

Using an offline permit

Licensing the UI or command lines where online activation is not possible can be done with an offline permit. If using an offline permit, you will not need to run the auth command.

To obtain an offline permit, you first need to have been allocated a license in your Redgate account page.

Then visit the licensing portal page for Test Data Manager where you will be asked to agree to the EULA and be presented with your permit.

The contents of this permit should be placed into a file accessible to the user running TDM, with the fully qualified file path set in the system environment variable: