This topic describes memory, thread, logging and other considerations for the performance of the IBM
® Lotus Notes
® Traveler server.
If you are running the Lotus Notes
Traveler server on a 32-bit Microsoft
™ operating system, then you may need to take steps to reduce the memory usage by the core Domino
® server. In this environment, dedicate the server to running Lotus Notes
Traveler and do not run other Domino
applications on it. You should reduce the amount of memory that Domino
pre-allocates to the shared memory buffer pool by adding the following line to the Notes
®.ini in your Domino
server program directory:
If this line is not present, then the Domino
server pre-allocates 512 MB of shared memory for buffers, which does not leave enough memory for other applications running on the server. To determine if your Lotus Notes
Traveler server is running low on available memory, see the Mem Show section of the topic Tell command considerations and examples
64 bit servers, increase the HTTP Maximum Cached users parameter to match the number of expected syncing devices. This value is present in the Domino
server document and can be changed using the Domino
Also, for 64-bit servers, you may need to increase the maximum amount of memory allocated for the Lotus Notes Traveler Java heap. This parameter is called Maximum Memory Size
and is found on the Lotus Notes Traveler tab of the Domino server document. By default, this value is 1024 MB. Use either the Tell Traveler Mem
or Tell Traveler Status
commands to determine if your system is close to the maximum heap available. More Java memory allows the Lotus Notes Traveler task to run more efficiently, but make sure that your server has enough physical memory to allow expansion of this value. If you are encountering 'out of memory' Java errors in the Lotus Notes Traveler task, then it is likely your Maximum Memory Size is set too low for the number of users that you are running.
As Lotus Notes
Traveler installations become larger and run for extended periods of time, the internal database will grow in size. This can affect system performance. You can defrag the database to compact and optimize its performance.
For detailed information on this topic, refer to Defragging the database for improved performance
HTTP server task must have enough threads to handle the number of HTTP requests from mobile devices accessing the Lotus Notes
Traveler service. You can adjust the number of HTTP server threads using the Lotus Notes
Administrator client and modify the server document for the Lotus Notes
Traveler server. In the server document, click Internet Protocol
, then click HTTP
and change the Number of active threads value.
To determine the optimal number of HTTP threads to allocate for Lotus Notes
Traveler, take the number of devices and multiply by 1.2. For example, if you have 250 mobile devices, then your HTTP active threads value should be at least 300 (1.2 times 250). The HTTP server task allocates all of these threads at startup time and keeps them active as long as the server is started. Do not over-allocate HTTP threads as this causes the Domino
server to run out of memory.
For more information on tuning HTTP threads, refer to Tuning active HTTP threads for Lotus Notes Traveler
Lotus Notes Traveler threads
Traveler is a multi-threaded Domino
task. Lotus Notes
Traveler threads are dynamically tuned. In most case the administrator is unlikely to have to change these values. If these threads values are tuned it is important to balance the number of threads added and the additional memory required to handle the extra threads. Threads within the Lotus Notes
Traveler server task are allocated only when needed, but when they are needed, there must be enough memory to allocate for the threads to start. Allocating too many threads can cause the system to crash due to out-of-memory errors.
The administrator can still manually tune the following thread pools:
- Sync threads - Determines if changes to user mail files must be synced to user devices (the default is 20 threads and is specified in <Domino data directory>\traveler\cfg\NTSConfig.xml as the values for TSS_PRIMESYNC_THREADS, TSS_SYNC_THREADS and WORKER_THREADS).
- Device sync threads - Syncs data between Domino mail servers and user devices (default is 5000).
- Worker threads - Used internally in the device synchronization process (default is 5000).
When debugging a specific problem, the Lotus Notes
Traveler server should only be run at a logging level of FINEST. For problems that affect all users, the overall level should still be FINEST. But if the problem is specific to only a few users, then run only those users at the FINEST level, leaving the other users at the system level.
By default, all Traveler log files are contained in <Domino data dir>/IBM_TECHNICAL_SUPPORT/traveler/logs
. If you want to move the log files to another location, modify the path information found in the /cfg/NTSLogging.properties
file. However, ensure that you place the files either under the IBM_TECHNICAL_SUPPORT
directory or outside the Domino
directory tree completely. Do not place the files in the Domino
directory tree except under the IBM_TECHNICAL_SUPPORT
directory tree. This is because, when starting or taking an NSD, Domino
views all files in the Domino
directory tree except for those under the IBM_TECHNICAL_SUPPORT
directory. As a result, startup and NSD times can potentially be long if there are numerous files in the Domino
directory. The Traveler logs, especially if the FINEST level is being used, can include numerous files.
The following Tell commands are available through the Domino
console, and allow a user to exist at a different logging level than the system. For example, the system could be set at the FINER level while the user could be at FINEST until you resolve and remove the problem (which would set them back to the system level of FINER).
|Log AddUser level user||Logs records for this user at the specified log level. This level overrides the system log level until this user is removed from the list.|
|Log RemoveUser user||Removes a user from the list of users that are logging at a level different from the system level. This use resumes logging at the system level. Remove all users by specifying *.|
Customizing Address Cache User Allowances
If you want to customize the maximum numbers of users allowed into the Address Cache, you can do so my modifying the NTSConfig.xml file. Look for the <PROPERTY NAME="TSS_ADDRESSCACHE_MAX_ENTRIES" VALUE="3000"/>
in the <COMPONENT COMPONENT_TYPE="TrueSyncServer">
section of the file. Depending on the data traffic, you may want to increase the max entries number to avoid a high number of look ups. Systemdump
includes this data, allowing you to determine if the cache is full, as well as which users are included.
Enabling session authentication
Performance can be enhanced by enabling single-server or multi-server session-based name-and-password authentication for web users. This allows the IBM Lotus Notes
Traveler client to log in once per session instead of logging in for each device-to-server communication. The session authentication parameter can be found by clicking Internet Protocols
-> Domino Web Engine
in the server document (if not using Internet site documents), or by clicking the Domino Web Engine
tab of the Internet site document for Web Protocol (if using Internet site documents).
Before enabling session authentication, make sure that you review the "Session Authentication" topic in the latest version of the Domino
Administrator documentation in this information center. Review the session authentication details, and make sure that it is the correct option for your environment.
Physical locations of servers
The utilization of high speed connections for servers is recommended. In addition, you should endeavor to physically place the Traveler servers as close to the mail servers as possible. Slow speeds across the connections can result in timeout errors.
Parent topic: Configuring Lotus Notes Traveler server