Email Notification Configuration Examples

Name

Value
Your internal SMTP server hostname.

SMTP server

notify.smtp.enable-tls
notify.smtp.port
notify.smtp.username

N
25
Blank.

notify.smtp.password
Blank.

Table 15.7. SMTP configuration example: internal SMTP server (no authentication)
Name
SMTP server

notify.smtp.enable-tls
notify.smtp.port
notify.smtp.username

Value
Your internal SMTP server hostname.

N
25
A valid username for your internal SMTP server.

notify.smtp.password
The password for notify.smtp.username.

Table 15.8. SMTP configuration example: internal SMTP server with authentication
Name
SMTP server

notify.smtp.enable-tls
notify.smtp.port
notify.smtp.username

Value

smtp.gmail.com (or your Google Apps SMTP host)

Y
587
A valid Gmail (or Google Apps) email address.

notify.smtp.password
The password for notify.smtp.username.

Table 15.9. SMTP configuration example: Gmail

Name
SMTP server

notify.smtp.enable-tls
notify.smtp.port
notify.smtp.username

Value
smtp.gmail.com (or your Google Apps SMTP host)

N
465
A valid Gmail (or Google Apps) email address.

notify.smtp.password
The password for notify.smtp.username.

Name

Value

Table 15.10. SMTP configuration example: Gmail (alternate config)

Name

Value
Your internal Exchange server hostname

SMTP server

notify.smtp.enable-tls
notify.smtp.port
notify.smtp.username

Y
587
Variation of e.g. domain\username, username@domain, username

notify.smtp.password
The password for notify.smtp.username.

Table 15.11. SMTP configuration example: Exchange

Configuring Email Addresses

To send notification messages to users via email, an email address needs to be defined for the
user. User email addresses can be entered in the

User Details screen. However, if all email

addresses match the pattern [username]@yourdomain.com, then the email addresses can
be defined globally using the global email suffix. An example of how this works is as follows:
1. An email notification needs to be sent to user brian.
2. No email address has been defined in Brian's user details, but a global email suffix
of @myschool.com is defined in the Email

Options section.

3. To generate Brian's email address, the username (brian) and suffix

(@myschool.com) are combined to form the email
address brian@myschool.com.
To define the global email suffix:
1. Navigate to Options Notifications.
2. Find the Email

Options section.

3. Enable the Use

email suffix to build user email addresses option.

4. Enter the Email Address Suffix.

5. Press the Apply button.

To confirm that the email suffix is working as expected:

1. Navigate to the Users section.
2. Select a user from the list.
3. The Use

global email suffix option should be enabled, and the email field

should contain the address constructed from the username and suffix.