Good bug report is a key for fast bug destruction. Bad bug reports are usually ignored.

Examples of bad bug reports:

Generally, any report with words "some-*" and "just" is useless.

Good bug reports include exact versions of all relevant software: OS, DBMS servers, DBMS clients, replicator.

How to produce a good report

  1. Download debug version of ReplServer from this page
  2. Save generic Replserver.exe and replace it with downloaded debug one.
  3. Run ReplServer with '--debug' switch. This switch can be set in command line for application mode or in Windows' services management center for service.
    Check that debug log is produced - it is much bigger than usual one because it is full of names of called routines.
  4. Wait till the bug appear.
  5. Stop Replication server if it is still controllable.
  6. Send up to 20 last relevant lines from the log to support list (if Replserver "just hang").
  7. Gather all pieces of log file (if you configured separated logs for pieces of replication schema).
  8. If you used special debug build which includes Code Guard, get Code Guard log (ReplServer.cgl) as well.
  9. Pack them using your preferable archiver.
  10. On request, either send the archive to me or make it downloadable and send me URL.
    Don't send the archive to the support mail list because it is big and contain all secrets about your database.
    In some cases metadata-only backup of source DB for troublesome schema can be required.