Knowledge Base >> Configuring SMTP Mail Server for Outgoing Email

Configuring SMTP Mail Server for Outgoing Email - Confio Article 1524

Confio Article: 1524 Published: Nov 14 2008 1:15 AM
Version: 4.3+ Topic(s): Install and Setup
Product(s): Ignite
Database(s): Not Applicable

Background

Ignite has several features that send email including chart mailing, automatic report generation and alerts. To send email messages, Ignite requires connectivity to a SMTP mail server. Ignite includes an embedded mail server and also provides the ability to configure an external mail server.

The embedded mail server is typically sufficient for sending emails in most environments. However, there are some environments in which the server will be blocked from sending email due to firewalls and/or other SMTP restrictions.

 

Troubleshooting

If the embedded mail server is not able to send email within the environment that Ignite is running, either:

A. an external mail server must be configured as specified in this KB article, or

B. the host name of the Ignite server is not being resolved correctly (this could happen if the host name contains double-byte characters).  In these cases, refer to KB article 1613.

 

Mail Server Configuration

The mail server used by Ignite is configured through the mail.properties file located in the directory:

    <ignite_install_directory>/iwc/tomcat/ignite_config/iwc/properties

 The mail server configuration file contains the following properties: 

  • mail.domain - Mail server domain
  • mail.host - Host name or IP address of mail server (required)
  • mail.port - Port number of the mail server
  • mail.user - User name used to connect to mail server (if server requires authentication)
  • mail.password - Password of user used to connect to mail server (if server requires authentication)
  • mail.from - Return email address (required if mail server has restrictions on return addresses)
  • mail.embedded - "true" indicates that Ignite should use the embedded mail server exclusively

 

Additional properties that are required for a particular mail server may be added to the file.

This file may be changed while Ignite is running. The changes will be recognized within a few minutes. 

In Ignite 7.0 and later, you can check the logs ("Log" link on the main page) to see if your mail file changes were successfully taken (see below).

 

Mail Server Failover

When the Ignite server is started, the system checks the mail.properties file for a user-defined mail server configuration. If an external mail server has been specified, a connection test is performed to that server. If the connection succeeds, all outgoing mail from Ignite will be sent using this server. If the connection fails, Ignite will default to the embedded mail server.

 

 

Tags: report server mail email smtp message contact Alert firewall mail.propertie configuring outgoing