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.

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

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

The contents of this permit should be placed in one of two locations:

1. Directly in the environment variable REDGATE_LICENSING_PERMIT (be aware that this may get truncated if you have licenses for lots of products as Windows has a maximum length for environment variable values).
2. In a file accessible to the required capabilities. The environment variable REDGATE_LICENSING_PERMIT_PATH then needs to have the full path to the file (recommended).