You are on page 1of 6

AudioCodes Fax ATA Connector Service

Quick Start Guide


Carrier/Enterprise Edition
July 16, 2011

Fax Machine

AudioCodes MP-202B
HTTPS Enabled Fax ATA

S TP HT

S TP HT

Fax Solution
HTTPS

AudioCodes Fax Connector

SMTP/POP3 (T.37)

Fax Server

PSTN

Abstract
This document contains all of the information required for a system administrator to install the AudioCodes ATA Connector Service for use with the HTTP(s) fax enabled AudioCodes MP202B HTTPS 2FXS ATAs. This release of the ATA Connector specifically targets T.37 enabled Fax servers and services used in enterprise environments.

1 ATA Connector System Requirements


The ATA connector was designed with the assumption that it would often be installed in a shared resource environment together with a Fax Server. When viewing the diagrams throughout this documentation please note that there are no restrictions preventing all of the components from all running on the same machine. System Requirements: Operating System o Windows Server 2008 and 2008 R2 (all editions, releases and service packs) o Windows Server 2003 (all editions, releases and service packs) o Windows 7 (all editions, releases and service packs) o Windows XP Professional SP2 and SP3 CPU 2.0 GHz or faster Intel or AMD processor RAM 1 GB RAM (200M Available) 100M Hard drive space Microsoft .NET 3.5 Windows PowerShell 2.0

1.1 Supported Fax Solutions


The ATA Connector was designed to communicate generically via SMTP / POP3 with T.37 enabled fax servers and services. The T.37 standard is very basic in its requirements. Fax servers and services must support faxing via SMTP {phone number}@{email domain} and must be able to support TIF Class F Fax image attachments. All servers and services compliant to these specifications should be able to work reliably with the connector. For full featured operation of the ATA Connector, the connector must be able to: 1) Detect if a received email is a received fax or a delivery notification. 2) Detect if a received email is a success or failure notification. 3) Determine the called phone number associated with the notification. The ATA Connector uses an open source PowerShell script to parse incoming emails, such that IT personnel will be able to customize the processing for any non-natively supported servers or services. The currently certified list is as follows: Certified Fax Servers: NET SatisFAXtion FaxBack RightFax - Open Text XMedius - Sagem HylaFax - Linux Open Source Faxcore Axacore

ATA Connector Service Administrators Guide

Page 1 of 5

Certified Fax Services: FaxSIPit EasyLink eFax - j2 myFax - Protus Fax2Mail - Premiere Global

2 Installation Overview
Getting the ATA Connector up and running is a multipart process: 1) Install and configure ATA Connector. 2) Create mail account on email T.37 compliant server. 3) Configure Fax server or service to enable new email account. 4) Configure ATAs to have email account info and location of ATA Connector All of these components must be installed and configured properly to create a fully operational system.
Fax Machine
AudioCodes MP-202B
HTTPS Enabled Fax ATA

S TP HT

S TP HT

Fax Solution
HTTPS

AudioCodes Fax Connector

SMTP/POP3 (T.37)

Fax Server

PSTN

2.1 ATA Connector Service Installation


The installation files for the ATA Connector are deployed in two different packages: 1) Download Image 2) CD Image The Download packaging is either as a .zip file or as a self-extracting .exe. The download installer does nothing more than create an installable image identical to what would be on the deployed CD. You must have Windows PowerShell 2.0 installed prior running the ATA Connector installation. Windows 2008 server will have this as a standard feature but for Windows 2003 it can be downloaded from: http://technet.microsoft.com/en-us/scriptcenter/dd772288.aspx. To initiate the installation of the ATA Connector, run the Setup.exe application in the root directory of the CD Image folder. This will invoke a prerequisites test which will upgrade the version of Microsoft .NET to version 3.5 SP1 if it is not already present. Note: On Windows 2008 Server you will need to add the Microsoft .net 3.0 or 3.5 feature before installing. The ATA Connector installation is a simple process with only 3 screens associated with the MSI installation phase. The MSI installer copies the files to the target path, creates and configures three Windows services and launches the ATA Connector Configuration utility in wizard mode.

ATA Connector Service Administrators Guide

Page 2 of 5

2.2 Initial Configuration


A unique 28 digit license key is assigned to each ATA Connector license. Failover and high availability configurations will use the same license key, but no two installations which are not directly connected to each other should share the same key. Installation may be blocked if a duplicate key is detected. The maximum number of ATA connections allowed per the license and the type of license will show below the key entry field once the key is entered and validated. The Settings panel defines global and default settings which will be applied to all connected ATAs. Call-Ahead Mode is used for allowing voice calls from the ATA and requires additional configuration. The default is Never. Before enabling this option please review the configuration requirements in the Administrators Guide. POP3 Polling Interval is the number of minutes between checks to see if new delivery notifications or received faxes are available. Note the ATA Client Connection URL as this will be used for the ATA to connect to the service. The Mail Server Settings panel contains the configuration data required for the connector to send/receive Faxes on behalf of the connected ATA. All user account information is maintained in the ATA, but all server specific configuration data is configured in this dialog. Depending on software version the available settings are different. Incoming Mail Server This is the mail server which will be polled for delivery notifications and received Faxes with the Enterprise edition. Each ATA has a separate account which will be queried on this mail server. Note if the port is not 110 it must be specified. Ex: gmail.com:995 Outgoing This is the mail server that will be used in the Carrier edition of the software for outbound only accounts. With Carrier edition, each ATA can be configured for its own individual mail server. On Enterprise edition, this is only configured once. Note if the port is not 25 it must be specified. Ex: gmail.com:587 The Web Administration gives you the ability to configure a username and password to access the server. You will need these credentials to manage the service. The default username is admin and the default password is admin.

