Siebel Database Upgrade Guide for DB2 for z/OS > Reviewing the Siebel Upgrade Log Files >

Reviewing Siebel Upgrade Log Files for Errors

Upgrades: All upgrades.

Environments: All environments.

This topic is part of an upgrade process. See How to Perform a Siebel Database Upgrade.

Review the logs created when you run the Siebel Upgrade Wizard to verify that the upgrade process completed correctly and to identify errors that must be resolved. The log files might include errors that are expected and benign. You must compare any error messages found in the log files to a list of acceptable error messages, and correct any unacceptable errors.

Complete the following procedure to manually review log files for unacceptable errors.

To manually review the log files for unacceptable errors

1. Review the state.log file to see at what step the upgrade failed. This step can be traced back to the driver file. The state.log file is located in the following directory:

   Windows: SIEBEL_ROOT\LOG\process\state

   UNIX: $SIEBEL_ROOT/LOG/process/state

2. Print the errors file. The errors file lists the benign and expected errors you might find in the log files; you can ignore these errors. The errors file is located in the installation subdirectory:

   Windows: DBSRVR_ROOT\DB2390\errors.rtf or errors.htm

   UNIX: DBSRVR_ROOT/DB2390/errors.txt

3. Sort the log files in the following directory by date.

   Windows: SIEBEL_ROOT\LOG\process\output

   UNIX: $SIEBEL_ROOT/LOG/process/output

4. Open each log file, starting with the earliest, and search for errors. Starting with the earliest log file can shorten your research time.

   Log files are identified by the .log extension. Errors are either tagged with the word error or enclosed in square brackets [...].

5. For each error found, compare the error description against the list of acceptable errors documented in the errors file.

   The log files generated by the Siebel Upgrade Wizard (for example srvrupgwiz1.log) appear in the errors file as upgwiz1.log, upgwiz2.log, incrementing for additional log files. Identify errors as follows:

   • If you find the error in the errors file, it is acceptable and no action is required. Continue to review the errors found in the log file.
   • If an error appears multiple times in a log file, but only one occurrence of that error appears in the errors file, all errors of that type are acceptable and no action is required. Continue to review the errors found in the log file.
   • If a log file is not listed in the errors file, there are no acceptable error messages for that log file. You must correct the condition that caused the error before you rerun the Siebel Upgrade Wizard.
   • If you find an error that is not listed in the errors file, it is unacceptable. You must correct the condition that caused the error before you rerun the Siebel Upgrade Wizard.

     To help resolve unacceptable errors, view 477324.1 (Article ID) on My Oracle Support. This document was formerly published as Siebel Troubleshooting Steps 21. Common errors and how to resolve them are listed in this document. If the error is not listed or you cannot resolve it, create a service request (SR) on My Oracle Support. Do not proceed with the upgrade.

6. Repeat Step 5 for each log file.

Although unacceptable errors are rarely encountered, this review is critical. Certain errors, such as a failure to create indexes, can result in performance problems or anomalous behavior in Siebel Business Applications.

Related Topic

About the Siebel Upgrade Log Files