Configure Windows SMTP Server to Toss econtrol Notification Emails econtrol has the ability to originate notification emails for various modules. You need to either configure the email notifucations to use an existing email SMTP service to relay those notification emails, or you can add an SMTP email service to the Windows server hosting your econtrol web application server. Presumtions This KB article presumes that your econtrol web application server is hosted on a Windows 2008 server platform. This article includes Install the SMTP feature Configure and test the SMTP server Configuring the econtrol Email Settings Install the Windows SMTP feature The first task is to install the SMTP server feature. 1. From Server Manager, right-click Features and click Add Feature. 2. 1 / 15
In the Features section, check SMTP Server and click Next >. 3. You may see a dialogue box like the one below stating that certain role services and features are required for SMTP. 4. Click Add Required Role Services. 5. 2 / 15
In the Features window, ensure that SMTP Server is checked then click Next >. 6. In the Web Server (IIS) window, click Next >. 7. In the Select Role Services window, the applicable role sereices should be prepopulated IIS 6 Management Compatibility should be selected, and below it, IIS 6 Metabase Compatibility and IIS 6 Management Console should also be checked. Click Next > to continue. 8. In the Confirmation window, click Install. 3 / 15
9. In the Results window, click Close to complete the installation of the SMTP Server. 4 / 15
Configure the SMTP server Once the SMTP server is installed, it needs to be configured to relay notification emails from the econtrol host Windows server only. 1. 2. Open the IIS Manager 6 tool... Start > Administrative Tools > Internet Information Services (IIS) 6.0 Manager. Expand the server name, right-click the SMTP Server and select Properties. 5 / 15
3. In the General tab, unless you want the SMTP Server to use a specific IP address, leave the settings as they are so that the IP address is set to (All Unassigned). 6 / 15
4. In the Access tab, click the Authentication button and ensure that Anonymous access is checked. Click OK. 7 / 15
5. Once back in the Access tab, click on the Connection button. Select Only the list below and then click Add. Enter 127.0.0.1 as the IP addess and then click OK. Repeat the same steps to add the IP address for the econtrol server, e.g. 10.10.2.123. 8 / 15
The Connection setting controls which computers can connect to the SMTP server and send mail. By granting only localhost (127.0.0.1) access limits only the server itself the ability to connect to the SMTP server. Adding the IP address assigned to the econtrol server, this ensures that the SMTP server can relay email notifications from the econtrol web application hosted by IIS on that server. 6. Click OK to return to the Access tab and then click on the Relay button. Enter 127.0.0.1 as the IP addess and then click OK. The Relay setting controls which computers can relay mail through this SMTP server. By only allowing the localhost IP address (127.0.0.1) relay permissions it means that only the server itself can relay mail. Conversely, it prevents the SMTP server from being an open relay and being used to send unsolicited spam email by other computers on the internet, which could lead to the SMTP server being blacklisted. 7. In the Messages tab. enter an email address where copies of non-delivery reports are sent to. You can also configure the location of the Badmail director, however, the default setting should suffice. 9 / 15
8. In the Deliver tab, click the Outbound Security button and ensure Anonymous access is selected. As the only server that can connect and relay mail through the SMTP server is localhost this security settings is fine. 10 / 15
9. In the Delivery tab and then click on the Advanced button. 11 / 15
Enter the fully-qualified domain name of the SMTP server. This will be the host name or A record that has been created in your DNS zone file. This is straight-forward to do but you will have to confirm how you do this with the party that manages DNS for your domain. If you click on the Check DNS button you can confirm whether your chosen name resolves successfully. 10. Click OK and then OK again to exit the SMTP Virtual Server Properties. Test the SMTP Server You should test the SMTP server to confirm that it will toss email. 1. Create a text file on your desktop called email.txt and paste the following into it, remembering to change the email address information to reflect your own details. 12 / 15
2. 3. Save the changes to email.txt and then copy the file to C:\inetpub\mailroot\Pickup. The SMTP server monitors this folder and when it detects the email.txt file, it will read the contents and send the email to the address in the To: section. This should happen almost immediately. Check the mailbox of the recepient for the email. Configure the econtrol Email Settings The next step is to test that the econtrol web application can toss notification email messages. 1. 2. 3. Login into econtrol as a user with ADMINISTRATION panel access. Select OPTIONS > Advanced... > Email Settings. Configure the SMTP settings. Do not provide a username or password as the SMTP server is configured for Anonymous authentication. 13 / 15
4. Click the Sent test Email button. 5. Check the recipient mailbox for the test email. Your econtrol Windows server is now configured to used the installed SMTP server to toss notification emails for the econtrol web application. 14 / 15
Powered by TCPDF (www.tcpdf.org) Article ID: 1033 Last updated: 05 Oct, 2013 Revision: 1 ServiceControl -> econtrol 3 - FAQ, Tips and Tricks -> Server: How-to Tips -> Configure Windows SMTP Server to Toss econtrol Notification Emails http://kb.omni-ts.com/entry/1033/ 15 / 15