This section provides an overview on how to upgrade an existing CA 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
Follow a supported upgrade path to avoid repository and licensing compatibility issues.
This article provides a high-level upgrade process due to the sheer number of variables involved when implementing CA Test Data Manager. Variables include the number of systems with CA Test Data Manager components, the repository database type, and the number of enabled configuration editors. This article applies specifically to upgrades to the current release but does have a broader applicability to other supported upgrade paths.
Follow these steps to upgrade your CA Test Data Manager installation:
Prepare for Upgrade
To prepare for the upgrade, ensure that all necessary data is backed up and enter your license request, if necessary. If you have already migrated to the new licensing scheme introduced in CA Test Data Manager 3.1.2, you do not require a new license. You can simply reload the license after upgrade until it expires.
Starting with 3.2.2, the upgrade process automatically backs up all product configurations before the upgrade and restores those configurations during upgrade. Therefore, Step 2 is not required for upgrades to 3.2.2 unless you want to create your own backups for extra security.
- Back up your repository database.
This process varies depending on your database. Check with your DBA.
- (Optional) Back up all enabled CA Test Data Manager configurations as follows, using the TDoD Config Editor as an example:
If enabled, other config editors that support backup are:
- Navigate to TDM_HOME\Grid-Tools\TDoD\TDoD_Config Editor and run TDoDConfigEditor.exe.
- On the Configure Server tab, click Backup.
The config editor creates a backup of the configuration file, and a confirmation message appears.
- Back up other enabled config editors using the same process.
- Remote Publish Engine
- Rally Batch Service
- HP ALM Service
- Group Job Process Executor
- HP ALM Batch Configuration Service
- (Optional) Request a license for your upgrade using a Customer Care Case Request: https://support.ca.com/irj/portal/anonymous/customercare.
This request is only necessary if you are upgrading from an older version or if your license is expiring. Licenses from 3.1.2 and later are reusable with your upgraded software until they expire.
Provide your Enterprise Site ID, Product Name (CA Test Data Manager), and release number.
When the request is processed, you receive an activation key. If needed, we recommend that you request the license before performing the upgrade to account for the license turnaround time.
Perform the Upgrade
Perform the upgrade by downloading the software and installing it on the systems where CA Test Data Manager components exist. This process varies depending on the nature of your installation. If you have CA Test Data Manager components that are installed on multiple systems, run the upgrade on each system.
- Download the latest release from the Download Center on CA Support Online.
- Extract the downloaded zip file on the systems where you want to perform the upgrade.
- Run setup_GTServer_version.exe:
- The GT Server installer detects the existence of all prerequisites and clears all prerequisite check boxes.
- For components, select all CA Test Data Manager components that exist on the current system.
- The GT Server installer upgrades each component by running the different component installers. Retain all default selections. For components that store configuration settings, the installer automatically takes a backup of your current settings and restores those settings after the upgrade.
- Repeat Step 3 on all systems that contain CA 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:
For example, the GT HP ALM Service version 184.108.40.206 creates a file named GT HP ALM Service_220.127.116.11.log in the Temp folder during installation.
Upgrade the Repository
After the CA Test Data Manager upgrade completes, upgrade the repository by renaming the rep.xml file, performing the upgrade, and renaming the file again.
Note: The rep.xml lets you store repository credentials so you do not have to connect every time. If you do not use a rep.xml file, you can skip the steps related to the file.
Launch Datamaker using the Desktop icon or through the file system (TDM_HOME\Grid-Tools\GTDatamaker\gtdatamaker.exe).
The following message appears:
DB version specified in database (3.1C) is invalid.
This version of the software can work with DB version 3.1B only.
You are connecting with pre-distributed details (rep.xml) - no upgrade is allowed.
Please contact support.
This message means that you have to upgrade the repository before proceeding.
- Navigate to the TDM_HOME\Grid-Tools\GTDatamaker directory, and rename the rep.xml file to rep-old.xml.
- From the Windows Explorer dialog, type %appdata% into the file path and select the Grid-Tools folder in the results. Rename the rep.xml to rep-old.xml in this folder. If the rep.xml file does not exist at this location, skip to Step 4.
- Launch Datamaker again.
The Test Data Repository log in for CA Test Data Manager dialog opens. It includes the repository profile that you selected in the last installation.
Click the green database connection button.
The following message appears:
Test Data Repository version specified in database (3.1B) is invalid.
This version of the software can work with Test Data Repository versions 3.2A and above only.
In order to run the upgrade you will need to know the user name and password of a user in the ADMIN group.
Would you like to attempt an upgrade?
Note that if you do not see this message, it is most likely that the user that installed the product is not performing the upgrade. If this is the case, you will need to create a new repository profile and provide the appropriate connection details. Check the entry for the new profile and click the green database connection button. You should then see the above message.
- Click Yes.
The login page opens.
- Log in with administrator credentials.
The CA Test Data Manager - Datamaker Repository Schema - Updates Required message opens.
- Click Yes.
The main Datamaker window opens.
- Select Settings, Enter Activation Key.
- Enter the activation key that you received from you license request, and click the Save button.
A confirmation opens. Click OK, and you should see a full listing of all connection profiles.
- Close Datamaker.
- Rename the rep-old.xml files to rep.xml in the TDM_HOME\Grid-Tools\GTDatamaker and %appdata%\Grid-Tools directories.
- Launch Datamaker again.
You should be able to connect successfully to any connection profile.
- Repeat the process described in Perform Repository Maintenance to verify that no further repository maintenance is required.
The upgrade is complete.
Upgrade the CA TDM Shredder Utility
For releases prior to 3.2.1, the CA TDM Shredder was a zip file included with the repository kit. For 3.2.1 and later, it is installed with the GT Server. To upgrade the CA TDM Shredder utility from a release prior to 3.2.1, follow these instructions:
Note: If you are upgrading from 3.2.1, the upgrade occurs automatically and these steps are not required.
- Navigate to the location where your old CA TDM Shredder installation is available.
- Take a backup of the following files:
- Open the old ..TDMShredder\conf\catdmshredder.properties file and compare it with the new ..TDMShredder\conf\catdmshredder.properties file.
- Add all the new parameters to the old ..TDMShredder\conf\catdmshredder.properties file and save the changes.
- Replace the old ..\TDMShredder\lib\TDMShredder-x.x.x.jar file with the file available in the new version.
You have successfully upgraded the CA TDM Shredder utility.