Skip to content

Install TestGen Enterprise

Enterprise

For a trial of our enterprise DataOps Data Quality TestGen software, contact a DataKitchen representative.

The dk-installer program installs DataOps Data Quality TestGen Enterprise as a Docker Compose application. This is the recommended installation mode, as Docker encapsulates and isolates the application from other software on your machine and does not require you to manage Python dependencies.

Prerequisites

  • Request access to the private enterprise Docker image from your DataKitchen representative.

  • To handle enterprise workloads, install TestGen on a Linux virtual machine with at least 4 CPUs, 16 GB memory, and 100 GB disk space, for example, t3.xlarge on Amazon EC2, c4-standard-4 on Google Compute Engine, or B4ms on Azure Virtual Machines.

  • Install the following prerequisites, and verify that their versions are supported.

Software Supported versions Command to check version
Python 3

Most Linux and macOS systems have Python pre-installed. On Windows, you will need to download and install.

Why Python? To run the installer.		 3.9, 3.10, 3.11, 3.12, 3.13 python3 --version
Docker + Docker Compose

Why Docker? Docker lets you try TestGen without affecting your local software environment. All the dependencies TestGen needs are isolated in its container, so installation is easy and insulated.		 Docker: 26.1, 27.5, 28.5

Compose: 2.38, 2.39, 2.40		 docker -v

docker compose version

How to install TestGen Enterprise

  1. Login to Docker with the credentials provided by your DataKitchen representative.

    docker login -u <username> -p <password>

  2. Create and navigate to a new install directory, e.g., "/testgen".

  3. Download the latest version of dk-installer.

    curl -o dk-installer.py 'https://raw.githubusercontent.com/DataKitchen/data-observability-installer/main/dk-installer.py'

  4. Run the install command, specifying the enterprise image.

    python3 dk-installer.py tg install --image=datakitchen/dataops-testgen-enterprise:v4

    The installation downloads the latest Docker images for TestGen and deploys a new Docker Compose application. The process may take 5~10 minutes, depending on your machine and network connection.

    For advanced options, see the Installation options section.

  5. Verify that you can log in to the UI with the URL and credentials provided in the terminal output. You can also find this information at any time in the dk-tg-credentials.txt file.

How to set up demo data

You can also use the installer program to seed TestGen with demo data for the Quick Start tutorial.

  1. Verify that the UI is accessible and the docker-compose.yaml file generated by the installation is present in the folder.

  2. Run the demo setup command. 

    python3 dk-installer.py tg run-demo

    In the TestGen UI, you will see that new data profiling and test results have been generated.

  3. Follow the TestGen portions of the Quick Start demo tutorial for a walk-through of the software.

Tip

To upgrade an instance of TestGen Enterprise to the latest released version, see Upgrade TestGen. For other post-install tasks, see Administer TestGen.

Installation options

  • --image: To install a specific version. The latest released version of TestGen Enterprise is installed by default. For a list of recent releases, see TestGen Release Notes. 

    python3 dk-installer.py tg install --image=datakitchen/dataops-testgen-enterprise:v<version>

  • --port: To specify a custom port. The TestGen application uses port 8501 by default. 

    python3 dk-installer.py tg install --port=<port>

  • --pull-timeout: To specify the maximum amount of time (in minutes) that Docker should be allowed to pull images. The installer uses a 5 minute timeout by default, and retries 3 times. 
    python3 dk-installer.py tg install --pull-timeout=<minutes>
  • --ssl-cert-file and --ssl-key-file: To enable SSL for HTTPS support by specifying local file paths to your SSL certificate and key files. 
    python3 dk-installer.py tg install \
  --ssl-cert-file=<path to cert file> \
  --ssl-key-file=<path to key file>
  • --no-analytics: To disable sending anonymous analytics data to DataKitchen. For more details, see Anonymous Analytics. 
    python3 dk-installer.py --no-analytics tg install

How to remove demo data

After completing the quickstart, you can remove the demo data from TestGen with the following steps.

  1. Verify that the UI is accessible and the docker-compose.yaml file generated by the installation is present in the folder.
  2. Run the delete demo command. 
    python3 dk-installer.py tg delete-demo