15.00 - Uninstallation Script Overview - Teradata Tools and Utilities

Teradata Tools and Utilities for Microsoft Windows Installation Guide

Teradata Tools and Utilities
March 2014
It is not necessary to uninstall previous versions of Teradata Wallet before you install another version of it.
Before you install a new version of Teradata Tools and Utilities packages, you must use the uninstallation script to uninstall previous versions of the packages. The script is on the installation media:
  • \Windows\uninstall_TTU.vbs
It creates a log file that contains a record of all of the steps taken during execution.
  • %TEMP%\uninstall_script_timestamp.log
msi logging is turned on during package installation from the media. The msi uninstallation log files are stored in the %TEMP% folder in the following file format:
  • uninstall_package_name_package_version.log

These logs provide useful information to support personnel if any issues are observed in the uninstallation of Teradata Tools and Utilities packages.

Run the uninstallation script before you do any of the following:
  • install a new version of a package
  • install a specific version of a package (a version other than the latest version)
  • decommission Teradata Tools and Utilities software on a particular system

In order to use Teradata Wallet, the version of the product that uses Teradata Wallet and the version of Teradata Wallet must match. This applies to the following products:
  • Teradata Call-Level Interface version 2
  • Open Database Connectivity (ODBC) Driver for Teradata

When you run the script, you can specify individual packages to be uninstalled. Teradata recommends that you uninstall the dependency products (CLIv2, PIOM, TDICU, TDODBC, and TeraGSS) last; however they can be uninstalled individually regardless of the order.

If a dependency product is uninstalled without reinstalling a new version, the products that depend on that product stop functioning. For example, if CLIv2 is uninstalled, all products that depend on CLIv2 stop functioning.
In order for the script to run, the command must include the PRODUCT parameter. Without it, the script displays usage information. The script supports two parameters:
  • /FORCE

As an argument to the script, a version can be specified using the /PRIORTOVERSION parameters (for example: /PRIORTOVERSION: The uninstallation script only uninstalls versions of the specified packages that are earlier than the version specified in the /PRIORTOVERSION parameter. When the /PRIORTOVERSION parameter is not specified, the default value is /PRIORTOVERSION:

The default behavior handles uninstallations of Teradata Tools and Utilities packages, except corrupted installations which are handled using the /FORCE parameter. When this parameter is specified, the uninstallation script performs an extensive registry search for all versions and components that were installed by a particular Teradata Tools and Utilities package. If the registry entries are found, the script deletes them. This parameter should be used with care because it takes time to search the registry for versions and components of a package. If multiple packages are passed as arguments, the script can take a long time to run.

When both parameters are specified, the /FORCE:TRUE parameter performs uninstallation and cleanup of only the versions of the packages that are earlier than those specified using the /PRIORTOVERSION parameter.

The script uses system packaging commands to uninstall packages, so it must be executed by an admin user (or by someone with admin privileges) .