WebMail PHP: logging as the main troubleshooting measure

MailSuite Pro MailSuite Pro MailSuite Pro WebMail Pro WebMail Pro WebMail Pro Windows Windows Windows Linux Linux Linux Admin Panel Admin Panel Admin Panel PHP PHP PHP error error error problem problem problem
If something goes wrong and you get an error or something doesn't work as expected, the most helpful troubleshooting measure is enabling logging, reproducing the issue and analyzing the log file. There are two types of logging.

General WebMail logging is used for troubleshooting in user area of WebMail. It can be enabled in Admin Panel / Services / Logging / Enable debug logging. For example, if you click a message in message list, but its text is not shown or you save your account settings, but something is not saved, you should enable logging, reproduce the issue and analyze the log file (or provide us with it for examination).

To avoid irrelevant records in the log file (may significantly complicate analyzing), it's important to enable logging right before reproducing the issue and disable right after that.

Another reason of appearing irrelevant records is simultaneous access of multiple users to the same WebMail installation. If hundreds of users working with your WebMail installation at the moment when you're capturing the log file, all their actions will be logged and it'll be not possible to distinguish between relevant and irrelevant records. So, you should make sure you're the sole user working with your WebMail installation for that moment.


Admin Panel logging is used for troubleshooting in Admin Panel (for WebMail Pro 5 or older versions only). To enable it, you should add enable=log parameter to Admin Panel index.php:

http://myserver.com/webmail/adminpanel/index.php?enable=log

Also, you can enable special debug section in your Admin Panel ("Additional Options" section) by adding enable=on parameter to the index.php:

http://myserver.com/webmail/adminpanel/index.php?enable=on

Admin Panel log is saved into logs/_admin_panel.log in the data folder of your WebMail installation.
Back to articles list