System Configuration - Email Tab

The Enable Email Alarming checkbox must be enabled for emails to be sent for alarms. Note that on a new scan checking this checkbox will not result in ANY emails being sent. That is because, by default, no device will have its 'Send Email to Default User' checked. See Below.

Currently only device disconnect events will generate an email for those devices configured to send email.

The Seconds to wait ... edit box sets the number of seconds an email alarm will be delayed before transmission. At the end of the delay time, IntraVUE will check to see if the alarm condition is still valid. If it is, the email will be sent at that time. 30 seconds is the default setting.

The Email address to send ... field is the email address that will receive the email alarms for all devices.

The Reply to address... field is required when your SMTP server requires a valid email address. It is also the reply to address that will be on the alarm emails. This address may or may not have to be valid depending on your SMTP server.

The bottom section of this tab contains the data necessary to connect to the SMTP server that will be sending the email. The IntraVUE host computer must have access to this server for email to work.

In the Device Configuration dialog, there is a Enable Alarms To Default User checkbox. This is NOT checked by default. If checked the default user will get email for this device.

There is also a Enable Alarms To Device User checkbox. If you want an additional email sent to someone besides the default user, check the box AND edit the Send To field for the email of the person to get alarms for this particular device.

The Send Test Email button will immediately generate a test email using the settings IN THE DATABASE. If you make a change, select the APPLY button before selecting Send Test Email. This feature avoids having to disconnect a device just to test your email settings.

When you use the Test Email button and you do not receive an answer, there will be some text in an Exception message indicating the specific cause of the failure. For instance refused by SMTP host, invalid user name or password, etc.

This message is found in the scanner log file located at ...\intravue\log and will be the ivserver_(date)_(time).out file at the time you pressed Test Email.

A sample of what is generated is below. It was generated by doing a Test Email with the default Email Setup dialog. The stacktrace line "javax.mail.MessagingException: Unknown SMTP host: smtp.somewhere.com;" tells you that the SMTP host, the email service provider, is incorrect or that you can not connect to it.


0120 100016 event: Device 10.1.1.67 reconnected
0120 100054 event: Device 10.1.1.90 moved from 10.1.1.244:9 to 10.1.1.16:2
0120 100054 event: deleted child node at 10.1.1.244:9
0120 100111 event: 10.1.1.32 Ping Response Threshold Exceeded
0120 100122  received mod request send test email 0 0
0120 100122 send test email
0120 100123 EmailTask runs: Intravue has been instructed by the admin to send a test email. Please see http://10.1.1.59:8765/
 to [unused]
0120 100123 Unexpected Exception thrown - stacktrace follows:
javax.mail.MessagingException: Unknown SMTP host: smtp.somewhere.com;
  nested exception is:
   java.net.UnknownHostException: smtp.somewhere.com
   at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:1211)
   at com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:311)
   at javax.mail.Service.connect(Service.java:233)
   at javax.mail.Service.connect(Service.java:134)
   at javax.mail.Service.connect(Service.java:86)
   at com.sun.mail.smtp.SMTPTransport.connect(SMTPTransport.java:144)
   at javax.mail.Transport.send0(Transport.java:150)
   at javax.mail.Transport.send(Transport.java:80)
   at database.EmailTask.run(EmailTask.java:76)
   at java.util.TimerThread.mainLoop(Unknown Source)
   at java.util.TimerThread.run(Unknown Source)
0120 100146 device 10.1.1.67 disconnected
0120 100146 event: Device 10.1.1.67 disconnected
0120 100207 device 10.1.1.90 reconnected

Customizing the Email Message

The email message that is sent to the user can be customized using options in the ivserver.properties file.

The email subject line can be customized.to include the device name.
The email body for a device disconnected message can add the device name and link.
The ipaddress used to provide a link to the IntraVUE host can be changed to allow users requiring a proxy address rather than the real host address to reach the IntraVUE browser.