How to apply patches for TDM
search cancel

How to apply patches for TDM

book

Article ID: 10931

calendar_today

Updated On:

Products

CA Test Data Manager (Data Finder / Grid Tools)

Issue/Introduction

This document will outline how to download files from a support case and apply patches for defects or enhancements for various TDM 

  • Typically, when a defect is found in the product, we can provide a patch (test build version) for the component experiencing the issue. For certain enhancement requests, we will also supply a patch. We will ask that you apply and test these patches in your own environment to make sure the issue is resolved.

  • We test all patches in our internal environments before providing them to customers, however, since these patches are not GA (General Availability) versions of the product, there is always a risk since they do not go through the rigorous testing, and regression testing that is normally completed with a GA release.

  • We highly recommend taking a backup of your old version installation directories and any other important artifacts before applying a patch.

  • If you are not comfortable applying a patch, you can always wait to upgrade to the next GA release.

  • All previous defect fixes and enhancements are rolled into the next GA version. 

Environment

CA Test Data Manager (TDM) 

Resolution

TDM patches are available for download from the Test Data Manager (TDM) Support Patches page.
Enter your Broadcom Support Portal credentials when prompted.

 

To Download Files from a Broadcom Support Case:

  1. Login to Broadcom Support Online

  2. Click on the ‘Enterprise Software’ icon.

  3. Click on 'Case Management' icon

  4. Look in your ‘My Cases’ tab or search for [Your Case number] in the ‘Search Cases’ tab.

  5. Click on the ‘Attachments’ -> ‘Manage File Attachments’ section.

  6. Login to https://supportftp.broadcom.com/ (if prompted).

  7. Click on the ‘files_from_broadcom’ link.

  8. Click on the file you need to download. 

 

Below are instructions on how to apply patches. Find the component the patch has been issued for, then follow the instructions to apply, along with any further instructions support has provided. 

Prerequisites:

  • User Permissions:  "Local Administrator" rights are required for Windows installations.

  • Environment Check: Verify that the patch version matches the base GA version before installing, unless you are intending to upgrade to a newer release. When patching TDM Portal, TDM Portal controls the GTREP schema upgrade. When the CA Test Data Manager Portal service first starts, it checks the GTREP schema version, and if needed, upgrades the schema. Therefore, if you unintentionally apply a TDM Portal 4.11 patch to a TDM 4.10 environment, and restart the service, your GTREP repository will be upgraded to a 4.11 schema. Once the repository is upgraded, there is no way to recover, unless you have taken backup before the installation. 
  • Impact Warning: Once the repository is upgraded by a Portal patch, older versions of Datamaker or Subset may no longer connect until they are also patched.

 

TDM Web Portal:

The TDMWeb patch contains a full rebuild install of the TDM Portal application. Running the installer will perform an upgrade to TDM Portal.

Note: The first time the CA Test Data Manager Portal service starts up, and connects to the GTREP repository database, TDM checks the schema version of the GTREP database. If the GTREP schema version is older than what is available from the patch, the GTREP schema is upgraded. Therefore, upgrading your TDM Portal version, may also upgrade your GTREP database schema.

  1. Have your DBA make a full backup of the GTREP database.

  2. Make sure everyone has logged off the TDM Portal application, and close the browser.

  3. Stop the CA Test Data Manager Portal Service, and ensure there are no orphaned java.exe tasks running in the Windows Task Manager.

  4. Stop the OrientDB Service.

  5. Take a backup copy of the following TDM Portal installation directories: By default, this is located at C:\Program Files\CA\CA Test Data Manager Portal.
    • C:\Program Files\CA\CA Test Data Manager Portal (at minimum make a copy of the conf and orientdb subdirectories)
    • %ProgramData%\CA\CA Test Data Manager Portal (at minimum make a copy of the orientdb subdirectory)

  6. Open a Windows File Explorer and navigate to %ProgramData%\CA\CA Test Data Manager Portal\logs and delete or archive all the files. This will ensure we have a fresh, clean set of logs to review in case there are any issues.

  7. Extract the TDMWeb-<build_release>.zip file in a temporary directory of your choice.

  8. As Administrator, double-click on the setup_ CA Test Data Manager Portal<build_release>.exe file to start the installation wizard.

  9. Follow the steps in the installation executable to upgrade the Portal.

  10. Re-start the Portal services. They should restart automatically, but it would be good to verify. If the services did not restart automatically, first restart the OrientDB service, then restart the CA Test Data Manager Portal service.

    Note: By default, the CA Test Data Manager Portal service is configured to start under the Local System Account. If your implementation of the "CA Test Data Manager Portal" Windows service should be running under a service account, you will need to:
    1. Stop the CA Test Data Manager Portal service
    2. Right-click on the CA Test Data Manager Portal service, and select Properties
    3. In the Properties dialog window, select the Log On tab
    4. Modify the properties to run the service under the appropriate service account
    5. Select OK, and close the dialog window.
    6. Restart the CA Test Data Manager Portal service.


  11. Open the Web browser and clear the browser cache.

  12. It may take several minutes for the TDM microservices to fully restart. You can monitor this by opening Task Manager and watch the CPU utilization of the machine. While the microservices are starting, you will see the CPU very high. Once the CPU utilization returns to normal, you can re-launch the Portal Page.

  13. Log into Portal and verify that the upgraded version is displayed in the lower left.

  14. Re-test issue.

 

