Configure email notifications

You can configure the appliance to send email notifications using an SMTP server.

The Notifications page allows you to specify SMTP server settings, and includes a set of email notification templates that you can edit or disable, as required.

1.	On the left navigation pane, click Settings > Control Panel to display the Control Panel, then click Notifications.

2.	On the Notifications page, click Email Notifications.

3.	On the Email Notifications tab, in the SMTP Settings section, choose one of the following options:

Option	Description
Use Onboard SMTP Server	Select this option if you want to use the internal SMTP server that exists on the appliance.
Use Offboard SMTP Relay	Select this option if you want to send authenticated email through an external SMTP relay. An SMTP relay allows you to route email traffic using a third-party mail server. • Relay Host. Type the fully qualified domain name of the SMTP relay host.
Use Offboard SMTP Server	Select this option if you want to use an external SMTP server, and specify the following settings: • Username. Type the email address of an account that has access to the external SMTP server, such as your_account_name@gmail.com. • Password. Type the password of the specified user account. • Host. Specify the host name or IP address of an external SMTP server, such as smtp.gmail.com. External SMTP servers must allow anonymous (non-authenticated) outbound email transport. Ensure that your network policies allow the appliance to contact the SMTP server directly. In addition, the mail server must be configured to allow the relaying of email from the appliance without authentication. If you specify an IP address, enclose the address in brackets. For example [10.10.10.10]. • Port. Enter the port number to use for the external SMTP server. For standard SMTP, use port 25. For secure SMTP, use port 587 (this is the default value). • Encryption. Click and select the encryption type that you want to use, as required: None (Insecure), TLS, TLS with Self-Signed Certificate (Insecure), SMTPS, or SMTPS with Self-Signed Certificate (Insecure). To test your configuration, in the Test Recipient field, type your email address, and click Send Test Email. After a successful configuration, the appliance sends an email to the specified email address, with Test Email from KACE Systems Deployment Appliance as the subject.

NOTE: If you leave any of these fields empty, and attempt to save your changes, a notification appears next to each field that requires input.

4.	In the Notification Templates section, review the list of available templates.

Option	The appliance sends this notification when..
Appliance Upgrade Available	An upgrade is available for your version.
Appliance Upgrade Completed	An upgrade is successfully installed.
Appliance Upgrade Failed	An upgrade started, but the installation failed.
Remote Site Appliance Sync Completed	A Remote Site Appliance (RSA) synchronization is successfully completed. If you have multiple RSAs, this notification is generated for each remote appliance.
Remote Site Appliance Sync Failed	A Remote Site Appliance (RSA) synchronization started, but it did not complete due to a failure. If you have multiple RSAs, this notification is generated for each remote appliance.
Driver Feed Updates Digest	A list of drivers that are new, updated, installed and updated, and automatically updated drivers that are already installed.
Deployment Started Digest	A deployment process starts. The notification includes a list of all applicable provisioned devices.
Deployment Completed Digest	A deployment is successfully completed. The notification includes the deployment start and end times, followed by a list of all applicable provisioned devices.
Scheduled Exports Digest	A scheduled package export is successfully completed. The notification includes a list of all exported packages.
Daily Appliance Status Digest	Detailed appliance information, sent on a daily basis. The notification includes the appliance maintenance status, support expiration date, the amount of time the appliance was in use, memory, storage, and network details, deployment activity, any linked RSA connection and update data, and a link to the detailed report.
Nightly Update Notifications	Details about nightly updates such as the driver feed version, driver feed revision, and the update status of each the following items: get/set computer name task, Media Manager, and KACE Image Prep.

5.

Optional. To change the appearance of the email contents, at the top of the Notification Templates section, under Email Styles, click Show, and in the field that appears, change the CSS style settings, as required. For example, you can change the text fonts, background color, or sizes, as applicable.

6.	If you want to edit a template, complete the following steps:

a.	In the Notification Templates section, in the row containing the template that you want to edit, in the Actions column, click the Edit Template button.

b.	In the email template dialog box that appears, make your edits, as applicable.

Option	Description
Email Subject	The subject of the email. You can use plain text or template variables, as required. You can use one or more template variables listed in the Template Variables field on the right. For more information about the template engine, click the link below the Template Variables field.
Recipients	One or more recipients the email is sent to. If any user emails are created on the appliance, they appear in the drop-down box as you start typing.
Email Body	The content of the email. The template uses a combination of template code, plain text, and template variables. See the Template Variables field for reference.   NOTE: The following line appears at the very beginning of the email body: {{appliance_email_styles|raw}}. Do not remove or change that line, otherwise the text formatting defined in the Email Styles section will not be applied to sent emails.
Enable Notification	To enable an email template, ensure this check box is selected.

c.	Click Save in the dialog box. Alternatively, to discard your changes, click Revert to Default.

The dialog box closes.

d.	To test the template, in the Notification Templates section, in the row containing the template that you want to edit, in the Actions column, click the Test Template button.

An email is sent to each recipient specified in the template. The names of any variables specified in the template appear in uppercase characters. They are not replaced with actual values because the related actions (such as deployments) did not take place when the test email is sent.

7.	On the Notification page, click Save.