Extract Logs - Parallel Upgrade Tool (PUT)

Parallel Upgrade Tool (PUT) Reference

Parallel Upgrade Tool (PUT)
Release Number
February 2020
English (United States)
Last Update
Product Category
Teradata Tools and Utilities

The Extract Logs step lists all zipped files PUT finds. If no log files were found in the previously-specified directory, an error is reported. To correct this error, place the target zip file into the directory specified earlier and click Retry.

PUT only looks for files that begin with Logs and end in .zip.

Every zipped file found is selected for extraction by default. Clear the selection of any files you do not want to extract. You have the option to add a label to identify a log, but it is not required. When all selections and labels are complete, click Extract selected logs.

If no errors are encountered during the extraction, PUT activates the View Extracted Logs button which, when clicked, launches a browser window loaded with the newly extracted logs.

Manual Log Extraction

After the log files are collected, transfer the zipped file (/var/TDput/fileservice/Logs_date.zip) to a PUT node for analysis.

To expand the logs, run the utility LogCollectJob -e via the command line, as shown in the following example:


cd /opt/teradata/TDput/bin


LogCollectJob -e /var/opt/TDput/fileservice/Logs_2004.

This moves the zipped file to the /opt/TDput/web directory, expands the collected log files onto the node, and places them in the /opt/TDput/web directory. Once expanded, each selected node resides in its own directory in the format nodename@IPaddress. The master node has “$M” appended to its directory name.

When expanding, all previously-created log folders in the opt/TDput/web directory are removed before extraction. This is to eliminate the possibility of confusion between log files from different operation runs. If you want to recover a previous collection of log files, the Logs.zip file remains where it initially was located and can be expanded at any time.

Viewing the Expanded Log Files

If logs were extracted using PUT, click View Extracted Logs to open a browser window. If logs were manually extracted, or you simply want to view logs extracted in the past, open a browser window, point PUT to the node where the expanded files reside, and click Logs. To view the collected log files, add “&LOCAL” to the end of the web address in the browser. You are now viewing the collected log files.

If you select only a subset of nodes from all the nodes on which an operation was run, expect to see broken links while viewing the log files. Links exist only for nodes that were chosen for log collection.