3 Web Administration

This is the login screen of the AudioCodes Fax ATA Connector. It can be accessed by going to Start > Programs > ATA Connector > Administration or by browsing to http://<server>: 63/ where <server> is the name or IP address of the server that the ATA Connector is installed on. To log in use the credentials entered during setup.

ATA Connector Service Administrators Guide

Page 3 of 5

The home screen is displayed after logging in. The home screen gives a brief overview of the flow of traffic. It is also able to show a specific ATAs log in status. From here you will also be able to see if any specific services related to the ATA Connector are not responding. If the ATA Connectors connection server isnt working for example, it will have a red X through it. Your Product information including client count, expiration, connection URL, and version of the software are also displayed here. Clicking on the Accounts along the left brings up the ATA account Management screen. From here, accounts can be added, modified, and deleted. Clicking on Add to add account or Modify to modify the selected account will bring you to the next screen. Delete will allow you to delete the selected accounts. Deleting an account will permanently remove it from the database. When adding or modifying an account, each field on the ATA Account Setup is used for a different purpose. The Account Name and Account Password are the User Name and Password on the HTTPS Fax Connections tab of the MP202B. The Email information is the POP3 email box that the ATA Connector will poll for faxes that should be delivered to this specific ATA. Each ATA can have two inbound mailboxes/lines. Header Strip Count removes the fax header so that multiple headers aren't placed on faxes. Process inbound determines if you are able to send faxes to the ATA. The forwarding email is used for passing faxes to another email address instead of to the ATA. The mail server determines the inbound and outbound mail server that the account will use. The Queues section shows any faxes currently at the server waiting to be delivered to the ATA. This section is primarily for troubleshooting. The Logs section also falls under the category of troubleshooting.

4 ATA Setup
4.1 Finding the ATAs IP Address
In order to manually configure an ATA, the administrator must be able to connect to the configuration interface of the ATA, which requires finding its IP address on a network. The default behavior of the ATA is to obtain the IP address information via DHCP. There are three mechanisms for find the IP address of a specific ATA. 1) Lift the handset, dialing *2*#, and listening for voice prompt containing the IP address. 2) Connect another computer to the LAN port of the ATA and access IP: 192.168.2.1. 3) From the ATA Connector, list the Database records for connected ATAs.

4.2 Entering HTTP(s) Connection Information


Log into the ATA, you can find the IP address by following the steps in Section 4.1, and click on Voice over IP on the left. Select the HTTPS Fax Connections tab. Fill in the User Name, Password, and Server logon url. The User Name and Password are configured within the web administration when the account is created or modified. The Server logon url can be obtained from the Home screen within the web administration.

ATA Connector Service Administrators Guide

Page 4 of 5

4.3 Entering the PIN on the ATA


There are two standard methods for configuring the password for an ATA account. It is important to understand that this password is NOT the administrative password for accessing and configuring the ATA, but rather the password which will be provided to the mail service provider for accessing the ATAs designated mailbox. Methods for configuring fax account password: 1) Via HTTPS Fax Connections tab in ATA web configuration. 2) Via phone numeric keypad on the fax machine by dialing *1*{numeric password}#

4.4 Manual ATA Configuration


Log into the ATA, you can find the IP address by following the steps in Section 4.1 for logging into the ATA web configuration, and click on Voice over IP on the left. On the Signaling Protocol tab configure the following options: Use SIP Proxy: Check Proxy IP Address or Host Name: 127.0.0.1 Proxy Port: 5066 Use SIP Proxy IP and Port for Registration Uncheck Use SIP Registrar Uncheck All other options should be left at the defaults. Within the Voice and Fax tab please ensure that the following options are configured: Enable Silence Compression: Unchecked Fax Transport Mode: T.38 Relay Error Correction Mode: Checked Switch To Fax Only By The Answering Side: Checked On the Line Settings tab, enable or disable lines so that it matches the account configuration within the AudioCodes ATA Connector. After that is configured, edit the line(s) and set the User ID to be the DID from the account within the ATA Connector.

5 Contacting Support
Help for the AudioCodes MP-202B CPN:MP202B/2S/SIP/HTTPSFAX and the AudioCodes Fax Connector can be obtained through the following contact points. +1.503.597.5380 Monday Friday, 6:30am to 5:00pm Pacific Time (USA)
support@faxconnectit.com

Hardware support for any other AudioCodes devices should be obtained through the normal support channels of AudioCodes or your equipment provider. ATA Connector Service Administrators Guide Page 5 of 5