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.
The defrag feature can only be run at startup using the steps outlined below. As of Lotus Notes
Traveler 220.127.116.11 and later releases, the defrag command will run automatically as part of database migration resulting from a server upgrade. Run the defrag command approximately once a month for optimal system health.
What is the Lotus Notes Traveler internal database?
Traveler maintains state information about each device in a Derby relational database. This information includes device information, device security and data that allows the Lotus Notes
Traveler server to know if a device needs to sync. This database's files are stored on the Lotus Notes
Traveler system in the data\traveler\ntsdb
directory. You can check the size of the folder and monitor changes as one way to determine how often to run the defrag command.
Do not delete the ntsdb
folder on the system. Deleting the state information forcse all users to resync their data, and you will lose all security information (such as devices that have been denied access or wiped and any documents that have been banned from syncing).
To run a defragmentation, perform the following procedure:
- Shutdown the Lotus® Traveler and the Domino® HTTP tasks on the server.
tell traveler quit
tell http quit
- Ensure both the HTTP and Traveler processes are completely stopped.
- Start Lotus Notes Traveler using the defrag parameter
- The defrag command runs as the server starts. The server normally starts once the defrag operation completes.
Note: The defrag operation may take more than 30 minutes to complete depending on database size and system capabilities.
- If the Domino HTTP task is not started automatically by Lotus Notes Traveler, then start it manually using the following command.
How to run defrag on a scheduled basis (18.104.22.168 and later releases)
1. Add NTS_DEFRAG_INTERVAL_DAYS to the notes.ini parameter. For example, to set an interval of 30 days add:
2. Restart the Lotus Traveler server. From that point on if Lotus Traveler server is restarted and it has been 30 days since the last defrag, then the defrag operation will run.
3. To force a defrag to run, simply delete the parameter NTS_LAST_DEFRAG from the notes.ini file and restart the server. If NTS_DEFRAG_INTERVAL_DAYS is set and there is no last defrag timestamp, then the server will perform a defrag and reset the NTS_LAST_DEFRAG timestamp.
For pre-22.214.171.124 details on how to schedule a defrag of the database, see this link.Parent topic: Administering Lotus Notes Traveler