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 18.104.22.168 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.
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.
A setting of zero will disable crash protection. A restart of the Lotus Traveler server is required for the changes to take effect.
To administer the banned documents these additional tell commands have been added to the Lotus Traveler server.
|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.|
Lotus Traveler Maintenance Information
Lotus Traveler APAR Listing