| Log Section | Description |
|---|---|
| System Readiness Check Results | Test results from SRC operations |
| Log files on this host | TDput operations that have recently been run on this system. The last entry in this section is the Port Manager Log |
| Service log files | Job and File Transfer logs from local and selected remote nodes |
| Times Reports | Timing (duration) information about operations run |
Log Files on this Host
Filter types are displayed in bold type.
Using filtered log view. To view all entries Click Here
TDput initially displays a filtered view with only WARNING and ERROR messages. The error displayed is often caused by an earlier choice or error, which may remind you of an earlier choice that resulted in the current error. Clicking the Click Here link expands the current view to display everything the sequencer log contains while keeping your view at the top of the file.
- This screen starts displaying at the “BEGIN: Gather Package Info” section of the log file; it does not start at the top of the log file, so you have to scroll down to find the error. This is the plug-in that had the error.
- Each BEGIN tag in the log file references the table of contents in the TDput operation currently running. Remember the “sequencer” process is producing all the messages in this log file.
The entries below describe a job or process being started on the node lion_bynet. The blue entries are links to the stdout (output) file and the stderr (log) file of this process.
- This is for job number 6014 and there is also a set of links for another job 6015.
creating job 6014 (Discover Available Packages) "discoverpackages -d "/AAA_pkgs/ v2r413_efix" -s 0 ) (job_service.cpp+1211) job 6014 view output file on lion_bynet (job_service.cpp+1230) job 6014 view log file on lion_bynet (job_service.cpp+1232)
To view the JOB output and log files for the jobs, Teradata recommends that you open these files in a new browser by right-clicking the link and choosing open in new window. Opening these log files in a new browser allows you to toggle between two windows (to see where you came from and the actual link you are viewing). It also leaves the main sequencer log file open so you do not have to reload it when going back to view it again. If you call support, this is what you need to have displayed on your PC, so that you can read the logs to support.
The view_output_file_on_lion_bynet contains anything printed to the stdout (output) file. In most cases this file contains information the job is producing to be used by either another job or the sequencer. In our current example, it contains all available packages found in either *.pkg (streams format), *.gz (scm Master.Src format), and *.Z (GSPATCH format) directory format.
The view_log_file_on_lion_bynet contains anything printed to the stderr (log) file. Since all log messages printed by TDput go to the stderr (log) file, all the log messages appear in this file. If this job runs on an OS utility, TDput will relay the output into this log file as well. In our example, pkgtrans is being run to convert some of the packages from streams format into directory format (so that we can obtain package-specific information such as version and dependencies). In general, when attempting to locate the source of a problem, the “log file” from the failing job is the place to start.
This error occurred while trying to run a utility “pkgtrans” on a package in stream format. You can cut the command line that is running and paste it into a console window. You see the same error output that was placed in the window. Further investigation on this example shows that the file PPDE.pkg is corrupt.
To determine the exact problem, drill down into the logs in a similar manner as the previous example. Click Logs (HTML Format) in the main PUT window to open the Logs & Reports screen.
Click the Install/Upgrade Software link.
If you had previous errors, you will see more summary sections. Below is an example of a single summary section. Scroll to the bottom to see the last summary section, then click the [Details] link to download the entire file (which takes a long time over dial-up or for a large system). You are automatically positioned at the beginning of the plug-in that has the failed job, so you may need to scroll down some more to find the Job Links.
You should see the following:
Scroll down to find the Job links for the failed job.
You see the Log File for the TDConvertJob on the node “lion.”
785 INFO: the command line is “/nssoft/tdsw/05.00.00.16/bin/postupgrade/ 0010.a.v2r5_pre_upg.pl” -c 04.01.03.57 -n 05.00.00.16 -p dbc,dbc (ProcessManagerUnix.cpp+184)
Notice that the error is telling us the script 0010.a.v2r5_pre_upg.pl had an error. Look at the output from this script. To do this, view one or both of the blue links in the picture above. Open this in the same window or a new window. Remember that a dial-up connection needs to reload the previous file when you go back. Opening in a new window allows you to have all the files open at the same time.
The output is displaying a usage statement. This implies that the arguments being passed to the script are incorrect. The -p argument claims it is optional. For upgrades using TDput, this argument is always passed to the script. The format for the argument is: COP/user/password. Since we removed the “ncrtdat” cop entry from our log-on string, the script is failing. The log-on string is replaced and the password changed to “bozo.”
The new log-on string in the dbs_logon_string.txt file is as follows:
LOGON_STRING=ncrtdat/dbc,bozo
This is the second type of failure seen for v2r4 to v2r5 upgrades. The dbc password is incorrect. In this example, the password has been changed to “bozo.” The correct password is the default, “dbc.”
The log windows have been closed. Click Retry in the Main TDput screen.
One of the status messages is “/usr/bin/sleep 360,” which is a message from the script which is run during the bteq logon. The script waits six minutes for the logon to occur. TDput does nothing and you wait for the script to finish.
This is a bteq log-on problem.
This last change is successful and the upgrade continues.