Error Messages and Error Logs

Error messages provide important information for identifying the cause of replication system failures. When a Replication Server or RepAgent error occurs, an error message is recorded in an error log.

Error messages are in a standard format; once you learn this format, you will be able to read and understand all Replication Server and RepAgent error messages.

Replication Server error messages are recorded in text files called error logs, or sent to the standard error output (stderr), which is usually a terminal window. In general, Replication Agent error messages are recorded in their own error logs, except for RepAgent error messages. RepAgent records RepAgent errors and all error messages returned by Replication Server (including CT-Library error messages) in the Adaptive Server error log. Data server error messages are recorded in the data server’s error log.

Multiple error messages can be generated by a single problem, and can be generated from any or all Replication Server components (including Adaptive Server, Replication Server, and RepAgent) that are adversely affected by the problem.

Replication Server and RepAgent can also print messages to the error log and to clients in several languages. Replication Server error messages appear in the language specified in the RS_language configuration parameter, while the Adaptive Server RepAgent uses the language specified in language.

• Checking for Error Messages in the Error Logs
  Check for and resolve error messages found in the error logs before checking for failures throughout your replication system.
• rs_init Error Log
  Symptoms and problems are usually recorded in the rs_init error log when errors occur during Replication Server set up or configuration.
• Replication Server Error Log
  Informational, warning, thread-terminated, fatal, and internal error messages from Replication Server are recorded in the Replication Server error log.
• Analyzing the Replication Server Error Log
  Analyze the Replication Server error log to determine the cause of the replication system failure.
• Replication Server Error Message Format
  Describes the Replication Server error message format.
• Example: Analysis of a Replication Server Error
  Examines a Replication Server error message block.
• RepAgent Error Message Format
  RepAgent error messages are recorded in the Adaptive Server error log using the Adaptive Server message format. These messages are identified by the string “RepAgent(dbid),” which appears in the first line of the message. Errors that you can retry are logged only once in the Adaptive Server error log.
• Example: Analysis of a RepAgent Error Message
  Examines a RepAgent Error message.