Troubleshoot

Logging

MailScheduler keeps track of errors in log files. These log files can be viewed in the application and are also visible in the file storage on the machine.

• In the frontend, Click on About in the menu and click the pink System logs button. At the left there is a list of log files. The left part of the page shows the lines in the log files. Clicking on a line will open the details of the log item. There is also a download logs button that will compress all log files into a zip file for easy sending.

• On the filesystem in the directory where MailScheduler.exe is located, there is a directory .app-runtime/storage/logs which contains all log files.

When you encounter an error in the application, it is always helpful to send the logs with the support ticket so we can directly start investigating.

Application startup

When the application does not start, the cause can probably be found in the log files. they are located in <installation_path>/.app-runtime/storage/logs/*.log. When opening a support ticket, please provide these files.

Could not startup server, Contact Apps For Tableau support when the problem persists

The app server is unable to start. This can have multiple causes like:

• Application is configured as administrator but is currently not running with administrator privileges.

• Check if there is no other MailScheduler process running in the background. Open Task manager and select the Details tab. You should have only one process called MailScheduler.

• Check if there is no other process running on the port that is configured in MailScheduler. You can do that with this command in cmd:

netstat -aon

• Open power shell and navigate to the directory where MailScheduler.exe is located. run this command to manually trigger the application server:

./MailScheduler.exe serve

This command might give more details about what went wrong.

listen tcp :443: bind: Only one usage of each socket address (protocol/network address/port) is hormally permitted

When this error appears in your go-application.log it is not able to spin the server because the port you have configured is already in use by another program.

MailScheduler is slow or unresponsive

A typical reason of a slow experience is the connection to tableau. MailScheduler uses the REST API to fetch the visuals from Tableau. Each unique combination of filters will cause an extra request to tableau for fetching this information. On large mailing lists this can cause delay.

When the frontend for example is slow you can take a look at the application performance. Open Powershell and navigate to the directory where MailScheduler.exe is located. Run this command to see the statistics of the internal workers:

./MailScheduler.exe workers --interactive

This will generate an interactive statistics table like so:

Allowed memory size of xxx bytes exhausted

Big tasks can involve quite some memory. If you hit this limit you could increase the memory limit.

Increase the memory limit by altering the app.config.yaml file like so:

Note that the indentation in wbe.config.yaml matters! This image is from WriteBackExtreme, but the same applies to MailScheduler (you won't see writeback-extreme, but mail-scheduler in the file).