Upgrade Product Components

This section provides an overview on how to upgrade an existing  installation. The following upgrade paths are supported:
tdm48
This section provides an overview on how to upgrade an existing 
Test Data Manager
 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 Manager
4.8 is the first version in which that you
cannot
upgrade the
gtrep
repository from within the Datamaker software. It is now necessary to upgrade the TDM Portal in order to upgrade
gtrep
.
To upgrade
Test Data Manager
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
    gtrep
    repository. See Upgrade gtrep manually for information on an alternative method.
    If you upgrade
    gtrep
    , GTServer applications from a previous version
    do not function
    with the upgraded gtrep repository! For all TDM applications, the
    gtrep
    repository version must match the application version.
  • GTServer
    Installer
    This installer upgrades the non-Portal components of TDM (Datamaker, GT Subset, etc). This installer
    does not
    upgrade gtrep.
    If you run this upgrade
    before
    the TDM Portal service upgrades gtrep, the upgraded GTServer applications
    do not function
    ! For all TDM applications, the
    gtrep
    repository version must match the application version.
Backup gtrep repository
We recommend that you backup your
gtrep
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
gtrep
repository upgrade automatically.
To disable the TDM Portal service's automatic upgrade of the
gtrep
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
gtrep
repository automatically if the repository is not for the correct version, or installs
gtrep
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
    Services
    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
      TDMGtrepSchema.jar
      .
    2. Unzip
      TDMGtrepSchema.jar
      to a temporary location.
      This compressed file contains the directory
      /db/migration/gtrep/[oracle/SQLserver]
      (oracle/SQLserver depends on which kind of database you use for
      gtrep
      ).
      This directory contains the individual files, that the
      schema-management.bat
      file executes.
  3. To execute the
    gtrep
    upgrade:
    1. Navigate to
      C:\Program Files\CA\CA Test Data Manager Portal\schema-management\bin\
      (in a default installation).
      This directory contains the file
      schema-management.bat
      . You can use this batch file to migrate your existing gtrep entries to a new database.
    2. You can execute
      schema-management.bat
      with the following arguments:
      • -m
        Migrate the data from your existing
        gtrep
        repository to the upgraded repository.
      • -i
        Shows what has been applied, and what will be applied by migration.
      • <none
        >
        Without any argument, execution of
        schema-management.bat
        displays help for the user.
Schema Management tool logs
The Schema Management tool logs changes to
gtrep
. 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
    manually
    :
    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
gtrep
repository. We also recommend that you backup configurations for each TDM component.
Back up all enabled 
Test Data Manager
 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 Manager
 components exist. If you have 
Test Data Manager
 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_
    version
    .exe:
    • The GT Server installer detects the existence of all prerequisites and clears all prerequisite check boxes.
    • Select all 
      Test Data Manager
       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 Manager
     components.
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:
<componentname_version.log>
For example, the GT HP ALM Service version 1.2.3.4 creates a file named
GT HP ALM Service_1.2.3.4.log
in the Temp folder during installation.