This section is specific to DriveWorks 23 onwards, for earlier DriveWorks versions please see DriveWorks Pro Server.
Pro Server can send Email Notifications when any connected DriveWorks Autopilot agent disconnects unexpectedly (for example when the machine hosting the Autopilot agent powers off).
Check this setting to enable Pro Server to send email notifications.
These settings control how often agents are monitored, when to resume monitoring and how many emails are sent.
This CRON expression defines when Pro Server should check for an Autopilot heartbeat.
CRON expressions are used to describe the timing of an event (checking for an Autopilot heartbeat).
The default value:
* * * * *
Will check for a heartbeat every minute.
For help setting up more complex schedules please see crontab guru.
DriveWorks Pro Server will classify a connection as failed after 2 minutes without a response.
The check heartbeat CRON expression result will begin after this time.
For example when the CRON expression is set to check every minute (the default), the failure notification will be sent between 2 and 3 minutes after.
The number of failed connection attempts before Pro Server sends a notification email.
The default value of 1 will send a notification immediately a failed connection occurs.
This setting is intended to prevent notifications being sent for events other than a computer crash, for instance a network drop that could correct itself.
If you experience frequent network drops consider increasing this value.
A CRON expression representing when to resume heartbeat monitoring after an email has been sent.
The default value:
* * * * *
Will resume monitoring one minute after the previous email has been sent.
The maximum number of emails to send out per agent before stopping the monitoring process.
The default value of 1 will send one notification only.
To resume monitoring an agent that has stopped, launch the failed DriveWorks Autopilot, log in to the required Group, and click Start.
Set the method of authentication to use to connect to the mail provider.
Choose from:
Select this if the mail provider is not Exchange Online (Microsoft 365).
Additional settings may need to be applied in the mail provider.
Select this if the mail provider is Exchange Online (Microsoft 365).
Pro Server uses a more modern SMTP Client than Email Settings (for Autopilot) to send emails using Basic Authentication.
Settings applied to allow DriveWorks Autopilot to send emails will be different to Pro Server Email Server Settings.
Please check with your mail provider for recommended SMTP settings.
Basic Email Authentication supports sending emails using SMTP (Simple Mail Transfer Protocol).
This allows the DriveWorks application to be configured to automatically send emails via a specified email server.
Basic authentication requires a username and password.
Ensure the mail server supports this method, as some providers are phasing it out in favour of the more secure OAuth 2.0.
Basic email authentication requires the following settings to be applied:
This is the name of the SMTP server which will be used to send the email.
For example:
Select from:
Please check with your mail provider for SMTP settings.
This is usually:
If a test email fails to send, and all other settings are correct, check with your system administrator as the port may have been blocked.
This is the username used to logon to the mail server.
This is the password used to logon to the mail server.
When using Gmail with 2FA see Two-factor authentication below.
Exchange Online supports sending emails via OAuth 2.0, which is Microsoft's recommended authentication method after the deprecation of basic authentication.
This allows secure, token-based authentication without exposing user credentials.
Before configuring DriveWorks, ensure the following is in place:
See Register an application in Microsoft Entra ID for more information.
See Grant admin consent for more information.
Exchange Online email authentication requires the following settings to be applied:
Enter the Tenant ID obtained from Microsoft Entra ID
Enter the Client ID obtained from Microsoft Entra ID
Enter the Client Secret obtained from Microsoft Entra ID
The email address for the account the notification will be sent from.
The email address to send the notification to.
Multiple addresses can be applied by separating each address with a semi-colon (;).
For example:
me@myemail.com ; you@youremail.com
The text to include in the subject line of the email.
The text to include in the body of the email.
The following special variables are available for use in the email body:
References the DriveWorks Autopilot agents name that cannot be contacted.
This will comprise of the following:
<domain>\<user>@<machine name>
References the machine running the agent that cannot be contacted.
References the user running the agent that cannot be contacted.
References the time the heartbeat that failed was requested.
This is given as the date followed by the exact time.
If the account has Two-factor authentication (also known as 2-Step Verification) an App Password will need to be generated in the mail account.
For Gmail:
Port
The Port number, when using 2FA for Gmail is 587.
To trigger an email notification a DriveWorks Autopilot Agent needs to unexpectedly fail.
To replicate a sudden crash, please follow the steps below:
DriveWorks Autopilot must be started for monitoring to commence.