Skip to content

Upgrade TestGen

This document provides the steps to upgrade an instance of DataOps Data Quality TestGen to the latest released version.

For a list of recent releases, see TestGen Release Notes. New releases of open-source TestGen are also announced on the #releases channel on Data Observability Slack.

Using dk-installer.exe on Windows

The instance must have been installed using dk-installer.exe, as outlined in Install on Windows.

  1. Download the latest version of dk-installer.exe.
  2. Run the upgrade option.
    1. From your Downloads folder, double-click the dk-installer.exe file to start the program.
    2. If a Windows protected your PC screen is displayed, click the More info link, and then click Run anyway.
    3. In the Choose a Product menu, type 1 for TestGen and press Enter.
    4. In the TestGen Menu, type 3 for Upgrade TestGen and press Enter.

Using dk-installer on Mac/Linux

The instance must have been installed using dk-installer, as outlined in Install on Mac/Linux or Install Enterprise.

  1. In the TestGen UI, check the Profiling Runs and Test Runs pages to ensure there are no actively running processes.

  2. Navigate to the directory used for the TestGen installation. This folder should contain the dk-tg-install.json marker file and the docker-compose.yml file for Docker installs.

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

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

  4. Download the latest version of dk-installer.

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

  5. Run the upgrade command.

    python3 dk-installer.py tg upgrade

Using Helm on Kubernetes Enterprise

The instance must have been installed with Helm, as outlined in Install on Kubernetes.

  1. In the TestGen UI, check the Profiling Runs and Test Runs pages to ensure there are no actively running processes.

  2. Refresh the DataKitchen Helm repository, so that the latest chart is available.

    helm repo update datakitchen-testgen

  3. In the values-tg-app.yaml file used for the installation, set the version to upgrade to.

    image:
  repository: datakitchen/dataops-testgen-enterprise
  tag: <version tag>

  4. Run the upgrade. The chart applies the database migrations as a post-upgrade job and replaces the pod with one running the new image.

    helm upgrade -n datakitchen dk-tg-app datakitchen-testgen/testgen \
    --values values-tg-app.yaml --wait

  5. Confirm that the pod has been replaced and is running.

    kubectl get pods -n datakitchen