8.7. NET SatisFAXtion Gateway Installation Guide. For NET SatisFAXtion 8.7. Contents

Full text


NET SatisFAXtion Email

Gateway Installation Guide

For NET SatisFAXtion 8.7


© 2012 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.


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 3 POP/SMTP Email Gateway Install 7

Gateway Configuration 9

Service Administration Port 10

Select POP3 or SMTP Mode 11

Select either POP3 or SMTP. 11

POP3 Settings 12

POP Mailbox 12

Mail Server 12

Advanced 12

SMTP Settings 13

Configure Gateway Options 14


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.

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: Updating the POP3 gateway will occur automatically as part of the NET SatisFAXtion 8.7 upgrade. If the SMTP gateway is detected, the 8.6 version will be left in place during the upgrade process. Once the upgrade is complete, and you have installed the Microsoft Virtual SMTP Server, you can update the SMTP gateway by installing it from the LaunchPad.


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).


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:

• Uncheck “Limit message size”

• Uncheck “Limit session size”


POP/SMTP Email Gateway Install

Return to your servers launchpad website to download and install the email gateway.

Click next

Change the directory if needed and click next


Click install to complete installing the necessary files.


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)


Service Administration Port

This port must be available for use exclusively by the gateway for administration and logging.


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)


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


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.


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.


Configure Gateway Options

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

• Include original attachments that were submitted to be faxed.

Additional Attachment options

• Use confirmation page formatting for fax image attachments. A thumbnail of the first page of the sent fax will be merged with relevant data about the delivery of the fax.

• Fax image attachments and confirmation pages can be attached in PDF rather than the default TIFF format.


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)

• RTF Cover generated even if the message body is blank.

• Send entire email contents as the cover page

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.

Automatically ad 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, if unchecked, will send an email rejection to a user if they do not already exist in the fax server’s user list.


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)


Enter credentials needed for simple user authentication


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.

Attachment Settings

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


Link Settings

• Allows received faxes for email gateway users to be copied to a special location on a network share (if licensed for Export), and users will receive a link to the file in their received fax email, rather than an attachment.

• Saved To: The directory path where image data should be saved.

• Linked To: The link uri to be included in the email to the user.

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. The

‘Advanced…’ button can be used to specify TLS and authentication credentials if necessary.

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


Installation Complete

Click Finish

It can take several seconds to compile the workflows and start the Email Gateway Service.

Configuration Changes after installation

Once installed, to make configuration changes, go to the Start menu - Programs - NET SatisFAXtion and select Configure Email Gateway to rerun the configuration wizard.


Test connection fails to connect to the fax server URL


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 )



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

Copyright © FaxBack, Inc.





Related subjects :