Upgrade Product Components

This section provides an overview on how to upgrade an existing  installation. The following upgrade paths are supported:
This section provides an overview on how to upgrade an existing 
Test Data Management
 installation. The following upgrade paths are supported:
  • 3.1.1 to 3.1.2
  • 3.1.2 to 3.1.3
  • 3.1.3 to 3.2
  • 3.1.3 and 3.2 to 3.2.1
  • 3.1.3 and 3.2.1 to 3.2.2
  • 3.1.3 and 3.2.2 to 3.5
  • 3.2.2 and 3.5 to 3.6
  • 3.5 and 3.6 to 3.8
  • 3.6 and 3.8 to 4.0
  • 3.8 and 4.0 to 4.1
  • 4.0 and 4.1 to 4.2
  • 4.1 and 4.2 to 4.3
  • 4.2 and 4.3 to 4.4
  • 4.3 and 4.4 to 4.5
  • 4.4 and 4.5 to 4.6
  • 4.5 and 4.6 to 4.7
    For upgrades to versions earlier than v4.8, please refer to this page in the specific version you need.
  • 4.6 and 4.7 to 4.8
Follow a supported upgrade path to avoid repository and licensing compatibility issues.
Change to upgrade procedure with version 4.8
Test Data Management
4.8 is the first version in which that you
upgrade the
repository from within the Datamaker software. It is now necessary to upgrade the TDM Portal in order to upgrade
To upgrade
Test Data Management
Portal, follow the instructions to Upgrade TDM Portal in Windows.
Upgrade options
The following 2 installers are available:
  • TDM Portal Installer
    This installer upgrades the TDM Portal software to the latest version (4.8). See Upgrade TDM Portal in Windows for more information.
    The first time you start the TDM Portal service after installation, the service also upgrades the
    repository. See Upgrade gtrep manually for information on an alternative method.
    If you upgrade
    , GTServer applications from a previous version
    do not function
    with the upgraded gtrep repository! For all TDM applications, the
    repository version must match the application version.
  • GTServer
    This installer upgrades the non-Portal components of TDM (Datamaker, GT Subset, etc). This installer
    does not
    upgrade gtrep.
    If you run this upgrade
    the TDM Portal service upgrades gtrep, the upgraded GTServer applications
    do not function
    ! For all TDM applications, the
    repository version must match the application version.
Backup gtrep repository
We recommend that you backup your
repository before you upgrade the CA TDM software.
This process varies depending on your database. Check with your Database Administrator for more information on how to proceed.
Upgrade the gtrep repository manually
From CA TDM 4.8, the TDM Portal service can manage the
repository upgrade automatically.
To disable the TDM Portal service's automatic upgrade of the
repository, uncheck the
Start CA Test Data Manager Portal service
option in the TDM Portal installer.
When you first run the TDM Portal service after installation, the service upgrades the
repository automatically if the repository is not for the correct version, or installs
if it is not present.
If you prefer to use the
Schema Management
tools provided to upgrade this repository yourself, refer to this guide.
Follow these steps:
  1. Ensure that the TDM Portal service is not active.
    You can check which services are active from the Windows
    dialog (click Start, Services).
  2. (Optional) To examine the files that the upgrade tool executes:
    1. Navigate to
      C:\Program Files\CA\CA Test Data Manager Portal\schema-management\bin\
      (in a default installation).
      This directory contains the compressed file
    2. Unzip
      to a temporary location.
      This compressed file contains the directory
      (oracle/SQLserver depends on which kind of database you use for
      This directory contains the individual files, that the
      file executes.
  3. To execute the
    1. Navigate to
      C:\Program Files\CA\CA Test Data Manager Portal\schema-management\bin\
      (in a default installation).
      This directory contains the file
      . You can use this batch file to migrate your existing gtrep entries to a new database.
    2. You can execute
      with the following arguments:
      • -m
        Migrate the data from your existing
        repository to the upgraded repository.
      • -i
        Shows what has been applied, and what will be applied by migration.
      • <none
        Without any argument, execution of
        displays help for the user.
Schema Management tool logs
The Schema Management tool logs changes to
. These logs are located at the following locations:
  • When the tool executes
    at TDM Portal startup
    C:\ProgramData\CA\CA Test Data Manager Portal\logs\TDMSchemaManagementStartup.log
  • When you execute the tool
    C:\ProgramData\CA\CA Test Data Manager Portal\logs\TDMSchemaManagement.log
Upgrade product components with the GTServer Installer
Prepare for Upgrade
Before you upgrade TDM components, we recommend that you backup your
repository. We also recommend that you backup configurations for each TDM component.
Back up all enabled 
Test Data Management
 configurations as follows, using the TDoD Config Editor as an example:
  1. Navigate to TDM_HOME\Grid-Tools\TDoD\TDoD_Config Editor and run TDoDConfigEditor.exe.
  2. On the Configure Server tab, click Backup.
    The config editor creates a backup of the configuration file, and a confirmation message appears.
  3. Back up other enabled config editors using the same process.
Other config editors that support backup are:
  • Remote Publish Engine
  • Rally Batch Service
  • HP ALM Service
  • Group Job Process Executor
  • HP ALM Batch Configuration Service
Perform the Upgrade
To perform the upgrade, it is necessary to download the software and install it on all systems where 
Test Data Management
 components exist. If you have 
Test Data Management
 components that are installed on multiple systems, you must run the upgrade on each system.
  1. Download the latest release from the Download Center on https://support.ca.com/.
  2. Extract the downloaded zip file on the systems where you want to perform the upgrade.
  3. Run setup_GTServer_
    • The GT Server installer detects the existence of all prerequisites and clears all prerequisite check boxes.
    • Select all 
      Test Data Management
       components that exist on the current system.
    • The GT Server installer upgrades each component by running the different component installers. For components that store configuration settings, the installer automatically takes a backup of your current settings and restores those settings after the upgrade.
  4. Repeat Step 3 on all systems that contain 
    Test Data Management
The GT Server installer creates installation logs in the Temp folder (%TEMP%). You can find the log files during both fresh installation and upgrade cases. A typical log file name has the following format:
For example, the GT HP ALM Service version creates a file named
GT HP ALM Service_1.2.3.4.log
in the Temp folder during installation.