IBM Support

How to clean up corrupt Domino server transaction logs after a failure

Technote (FAQ)


Question

Occasionally (typically after a server crash or backup application problem), archive-style transaction logs (.txn files) are not deleted or reused on a Lotus® Domino® server. How can these be cleaned up?

Answer

IMPORTANT NOTE: The procedure described below is safe for Domino; however, it does not take in to account the state of existing database backups. A full backup should be performed before taking this action. All database DBIID's will be changed. Consult your backup application documentation for the ramifications of changing DBIID's.

  1. Disable transaction logging for this server. This is done from the Domino Administration client by:

    • Open the server's Domino directory (names.nsf).
    • Locate this server's Server document.
    • Edit the Server document -> Transactional Logging tab -> Basics section.
    • Change the "Transactional logging" field to Disabled.

  2. Stop the Domino server and confirm that all Domino tasks have shut down by checking the Domino console or log. Depending on the OS, use the appropriate tools to verify the server shutdown cleanly.

  3. Start the Domino server and observe the message, "Transactional logging being disabled after this restart". Also notice that the task Domino uses for transaction logging (NLOGASIO on Windows, LOGASIO on other platforms) does not load and is not in the Task Manager list.

  4. From the operating system (OS), rename the transaction log directory. There should be no errors when doing this, as Domino is not using any of the files in the log directory any more.

  5. Stop the Domino server and confirm that all Domino tasks have shut down by checking the Domino console or log.

  6. Start the Domino server.

  7. Edit the Server document again and set the "Transactional logging" field back to Enabled. Save the Server document.

  8. Stop the Domino server and confirm that all Domino tasks have shut down by checking the Windows Task Manager.

  9. Start the Domino server and observe the message, "Please wait, creating new transaction logs in directory..."

  10. Notice that a consistency check is run on any open databases and a new DBIID is assigned. This occurs on each database as it is opened.

  11. Delete the old log directory (previously renamed).

Related information

How Do Transaction Logs Become Corrupt?
Transaction Logging on Domino Servers
A simplified Chinese translation is available

Document information

More support for: IBM Domino
Administration

Software version: 6.5, 7.0, 8.0, 8.5, 9.0

Operating system(s): AIX, IBM i, Linux, Solaris, Windows

Reference #: 1239792

Modified date: 26 July 2011