Some customers have reported an uncommon, but highly disruptive scenario in which a particular Notes document is corrupted 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 when 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 22.214.171.124 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 the ban is removed by an Administrator. The server will then be able to start and run normally. The only impact to the end user is that 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 BannedDoc show DocID UserID||Shows the specified banned document. DocID is the UNID or a noteID of a document.|
|Tell Traveler BannedDoc show * UserID||Lists all of the banned documents for the specified user.|
|Tell Traveler BannedDoc show *||Lists all of the banned documents on the system.|
|Tell Traveler BannedDoc Remove DocID UserID||Removes the ban for a particular document. DocID is the UNID or a noteID of a document.|
|Tell Traveler BannedDoc Remove * UserID||Removes the ban for all banned documents for the specified user.|
|Tell Traveler BannedDoc Remove * ||Removes the ban for all banned documents on the server.|
|Tell Traveler BannedDoc Add DocID UserID||Bans a particular document from syncing. DocID is the UNID or a noteID of a document.|
|Tell Traveler BannedDoc dump||Attempts 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