|
|
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. A setting of zero will disable crash protection.
TODO - add setting
Administration
To administer the banned documents these additional tell commands have been added to the Lotus Traveler server.
Command | Description |
Tell Traveler BanDoc show | Shows all of the banned documents for a given user. |
Tell Traveler BanDoc list | List all of the banned documents. |
Tell Traveler BanDoc Add | This will ban a particular document from syncing. |
Tell Traveler BanDoc Remove | 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
http://www.ibm.com/support/docview.wss?uid=swg24019529
http://www.lotus.com/ldd/dominowiki.nsf/dx/Lotus_Notes_Traveler_APAR_listing |