Troubleshooting with Thunderbird
Resetting the connector
When malfunctions occur that cannot be resolved by simply restarting the software, the first step is to reset the connector: this operation resets synchronization and clears Thunderbird's browser cache.
It's as simple as this:
- go to connector preferences
- click on the "Reset" button:
- Exit by clicking on OK
Logs
Issues can be 2 types:
- Email issues (receiving/sending/synchronizing emails): these are problems with IMAP connection → check file
/var/log/bm/imap.log
- issues with contacts or calendar (missing data in Thunderbird or not synced to the web application, incorrect display, tab that does not open. .): These are problems with BlueMind connector → consult connector logs (see below)
Getting detailed logs of the connector
When problems occur without obvious cause (e.g. loss of internet connection), you need to enable the connector detail logging in order to get more complete logs that will give information about the routing of connector synchronization.
To do this:
- Go to connector preferences
- Check the "Enable debug logging" box:
- Confirm with the "OK" button
- Restart Thunderbird
Viewing connector logs
- Once the detailed logs are enabled and Thunderbird restarted (see above), return to the connector preferences
- Click on " Show Log... " to view the log file
If the interface is unavailable to access the logs, they can be found in the following locations:
- Linux (classic installation):
/tmp/BlueMind
. - Linux (installation via Flathub):
/var/run/user/1000/.flatpak/org.mozilla.Thunderbird/tmp/BlueMind
- Windows:
%TMP%/BlueMind
Viewing server logs
If an error stack appears in the connector log, see the /var/log/bm/core.log
log file on the server for more information.
Known problems
The calendar tab shows a blank page
If Resetting the connector (see above) is not enough to make the calendar reappear, then 2 solutions must be implemented:
Manually clearing integrated browser cache
To manually reset the cache, proceed as follows:
- type the keyboard shortcut
ctrl-maj-delete
to access the "Delete recent history" window - tick all boxes
- select "All" from the drop-down menu
- click on "Delete now"
- close then reopen the Calendar tab
Forcing cover cleaning
In addition to resetting and manually emptying the caches, Thunderbird can be forcibly cleaned:
- Close Thunderbird
- Open command prompt or computer terminal
- Use the following command row1 :
"C:\Program Files (x86)\Mozilla Thunderbird\thunderbird.exe" -purgecaches
For more information, see Thunderbird : Tips and Tricks > -purgecaches command-line option
- Delete local storage folder1 :
C:\Users\John\AppData\Roaming\Thunderbird\Profiles\c05tkj52.default\storage\default\https+++bm.bluemind.loc
- Restart Thunderbird
⇒ If none of these methods restore the schedule, you must implement detailed logging (see previous paragraph) and transmit the logs thus obtained to the IT department or BlueMind support.