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

Contents

Online activation

The command line capabilities each have an auth  command which can be used to perform online activation of a license.

In order to do so you need to have been allocated a license in your Redgate account page.

You can then 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 a personal access token (PAT)

Instead of online activation, 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 environment variables:

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 either:

• into a file accessible to the user running TDM, with the fully qualified file path set in the REDGATE_LICENSING_PERMIT_PATH environment variable.
• into the REDGATE_LICENSING_PERMIT environment variable directly^*.

^* It is our recommendation that the file-based approach is used for offline permits because of a limitation in the Windows operating system that can result in environment variable values being truncated.