NET SatisFAXtion Email Gateway Installation Guide For NET SatisFAXtion 8.6 Contents 1.0 - Install Microsoft Virtual SMTP Server 2 XP and 2003 2 2008 and 2008 R2 2 Windows 7 2 Upgrade Path 2 Configure Microsoft Virtual SMTP Server 2 1.1 - POP/SMTP Email Gateway install 4 1.2 - Gateway Configuration 7 Service Administration Port 8 Select POP3 or SMTP Mode 9 Select either POP3 or SMTP. 9 1.3 - POP3 Settings 10 POP Mailbox 10 Mail Server 10 Advanced 10 1.4 - SMTP Settings 11 1.5 - Configure Gateway Options 12 Cover page options: 12 Delivery / Non-Delivery notification options 12 Whitelist / Blacklist Options 12 Automatically add users as needed for send fax requests 12 1.6 - Inbound fax to email delivery 13 Notifications and Inbound Faxes 13 SMTP Mail Server 13 Authentication 13 Inbound fax to email delivery - continued 14 1.7 - Attachment Settings 15 1.8 - Email Gateway Monitoring 16 Email Gateway Monitor Notifications 16 Mail Server 16 Limit repeat notifications to every: 120 minutes 16 Send Notification for 16 Installation Complete 17 2.0 - Configuration Changes after installation 17 Configure Fax to Email 17 Configure Email to Fax 17 2.1 - Troubleshooting 17 2.2 - Logging 18 8.6 2011 FaxBack, Inc. All Rights Reserved. NET SatisFAXtion and other FaxBack products, brands and trademarks are property of FaxBack, Inc. Other products, brands and trademarks are property of their respective owners/companies.
NET SatisFAXtion Email Gateway Installation Guide Page 2 Before installing, if you are going to use SMTP for outbound faxing (email to fax), you must install the virtual SMTP Server service first. If you are going to use POP3, skip to section 1.1. 1.0 - Install Microsoft Virtual SMTP Server This varies depending on Operating System. XP and 2003 Add or Remove Programs > Add/Remove Windows Components. Double click Application Server > double-click IIS > check the box for SMTP Service. 2008 and 2008 R2 Administrative Tools > Server Manager > Features. Click Add Features, and check the SMTP Server. Windows 7 Windows 7 does not include SMTP Service so it cannot receive emails via SMTP. POP3 must be used. In neither case do you want to install all of IIS, since the web server will default to use port 80, conflicting with NET SatisFAXtion web server. This will make NET SatisFAXtion fail to load. Upgrade Path Note: There is not an upgrade path from the current 8.6x and older email gateways. Make sure you gather the information from the current email gateway from your server s start menu - Programs - NET SatisFAXtion - SMTP or POP3 Email Gateway Setup. You should un-install the previous email gateway before installing the 9.0x email gateway. Configure Microsoft Virtual SMTP Server Administrative Tools > Internet Information Servers (IIS) 6.0 Manager Under Domains, right click on and rename the domain name to match the fax domain (for example fax.example.com).
NET SatisFAXtion Email Gateway Installation Guide Page 3 Right-click on the domain > properties. Make note of the Drop directory you will need it later (default is C:\inetpub\mailroot\Drop) Right-click [SMTP Virtual Server #1] > Properties. Go to the Messages tab. Modify the settings:
NET SatisFAXtion Email Gateway Installation Guide Page 4 Uncheck Limit message size Uncheck Limit session size 1.1 - POP/SMTP Email Gateway install Download and run NS-EMailGatewayUpdate.exe. This will install the NS-EMailGateway.msi to your servers {InstallationDirectory}\wwwroot\downloads folder and update the MSI to connect to your NET SatisFAXtion server. Once the MSI has been updated and written to the.\wwwroot\downloads folder, you can install it from this folder. (Typically C:\Program Files (x86)\net SatisFAXtion\wwwroot\downloads) Your servers Launchpad website will also be updated with the new email gateway.
NET SatisFAXtion Email Gateway Installation Guide Page 5 Click next Click next
NET SatisFAXtion Email Gateway Installation Guide Page 6 Change the directory if needed and click next Click install to complete installing the necessary files.
NET SatisFAXtion Email Gateway Installation Guide Page 7 1.2 - Gateway Configuration Once installed, the first configuration screen comes up The URL to your fax server should be auto-filled. If there is a password for the Supervisor user, set it and click test connection. This is needed to create the SMTPPost system user for the gateway. Make sure you get a Test completed successfully dialog back. If the test does not complete, make sure the NET SatisFAXtion fax server service is loaded and that you can reach the URL from a web browser. If this step fails, solve this problem before moving forward or the gateway will not be able to communicate with the fax server. (See troubleshooting section)
NET SatisFAXtion Email Gateway Installation Guide Page 8 Service Administration Port This port must be available for use exclusively by the gateway for administration and logging.
NET SatisFAXtion Email Gateway Installation Guide Page 9 Select POP3 or SMTP Mode Select either POP3 or SMTP. If you are using POP3: Check Use a mailbox POP3 and click Next. (Section 1.3) If you are using SMTP: Check Route mail to this server using SMTP and click next (Section 1.4)
NET SatisFAXtion Email Gateway Installation Guide Page 10 1.3 - POP3 Settings (If POP3 was selected you will see this screen) POP Mailbox Enter the email address, username and password Mail Server Enter the Server name or IP address of the POP mail server. If TLS security is needed, check this box and enter the port specified by the mail server. Typically port 110 without TLS, 995 when using TLS, but can be custom. Check with the POP mail server provider for the proper port Advanced Poll Interval (seconds): Default 65 seconds The default is set to 65 seconds because some mail servers will reject clients logging in and polling for new mail sooner than 1 minute. You can adjust accordingly.
NET SatisFAXtion Email Gateway Installation Guide Page 11 1.4 - SMTP Settings If only SMTP was selected, you will see this screen The Mail queue drop folder is read from the Virtual SMTP Server: C:\inetpub\mailroot\Drop Domain: The fax domain (for example fax.example.com). The same as you renamed the domain in the Virtual SMTP Server setup step.
NET SatisFAXtion Email Gateway Installation Guide Page 12 1.5 - Configure Gateway Options Cover page options: Default global options for cover pages: No Cover RTF Cover populated with email message body text (default behavior of previous gateways) Send entire email contents as the cover page Delivery / Non-Delivery notification options Send email notification on successfully sent faxes Sent email notifications on unsuccessful faxes Include the fax image in the notification email Whitelist / Blacklist Options Fax only files with these extensions - Only allow the sever to convert the specified file types. Example, only allow *.RTF, *.DOC, *.PDF All others will be ignored by the fax server. Ignore files with these extensions - (use instead of the whitelist) Server will ignore all file types listed but convert all other files.
NET SatisFAXtion Email Gateway Installation Guide Page 13 Automatically add users as needed for send fax requests This option checked, creates users if they do not exist when they send their first fax. Users are created based on their return email address and friendly or display name. This option unchecked, will send an email rejection to a user if they do not already exist in the fax servers user list. 1.6 - Inbound fax to email delivery Notifications and Inbound Faxes Email Address: This will be the email address Notifications and inbound faxes come from Email Display Name: This will be the Display or Friendly Name to identify the fax server the message comes from. SMTP Mail Server Specify the mail server or smart host the gateway will relay email messages through Select TLS as needed and specify the proper TLS port for your mail server or smart host (likely either 587 or 465) Authentication Enter credentials needed for simple user authentication
NET SatisFAXtion Email Gateway Installation Guide Page 14 Inbound fax to email delivery - continued Use the Sent Test Email button to test your email delivery settings. Make sure you receive an email to be sure all the above settings are correct. If the email message is accepted by your mail server or smart host, the following dialog is presented.
NET SatisFAXtion Email Gateway Installation Guide Page 15 1.7 - Attachment Settings File Name: Builds the name of the received fax attachment. There are several variable options and you can include any static text you wish, up to a total of 255 characters File Type: Select TIF or (if licensed for the PDF Converter) select PDF
NET SatisFAXtion Email Gateway Installation Guide Page 16 1.8 - Email Gateway Monitoring Email monitoring uses a simple SMTP send utility rather than the gateway to deliver your choice of critical errors and/or state changes in an email message to NET SatisFAXtion administrators. This helps to assure critical message delivery should the email gateway go down or is unable to communicate with the fax server or mail server. Email Gateway Monitor Notifications Enable or disable email Monitoring. Mail Server Select the mail server to send alert messages to. This might be a different mail server than is used by the email gateway itself. Limit repeat notifications to every: 120 minutes Set the frequency of error reporting for the same error. New errors will be sent immediately, then if repeated, will follow this rule. Send Notification for Critical Errors: Workflow State Change
NET SatisFAXtion Email Gateway Installation Guide Page 17 Installation Complete Click Finish It can take several seconds to compile the workflows and start the Email Gateway Service. 2.0 - Configuration Changes after installation Once installed, to make configuration changes, go to the Start menu - Programs - NET SatisFAXtion and select either Configure Fax to Email, or Configure Email to Fax. Configure Fax to Email Change email server, TLS authentication settings, TLS port, Fax Attachment name settings, select TIF or PDF attachment type. Configure Email to Fax Drop directory, Set POP3 mailbox settings, SSL/TLS authentication, SSL/TLS Port, Mail polling interval, Global Cover page defaults, Delivery notification options, Whitelist/Blacklist options, Auto Enroll options. 2.1 - Troubleshooting Test connection fails to connect to the fax server URL
NET SatisFAXtion Email Gateway Installation Guide Page 18 Check the following: NET SatisFAXtion service is loaded If installing the email gateway on a machine other than the fax server, test that you can get to the URL from a web browser (i.e. http://yourfaxserver/casdrive.api ) 2.2 - Logging To see the gateway logs, you can right click the Gateway loader icon in the system tray and select workflow manager, or select Monitor Workflows from the start menu (NET SatisFAXtion program group) To view the logs, click on the Log tab
NET SatisFAXtion Email Gateway Installation Guide Page 19