Overview

Some customers have reported an uncommon, but highly disruptive scenario in which a particular Notes document is corrupt or contains non standard content that will cause the Domino Server API to crash the Lotus Traveler server when trying to process the particular document. The problem is amplified by the fact that Lotus Traveler will detect the failed sync and retry the document once restarted. The problem generally resolves itself after some amount of time as the failing document is deleted by the end user, moved to a non-syncing folder, or simply moves outside the filter window for the particular user. However the problem can be quite disruptive to the Lotus Traveler service until resolved.

To minimize Lotus Traveler server outage a repeating crash prevention feature has been added. This feature is available in Lotus Traveler 8.5.2.3 and later releases. Essentially this feature will detect a repeat crash scenario for a particular document and ban the document from being processed by the server. The document will remain banned permanently unless un-banned by an Administrator. The server will then be able to start and run normally. The only impact to the end user is the banned document does not sync to the mobile device.

Settings

By default the repeated crash protection is enabled and set to detect and ban a document after the second crash. The number of crashes before banning a document can be configured by adding this parameter to the notes.ini file.

NTS_BAN_DOC_LIMIT=2

A setting of zero will disable crash protection. A restart of the Lotus Traveler server is required for the changes to take effect.

Administration

To administer the banned documents these additional tell commands have been added to the Lotus Traveler server.

Command	Description
Tell Traveler BanDoc show UserID	Shows all of the banned documents for a given user.
Tell Traveler BanDoc list	List all of the banned documents.
Tell Traveler BanDoc Add DocID UserID	This will ban a particular document from syncing.
Tell Traveler BanDoc Remove DocID UserID	This will remove the ban for a particular document
Tell Traveler BanDoc dump	Will try to dump all of the banned documents to DumpDoc.nsf. This should only be used if providing Lotus Traveler support the documents in question for troubleshooting purposes.

References

Product Documentation

Lotus Traveler Maintenance Information

Lotus Traveler APAR Listing