When certain Notes
® documents are corrupted or contain non-standard content, they can cause the Lotus Notes Traveler server to repeatedly crash as it tries to process these documents. A repeating crash prevention feature exists to help minimize Lotus Notes
® Traveler server outage in these instances.
This feature was first introduced in Lotus Notes
Traveler 18.104.22.168. It detects a repeat crash scenario for a particular document, then bans the document from being processed by the server. The document remains banned permanently unless cleared by an Administrator. The server then starts and runs normally. The only impact to the end user is that the banned document does not sync to the mobile device. Starting in Lotus Notes
Traveler 8.5.3 Upgrade Pack 1, the crash protection code only runs on the first three device syncs with a particular Lotus Notes
By default, the repeated crash protection is enabled and set to detect and ban a document after the third crash. The number of crashes before banning a document can be configured by changing parameters in the notes.ini file
. Both of these parameters are dynamic and can be set using the Domino
® set config
A setting of 0
disables crash protection.
This sets the number of device syncs on where the crash protection code is running when a user connects to a specific Lotus Notes
Traveler server. A setting of 0 will disable crash protection.
To administer the banned documents, the following additional Tell commands have been added to the Lotus Notes
Table 1. Additional Tell commands
Parent topic: Administering Lotus Notes Traveler
|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 IBM® support the documents in question for troubleshooting purposes. |