Installation
Published 16 October 2023
This page details everything you need to do to have a working version of the Redgate Test Data Manager GUI on your system. It is also possible to install individual CLI capabilities without the GUI, please see the relevant documentation.
Contents
Installation of Redgate Test Data Manager GUI
Before you begin
Please check our installation requirements.
Installation procedure
The GUI is shipped as a zip archive containing:
- A Windows executable
- A PowerShell installation script
- A yaml config file
To install the GUI, follow these steps:
- Download and extract the zip archive on the host machine
- Fill in all required fields in
config.yml
- Optionally: Update optional fields to match your environment
- Run
install.ps1
as an administrator- The script will ask you to provide login credentials. These will be used to configure the GUI as a Windows service, meaning it will restart automatically if the host reboots
The script will validate that your
config.yml
is correctThe script is digitally signed to prevent tampering. If you have not previously configured your machine to trust the publisher Red Gate Software Limited you will see the following warning. This is expected and not a cause for concern. You should select
R
to run the scriptSecurity warning Run only scripts that you trust. While scripts from the internet can be useful, this script can potentially harm your computer. If you trust this script, use the Unblock-File cmdlet to allow the script to run without this warning message. Do you want to run C:\Users\henry.wallis\Downloads\TDM_0.4.1.1550\install.ps1? [D] Do not run [R] Run once [S] Suspend [?] Help (default is "D"):
- Optionally: Restrict who can edit the config file by right-clicking the file, selecting properties, then selecting the security tab
After installation the GUI executable and the standalone CLI tools will be located in %PROGRAMFILES%\Red Gate\Test Data Manager\
You can explore different features of the GUI by following our guide.
Installation of standalone CLI tools
Apart from the centralized GUI, individual capabilities of Redgate Test Data Manager can also be installed as standalone CLI tools for integration with automated processes and integration with existing CI/CD pipelines.
Please follow the links below to the installation pages of each capability. Note that unlike the GUI, installation of Redgate Clone cluster is not a requirement for any of the CLI tools.