The Upgrade Validation step verifies the Database Initialization Program (DIP) script output following minor, maintenance, and efix upgrades of the Teradata TDBMS component. Upgrade Validation is skipped during major upgrades and upgrades that do not include the TDBMS component. When errors are found in one or more DIP output files, a failure screen appears. Click the button on the failure screen to open a new window where you can view a detailed failure summary. The failure summary identifies each file that was checked and lists any errors that were found. You have the option to skip Upgrade Validation if an error occurs. When no errors are detected, the plug-in succeeds and moves immediately to the next step in the operation.
Supported DIP Options
The DIP utility creates an output file for each DIP option that runs. These files are stored in the /var/opt/teradata/tdtemp directory. Since DIPALL and DIPPATCH are mutually exclusive, you will always see output from one or the other, but never both, in the same run. The TDWM DIP script generates two output files when it runs. Both TDWM files include a timestamp that is always the same for both files. TDWM DIP was introduced in Teradata Database Release 13.10.
| DIP Option | Output File Name |
|---|---|
| DIPALL | dipall.txt |
| DIPPATCH | dippatch.txt |
| TDWM DIP | tdwmigrationlog timestamp.txt tdwmscriptlog timestamp.txt |
The CNS control node is where the DIP scripts are run and is the node where the output files are located. Upgrade Validation always validates all DIP output files located in /var/opt/teradata/support/DIPlogs/Last on the CNS control node.
PUTTools and the validate.pl Script
The validation script for each Teradata Database release is located in a corresponding directory in /opt/teradata/PUTTools. Within each of these directories is an IUMB_scripts directory that contains a number of version-specific scripts, including the validate.pl script used by Upgrade Validation. If the validate.pl script is not found, Upgrade Validation cannot run and will fail with an error indicating the script was not found.
Supported Teradata Releases
Handling Upgrade Validation Failures
When a failure occurs during Upgrade Validation, the Upgrade Validation Failed screen appears. Click the Display Upgrade Validation Failure Summary button to display the error summary in a new window. During an Upgrade Validation, DIP errors and setup errors can occur. You can skip Upgrade Validation and continue the operation no matter which type of error occurs. Upgrade validations cannot be retried, but the validation can be restarted using the table of contents if necessary.
| Setup Failure Error | Description |
|---|---|
| No DIP logs | DIP logs not found in /var/opt/teradata/support/DIPlogs/Last |
| No DIPlogs/Last directory | /var/opt/teradata/support/DIPlogs does not exist |
| No validate.pl | No validate.pl script, cannot run without this script |
| Process Manager Exception | The PUT process manager could not run the validate.pl script |