Troubleshooting

To run ActiveServer, it's required to have an existing WebMail Pro or Aurora Corporate installation, on the same or a different server, with DAV access configured correctly. DAV server configuration guidelines are available at:

Configuring DAV server

After setting up ActiveServer, with or without autodiscover feature, you can check its availability using Remote Connectivity Analyzer from Microsoft. It provides in-depth analyzis of which steps of the connection session were successful and what kind of errors occured.

It's possible to access ActiveServer installation with a variety of clients, as long as they support connecting to Exchange or via ActiveSync. Note that some clients (those on Mac OS, for instance) allow for connecting to Exchange accounts but it only works there via EWS, not ActiveSync. In case of such client, try accessing your account via IMAP/SMTP and CalDAV/CardDAV instead.

Debug logging

Logging is configured in main config.php file. By default, errors are recorded in the logs:

define('LOGLEVEL', LOGLEVEL_ERROR);

For troubleshooting purposes, you may need to change the log level, the most detailed logging is enabled with LOGLEVEL_WBXMLSTACK setting.

It's also possible to enable logging for specific user(s) only, that's done by supplying comma-separated list of users as follows:

$specialLogUsers = array('user1@domain.com', 'user2@domain.com');

Reloading sync data

ActiveServer backend stores sync data for the accounts. Upon making configuration changes, it may be not enough to delete and add an account on your device, purging sync data on ActiveServer side may be needed.

For that purpose, z-push-admin.php tool can be used, it's found in root directory of ActiveServer installation and is run with command-line PHP. Examples of its use are as follows:

// lists all registered users and devices
php ./z-push-admin.php -a list
    
// purges all sync data and registered devices for the user
php ./z-push-admin.php -a remove -u user1@domain.com

IMAP access

To avoid issues with SSL certificate check, backend/imap/config.php file contains the following setting by default:

define('IMAP_OPTIONS', '/novalidate-cert');

If that doesn't help, you may need to prevent switching to STARTTLS, that's done by adjusting IMAP_OPTIONS as follows:

define('IMAP_OPTIONS', '/novalidate-cert/notls');

Also, it's recommended to make sure the correct namespace for accessing IMAP folders is configured. Check IMAP_FOLDER_CONFIGURED configuration option, and configure the namespace options according to folder structure used by your mailserver.

SMTP access

If you experience issues with sending mail via SMTP, try adjusting $imap_smtp_params in backend/imap/config.php file. Note that if your server requires SSL access, you need to prepend ssl:// to server hostname.

By default, SMTP access is used, but you can switch to sendmail or PHP mail():

// Method used for sending mail
// mail => mail() php function
// sendmail => sendmail executable
// smtp => direct connection against SMTP
define('IMAP_SMTP_METHOD', 'smtp');

Can't get it to work with Outlook for Mac

Outlook for Mac does not support ActiveSync.