How to stop ongoing Directory Cache refresh in IceWarp

The Directory Cache stores information about mailboxes: their sizes, numbers of messages, etc. It is used to facilitate and speed up access to the database and file system. The data in the Directory Cache are updated (refreshed) after each change: creating a new email, editing a draft, receiving an email, etc. Additionally, by default each Friday before midnight (can be customized) the Directory Cache information about the /mail and /archive folders is refreshed in the background.

How long the Directory Cache refresh runs depends on the number of users, the size of their mailboxes, and the performance of the server. However, the Directory Cache refresh should not run for more than one day. To see when the Directory Cache refresh started or ended, go to the directory cache log: Status -> Logs.

Directory cache transfers all information to the WebClient Cache. The latter is used by WebClient to display the emails to users. If the Directory Cache refresh keeps running in a loop without success for more than one day, the users will not be able to see their emails. In this case, you need to end the process manually and refresh the WebClient Cache as well.

How to troubleshoot

1. Go to System -> Tools -> SQL Manager
2. Select Directory Cache from the dropdown
3. Type select * from directorycachejournal in the SQL box
4. Click Execute
5. You will see the table with all directory cache refreshes for the server. Find the unsuccessful one. Right-click it and select Delete
6. Restart all services:
   • Linux: go to the installation folder of the IceWarp server, use ./icewarpd.sh --restart command
   • Windows: restart all modules in Remote Console -> System -> Services -> click Restart All Modules button

To avoid unexpected malfunctions, we always recommend updating your IceWarp server to the newest version. You can find a detailed description of the IceWarp server update process in the following articles for Windows, Linux, and Docker.