Anything that requires the sending of email within Smart Search requires that a SMTP server be input into "System Options" in the Administration Tab of GlobalSearch LAN. GlobalSearch CANNOT send emails over any sort of encrypted email protocol, including TLS or SSL (though it can receive mail over those protocols.) A client may be already using an SMTP server to send mail normally, in which case both GlobalAction and GlobalCapture should be able to natively send email over this connection. In other cases, an intermediate "Relay" may need to be used to act as a intermediary between GlobalSearch and an email server using an encryption protocol.
In the event a functionality test needs to be run to ascertain whether or not there is an issue with our mailer engine, a good way to determine the point of failure will be to setup a relay to see if the mail message handoff is successful.
Doing so is relatively simple.
Step-by-step guide
Installing a Local SMTP Server
1) Open the server manager and click on "Add Features"
2) Select SMTPServer and accept any required features that pop up
Click next all the way through and then finish the install
3) Once the installation is finished, open the IIS Management Console (This can also be found under Adminitrative Tools)
4) Once the management console is open, expand the server name on the left and open properties of "SMTPVirtual Server #1"
5) Click on the "Access" tab and then open "Authentication"
Make sure only "Anonymous Access" is checked
6) Click "OK" and then open "Connection" from the same screen"
Change the settings so "Only the list below" is selected. Click on the "Add" button and add "127.0.0.1" to the list under "Single Computer"
7) Click 'OK' to save these settings and then open "Relay" options from the same tab.
Make sure "Only the list below" is selected and then add "127.0.0.1" the same way you did in the previous step.
Click "OK" to save these settings and then click "Apply" and then "OK" to close the Virtual Server properties.
8) The last thing you need to do to configure the SMTP server is to set it to automatically start on boot. Go into the services manager and modify the "Simple Mail Transfer Protocol (SMTP)" service.
You should now have a functional local SMTP server. You can test to make sure it is working properly by following the instructions listed below. Don't forget to change the "System Options" within Smart Search to use "localhost" or "127.0.0.1"
Testing a SMTP Configuration
Once you have a local SMTP Relay Installed and configured, use Telnet to ensure that proper connectivity can be established.
Telnet
1) Ensure the Telnet Client is installed on the server. This can be found in the add/remove Features.
2) Follow the instructions HERE for testing an SMTP server via Teln
3) After confirming that the Telnet to the SMTP relay works properly, configure your GlobalCapture/GlobalAction to use the relay
4) At this point, the relay should receive mail messages. If it does, the application is performing the email handoff properly. If it is not able to communicate with even a local SMTP server, there is a configuration error and Square 9 Support should be notified.
Related articles