Datamaker:

The GT Data Maker patch contains a full rebuild installation of the GT Data Maker application.

  1. Take a backup copy of your GTDatamaker directory folder. By default, this is located at C:\Program Files (x86)\Grid-Tools\GTDatamaker.

  2. Extract the contents of the GTDataMaker-<build_release>.zip into a temporary directory of your choice.

  3. As Administrator, double-click on the setup_GTDatamaker.exe to start the installation wizard.

  4. Follow the steps in the wizard to complete the installation.

  5. Open Data Maker

  6. Re-test the issue.

 

Subset:

The SubSet patch is not a full installation of the GT SubSet application, and only contains the patched files, which need to be replaced inside the GTDatamaker install directory.

  1. Take a backup copy of your GTDatamaker directory folder. By default, this will be located at C:\Program Files (x86)\Grid-Tools\GTDatamaker.

  2. As Administrator, extract the SubSet-<build_release>.zip file into the GTDatamaker directory folder.

  3. Restart Subset UI.

  4. Retest the scenario. 

Note: As known issues, during any Data Maker upgrade. Subset application configuration files will be lost. It is important to back up the configuration files before any Data Maker or SubSet upgrade or patch. These subset configuration files contain:  1) Rules files that store the logical relationships.  2) Connection profiles if default location was moved to Datamaker folder

 

Fast Data Masker (FDM):

The FastDataMasker patch contains a full rebuild install of the Fast Data Masker application. Running the installer will perform an upgrade to Fast Data Masker.

  1. Take a backup copy of your FDM directory folder. By default, this will be located at C:\Program Files\Grid-Tools\FastDataMasker.

  2. Extract the FastDataMasker-<build_release>.zip (Windows), or FastDataMasker-<build_release>.tar.gz (Linux) file, in a temporary directory of your choice.

  3. As Administrator, double-click on the ‘setup_FastDataMasker.exe’ installation file.

  4. Continue through the installation wizard steps to complete the upgrade.

  5. Restart FDM.

  6. Retest the scenario. 

 

Javelin:

The Javelin patch contains a full rebuild install of the Javelin application.

  1. Take a backup copy of your Javelin directory folder. By default, this will be located at C:\Program Files\Grid-Tools\Javelin

  2. Uninstall the previous release of Javelin. This can be done from the Windows Control Panel.

  3. Extract the Javelin-<build_release>.zip file in a temporary directory of your choice.

  4. As Administrator, double-click on the ‘setup_Javelin_<build_release>.exe’ installation file.

  5. Continue through the installation wizard steps to complete the new installation.

  6. Restart Javelin.

  7. Retest the scenario. 

 

TestMatch:

The TestMatch patch is not a full installation of TestMatch, and only contains the patched files, which need to be replaced inside the TestMatch install directory.

  1. Take a backup copy of your TestMatch directory folder. By default, this will be located at C:\Program Files (x86)\Grid-Tools\GTDatamaker\TestMatch.

  2. Extract the TestMatch.<build_release>.zip file into the GTDatamaker\TestMatch directory folder.

  3. Restart Datamaker, or TDM Portal (whichever you are using for TestMatch).

  4. Retest the scenario

 

Additional Information

Powered by Wolken Software