Configuring T.37 Store-and-Forward Fax
Fax pass-through is a method for sending faxes over IP networks. This chapter describes the configuration of T.37 store-and-forward fax on H.323 and Session Initiation Protocol (SIP) networks. It includes the following features:
-
Extended Simple Mail Transfer Protocol (ESMTP) Accounting in Store-and-Forward Fax
-
T.37 Store-and-Forward Fax
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Prerequisites for Configuring T.37 Store-and-Forward Fax
-
Ensure that your IP network is configured and operational.
-
Ensure that your system meets the requirements for store-and-forward fax and supported call-control protocols.
-
The T.37 on-ramp gateway requires the system to have at least 2 MB I/O memory and 8 MB process memory for a session. If either of these memory requirements are not met, the T.37 session will fail.
Restrictions for Configuring T.37 Store-and-Forward Fax
-
T.37 store-and-forward fax is not supported on Media Gateway Control Protocol (MGCP) networks.
-
For T.37 store-and-forward fax, Cisco does not support any encryption with the Simple Mail Transfer Protocol (SMTP) implementation.
-
Cisco fax gateways support only the TIFF format described in RFC 2301, File Format for Internet Fax , and RFC 2302, Tagged >Image File Format (TIFF)--Image/TIFF MIME Sub-Type Registration with Profile S. The TIFF header offset must be less than 1 KB and the header must be at the top of the TIFF page.
-
Cisco’s implementation of T.37 does not provide support for the optional Error Correction Mode (ECM) feature found on most G3 fax machines. ECM retransmits any corrupted scan lines that make up the image on the fax page to ensure that fax communications are received error-free. In networks with impairments, the lack of ECM support does not allow fax page information to be corrected. In some cases, this can lead to fax pages that have image quality issues, incomplete attachments in the fax e-mail, or even failure of the fax call.
-
SG3 faxes are not supported.
Information About T.37 Store-and-Forward Fax
The purpose of an on-ramp gateway in store-and-forward fax is to receive faxes from the PSTN or standard fax devices. The on-ramp gateway performs the following actions:
-
Converts a fax message into a TIFF file.
-
Creates a standard Multipurpose Internet Mail Extension (MIME) e-mail message.
-
Attaches the TIFF file to the e-mail message.
-
Forwards the e-mail message and attachment to the messaging infrastructure of a designated SMTP server, where the message is stored.
The on-ramp gateway uses the sending Message Transfer Agent (MTA) and dial peers to receive fax calls from the PSTN and to define delivery parameters for the resulting e-mail message to which the fax TIFF file is attached. MTAs define the following elements of e-mail messages to which fax TIFF files are attached:
-
Originator
-
Subject of the message
-
Destination mail server
-
Return path
-
Postmaster (default mail station for undeliverable messages)
-
E-mail header information
-
Address to which any disposition notices are sent
A DSN message notifies the sender of an e-mail message that contains a fax TIFF image about the status of that message. DSNs are automatically generated by the SMTP server and are described in RFC 1891, RFC 1892, RFC 1893, and RFC 1894. The following states can be reported to the sender:
-
Delay--Message delivery was delayed.
-
Success--Message was successfully delivered to the recipient mailbox.
-
Failure--SMTP server was unable to deliver the message to the recipient.
The on-ramp gateway security controls who can send fax messages over the packet network. On-ramp accounting keeps track of who uses the packet network resources and how long they use them. On-ramp security and accounting are facilitated by authentication, authorization, and accounting (AAA) security services using RADIUS or TACACS+ as the local security protocol. On-ramp gateway faxing is a client of either the RADIUS or the TACACS+ authentication server. User information is forwarded to the AAA interface, and authentication requests are forwarded to the security server.
Authentication must be completed before the first page of the faxed material is accepted by the Fax Application Process (FAP). If a response is not received from the AAA server before the first page is received, the fax modem or voice card disconnects the call.
RADIUS attributes define specific AAA elements in a user profile. The user profile is stored on the RADIUS server. The Cisco implementation of RADIUS supports Internet Engineering Task Force (IETF) and vendor-proprietary attributes. IETF RADIUS attribute 26 enables vendors to support extended attributes not suitable for general use. The Cisco fax applications use the RADIUS implementation of vendor-specific options in the recommended format.
The "RADIUS Vendor-Specific Attributes" appendix lists the supported vendor-specific options (subtype numbers from 3 through 21) using IETF RADIUS attribute 26 and the Cisco vendor-ID company code of 9.
There are two kinds of off-ramp fax messages:
-
Faxes that originate in the PSTN. On entering a packet network, these faxes are converted to TIFF files that are attached to e-mail messages for their transit through the network.
-
Faxes that originate from e-mail messages on a PC in the packet network.
Either type can be delivered to a PC on the network before reaching an off-ramp gateway. Upon reaching the off-ramp gateway, however, both types are converted to standard Group 3 fax format for transmission through the PSTN to terminating fax machines.
A basic e-mail operation that store-and-forward fax supports is MDN (return receipt). An MDN is sent to an e-mail originator when the e-mail recipient opens a fax e-mail. MDNs are described in RFC 2298, which also states that e-mail recipients must be able to disable the automatic generation of MDNs.
MDNs are initiated by the sending e-mail client. Return receipts are generated by the receiving e-mail client. Most PC-based e-mail software applications, such as Eudora, Netscape Messenger, and Microsoft Outlook, support MDNs.
Off-ramp security controls who can send outgoing fax messages and is facilitated by AAA security services using either RADIUS or TACACS+. Authentication begins as soon as a fax e-mail message header is received from the e-mail server on the off-ramp gateway. The off-ramp gateway does not dial the destination fax device until authentication for each fax mail is successfully completed.
On-Ramp and Off-Ramp Fax Machines
The transmitting gateway is referred to as an on-ramp gateway, and the terminating gateway is referred to as an off-ramp gateway.
-
In on-ramp faxing, either a voice gateway handles incoming calls from a standard fax machine or the PSTN converts a traditional Group 3 fax to an e-mail message with a Tagged Image File Format (TIFF) attachment. The fax e-mail message and attachment are handled by an e-mail server while traversing the packet network and can be stored for later delivery or delivered immediately to a PC or to an off-ramp gateway.
-
In off-ramp faxing, either a voice gateway handles calls going out from the network to a fax machine or the PSTN converts a fax e-mail with a TIFF attachment into a traditional fax format that can be delivered to a standard fax machine or the PSTN.
On-ramp and off-ramp faxing processes can be combined on a single gateway, or they can occur on separate gateways. Store-and-forward fax uses two different interactive voice response (IVR) applications for on-ramp and off-ramp functionalities. The applications are implemented in two Tool Command Language (Tcl) scripts that you download from Cisco.com.
The basic functionality of store-and-forward fax is facilitated through SMTP, along with an additional functionality that provides confirmation of delivery using existing SMTP mechanisms, such as ESMTP.
Dial Peer Parameters for T.37 Store-and-Forward Fax
Store-and-forward fax requires you to configure gateway dial peers and specify values for the following types of parameters:
-
IVR application parameters and IVR security and accounting parameters--These items load applications on the router and enable authorization and accounting for applications.
-
Fax parameters--These items specify the cover sheet and header information that appears on faxes generated in the packet network.
-
Mail transfer agent (MTA) parameters--These items define delivery parameters for e-mail messages that accompany fax TIFF images.
-
Message disposition notification (MDN) parameters--These items specify the generation of messages to notify e-mail originators of the delivery of their fax e-mail messages.
-
Delivery status notification (DSN) parameters--These items instruct the SMTP server to send messages to e-mail originators to inform them of the status of their e-mail messages.
-
Gateway security and accounting parameters--These items define authentication, authorization, and accounting (AAA) for faxes that enter or exit the packet network.
Fax calls from the PSTN enter the network through an on-ramp gateway, which is sometimes called an originating gateway. Fax calls exit the packet network to the PSTN through an off-ramp gateway, which is sometimes called a terminating gateway. In small networks, on-ramp and off-ramp functionalities can reside in the same gateway. For store-and-forward fax, each type of gateway is configured with two types of dial peers:
-
The on-ramp gateway is configured with one or more plain old telephone system (POTS) dial peers to handle fax calls inbound to the gateway from the public switched telephone network (PSTN) and with one or more multimedia over IP (MMoIP) dial peers to direct calls outbound from the gateway to the network.
-
The off-ramp gateway is configured with one or more MMoIP dial peers to handle fax calls inbound from the IP network and with one or more POTS dial peers to direct calls outbound through POTS voice ports to the PSTN.
Note |
The instructions in this chapter assume that your packet network includes separate gateways for on-ramp and off-ramp functions. For smaller networks that use a single router for both on-ramp and off-ramp functionalities, follow both the on-ramp and off-ramp instructions on the same router. |
How to Configure T.37 Store-and-Forward Fax
Downloading the T.37 Store-and-Forward Fax Scripts
You must download the Tcl scripts for the store-and-forward fax application; the scripts are contained in compressed zip files on Cisco.com. Save the downloaded files in a location that the gateway can access. The Cisco IOS File System (IFS) is used to read the files, so you can use any IFS-supported URL for the file location. URLs can include TFTP, FTP, or pointers to a device on the router. For more information, see the Tcl IVR API Version 2.0 Programmer’s Guide.
SUMMARY STEPS
- Log in to the Cisco website and go to http://www.cisco.com/cgi-bin/tablebuild.pl/tclware .
- Select and download the following zip files which contain the T.37 applications.
- Unzip the files.
- Move the application script files to a location that can be accessed by your gateway using a standard URL that points to the location of the script. The following are examples:
DETAILED STEPS
Step 1 |
Log in to the Cisco website and go to http://www.cisco.com/cgi-bin/tablebuild.pl/tclware . When you are logged in to the Cisco website, navigate to the TCLWare page from the Cisco home page by following this path: Technical Support / Software Center / Access Software / TCLWare. |
||
Step 2 |
Select and download the following zip files which contain the T.37 applications.
|
||
Step 3 |
Unzip the files. The zip files that you download include the following files:
|
||
Step 4 |
Move the application script files to a location that can be accessed by your gateway using a standard URL that points to the location of the script. The following are examples:
|
Configuring an On-Ramp Gateway for T.37 Store-and-Forward Fax
On-ramp gateway configuration for store-and-forward fax consists of the following tasks:
Note |
The T.37 store-and-forward fax configuration tasks are the same for H.323 and SIP networks. |
Note |
Starting with Cisco IOS Release 12.3(14)T, the call application voice configuration commands were restructured. Configuration commands for Cisco IOS Release 12.3(11)T and earlier are described in the "Fax and Modem Services over IP Overview" module. |
Enabling T.37 Store-and-Forward Fax on the On-Ramp Gateway
Perform this task to enable T.37 store-and-forward fax by specifying the following information:
-
A fully qualified domain name for the SMTP server
-
Name and location of the T.37 application
-
Type of T.37 processing to occur on this gateway
-
Called subscriber number definition
Before you begin
-
The T.37 application that processes fax calls on inbound POTS dial peers is an IVR application that is written in a Tool Command Language (Tcl) script. Download the script from Cisco.com and install it on your network before you load the T.37 application on the gateway (see the How to Configure T.37 Store-and-Forward Fax).
-
After you have installed the script at a location that is accessible to the gateway, load it using a name of your choice. All later commands that refer to this application use the name that you select when you load the application on the gateway.
SUMMARY STEPS
- enable
- configure terminal
- ip domain-name name
- fax interface-type {fax-mail | modem }
- fax receive called-subscriber {$d$ | string }
- application
- service service-name location
- end
DETAILED STEPS
Command or Action | Purpose | |||||
---|---|---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||||
Step 3 |
ip domain-name name Example:
|
Defines a default domain name that the Cisco IOS software uses to complete unqualified hostnames (without dotted-decimal domain names).
|
||||
Step 4 |
fax interface-type {fax-mail | modem } Example:
|
Enables the T.37 functionality and specifies the type of fax processing.
|
||||
Step 5 |
fax receive called-subscriber {$d$ | string } Example:
|
Configures the on-ramp gateway to send the called subscriber identity (CSI) regardless of whether the off-ramp gateway is converting a fax TIFF file to a standard fax or sending an e-mail message as a fax. The CSI is the telephone number associated with the receiving fax device and it typically appears in the LCD of the sending fax device.
|
||||
Step 6 |
application Example:
|
Enters application configuration mode to configure voice applications and services. |
||||
Step 7 |
service service-name location Example:
|
Loads a VoiceXML document or Tcl script and defines its application name.
|
||||
Step 8 |
end Example:
|
Exits application configuration mode. |
Configuring Dial Peers on the On-Ramp Gateway
The purpose for configuring on-ramp gateway dial peers is to allow the router to receive inbound fax traffic from the PSTN and to direct that traffic to the appropriate SMTP server.
This task consists of the following subtasks:
Note |
For typical network operations, we recommend that you use the default configuration for image resolution/encoding on outbound MMoIP dial peers. |
Configuring One or More Inbound POTS Dial Peers
An inbound dial peer on an on-ramp gateway receives fax calls from the PSTN.
The gateway selects an inbound dial peer for a fax call by matching information elements in the call setup message with configured dial peer attributes. Several methods of matching are available, but for store-and-forward fax, we recommend using the incoming called-number command, which configures the gateway to use the called number or the Digital Number Identification Service (DNIS) to match a dial peer. This method is recommended because call setups always include DNIS information, and this attribute has matching priority over other methods.
Note |
To learn about other methods of dial peer matching, see the Dial Peer Configuration on Voice Gateway Routers document. |
SUMMARY STEPS
- enable
- configure terminal
- dial-peer voice tag pots
- service service-name
- direct-inward-dial
- incoming called-number string
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
dial-peer voice tag pots Example:
|
Enters dial-peer configuration mode and defines a local dial peer that directs traffic to or from a POTS interface.
|
||
Step 4 |
service service-name Example:
|
Associates the on-ramp store-and-forward fax application with this dial peer. |
||
Step 5 |
direct-inward-dial Example:
|
Enables the direct inward dial (DID) call treatment for incoming called numbers, in which the entire incoming dial string is used to find a matching outbound dial peer. The gateway does not present a dial tone to the caller and does not collect digits; the setup message contains all the digits necessary to route the call. |
||
Step 6 |
incoming called-number string Example:
|
Defines the called number (dialed number identification service or DNIS) string. The called number is used to match the incoming call leg to an inbound dial peer.
|
||
Step 7 |
end Example:
|
Exits dial-peer configuration mode. |
Configuring One or More Outbound MMoIP Dial Peers
The outbound MMoIP dial peer on an on-ramp gateway directs fax traffic through the IP network to an SMTP server.
Note |
For typical network operations, we recommend that you use the default configuration for image resolution/encoding on outbound MMoIP dial peers. You should only configure additional outbound MMoIP dial peers for troubleshooting or when you need to force a dial peer into a specific resolution/encoding while receiving a fax. Changing this configuration might cause fax negotiation failure. |
SUMMARY STEPS
- enable
- configure terminal
- dial-peer voice tag mmoip
- service fax_on_vfc_onramp_app out-bound
- destination-pattern [+ ]string [T ]
- information-type fax
- session protocol smtp
- session target {mailto :{host-name | $d$ | $m$ }@domain-name | ipv4: destination-address | dns: {$d$. | $e$. | $s$. | $u$. }host-name }
- image encoding {mh | mr | mmr | passthrough }
- image resolution {fine | standard | super-fine | passthrough }
- max-conn number
- dsn {delay | failure | success }
- mdn
- end
DETAILED STEPS
Command or Action | Purpose | |||||
---|---|---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||||
Step 3 |
dial-peer voice tag mmoip Example:
|
Enters dial-peer configuration mode and defines a local dial peer that directs traffic to or from an SMTP server.
|
||||
Step 4 |
service fax_on_vfc_onramp_app out-bound Example:
|
Names the IVR application to which calls from this dial peer are handed off.
|
||||
Step 5 |
destination-pattern [+ ]string [T ] Example:
|
Specifies a pattern that represents either the prefix or the full E.164 telephone number (depending on your dial plan) that identifies the destination store-and-forward fax telephone number on this dial peer. This pattern of numbers should fall within the pattern of numbers that was configured as the incoming called number on the inbound POTS dial peer.
|
||||
Step 6 |
information-type fax Example:
|
Identifies calls associated with this dial peer as being fax transmissions, and not voice calls. |
||||
Step 7 |
session protocol smtp Example:
|
Specifies the session protocol for calls between the on-ramp gateway and the remote mail server as SMTP. |
||||
Step 8 |
session target {mailto :{host-name | $d$ | $m$ }@domain-name | ipv4: destination-address | dns: {$d$. | $e$. | $s$. | $u$. }host-name } Example:
|
Designates a network-specific address to receive calls from this dial peer (the SMTP server).
|
||||
Step 9 |
image encoding {mh | mr | mmr | passthrough } Example:
|
(Optional) Selects a specific encoding method for the fax TIFF images that are forwarded using this dial peer.
|
||||
Step 10 |
image resolution {fine | standard | super-fine | passthrough } Example:
|
(Optional) Selects a specific resolution for the fax TIFF images that are forwarded using this dial peer.
|
||||
Step 11 |
max-conn number Example:
|
(Optional) Specifies the maximum number of simultaneous connections that are allowed to and from this dial peer.
Default: the no form of this command, meaning that an unlimited number of connections is permitted. |
||||
Step 12 |
dsn {delay | failure | success } Example:
|
(Optional) Requests delivery status notification of e-mail with fax TIFF images to be sent to the address specified by the mta send mail-from command (the FROM address). DSN must be supported by the remote mail server.
The default is failure and success .
|
||||
Step 13 |
mdn Example:
|
(Optional) Requests generation of an MDN by the mail user agent when the e-mail is processed (typically opened or read). The MDN is generated by the receiving mail user agent and sent to the address defined by the mta send return-receipt-to command. The return receipt must be supported and initiated by the receiving e-mail client. |
||||
Step 14 |
end Example:
|
Exits dial-peer configuration mode. |
Configuring MTA Parameters on the On-Ramp Gateway
Perform this task to configure parameter values associated with the MTA on the on-ramp gateway.
Note |
The mta send mail-from username and mta send mail-from hostname commands define the From: username. The To: address is defined using the session target command on the on-ramp gateway MMoIP dial peer. |
SUMMARY STEPS
- enable
- configure terminal
- mta send server {host-name | ip-address [port port-number ]}
- mta send postmaster e-mail-address
- mta send mail-from hostname string
- mta send mail-from username {string | $s$ }
- mta send subject string
- mta send origin-prefix string
- mta send return-receipt-to {hostname string | username string | username $s$ }
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
mta send server {host-name | ip-address [port port-number ]} Example:
|
Specifies a destination server. This command can be repeated to define up to ten mail servers for backup purposes. DNS mail exchange (MX) records are not used to look up the hostnames provided to this command.
|
||
Step 4 |
mta send postmaster e-mail-address Example:
|
Identifies where an e-mail message should be delivered (the mail server postmaster account) if the evaluated string from the mta send mail-from command or the Simple Mail Transfer Protocol (SMTP) server is blank.
|
||
Step 5 |
mta send mail-from hostname string Example:
|
Specifies the originator (host-name portion) of the e-mail fax message. This information appears in the RFC 822 From: field and the RFC 821 MAIL FROM field of the e-mail fax message. This information is also used for generating delivery status notifications (DSNs). When the mta send mail-from hostname command is configured, the configured hostname is used with the mta send mail-from username command to form a complete e-mail address, such as faxuser@onramp-gateway.com.
|
||
Step 6 |
mta send mail-from username {string | $s$ } Example:
|
(Optional) Specifies the originator (username portion) of the e-mail fax message. This information appears in the RFC 822 From: field and the RFC 821 MAIL FROM field of the e-mail fax message. This information is also used for generating DSNs. When the mta send mail-from hostname command is configured, the configured hostname is used with the mta send mail-from username command to form a complete e-mail address, such as faxuser@onramp-gateway.com.
|
||
Step 7 |
mta send subject string Example:
|
(Optional) Defines the text that appears in the Subject field of the e-mail message.
|
||
Step 8 |
mta send origin-prefix string Example:
|
(Optional) Defines additional identifying information to be prepended to the e-mail prefix header.
|
||
Step 9 |
mta send return-receipt-to {hostname string | username string | username $s$ } Example:
|
(Optional) Specifies the address to which message disposition notifications (MDNs) are sent.
|
||
Step 10 |
end Example:
|
Exits global configuration mode. |
Configuring DSNs on the On-Ramp Gateway
The dsn command allows you to enable or disable the generation of DSNs for each state by reissuing the command and specifying a different notification option each time. To discontinue a specific notification option, use the no form of the command for that specific keyword.
For fax calls received at an on-ramp gateway, requests for DSNs are included as part of the fax-mail messages sent by the on-ramp gateway. DSN requests are generated only when the MMoIP dial peer that matches the fax call has been configured to enable DSNs (see the Configuring One or More Outbound MMoIP Dial Peers).
DSNs are delivered to the sender that is defined in the mta send mail-from command.
Note |
The following steps are also used in other tasks, but they are repeated here to show the complete set of steps that are used to generate DSNs. |
SUMMARY STEPS
- enable
- configure terminal
- mta send mail-from hostname string
- mta send mail-from username {string | $s$ }
- dial-peer voice tag mmoip
- dsn {delayed | failure | success }
- end
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
mta send mail-from hostname string Example:
|
|
Step 4 |
mta send mail-from username {string | $s$ } Example:
|
|
Step 5 |
dial-peer voice tag mmoip Example:
|
Enters dial-peer configuration mode for the MMoIP dial peer. See the Configuring One or More Outbound MMoIP Dial Peers. |
Step 6 |
dsn {delayed | failure | success } Example:
|
|
Step 7 |
end Example:
|
Exits dial-peer configuration mode. |
Configuring Security and Accounting on the On-Ramp Gateway
Perform this task to configure security and accounting on the on-ramp gatway.
Note |
Steps 10 through 13 do not apply to Cisco AS5300 gateways with modem cards. |
SUMMARY STEPS
- enable
- configure terminal
- aaa new-model
- aaa authentication login fax radius
- aaa accounting connection fax start-stop group radius
- radius-server host ip-address auth-port number acct-port number
- radius-server key {0 string | 7 hidden-string | string }
- radius-server vsa send accounting
- radius-server vsa send authentication
- mmoip aaa method fax authentication method-list-name
- mmoip aaa receive-authentication enable
- mmoip aaa method fax accounting method-list-name
- mmoip aaa receive-accounting enable
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
aaa new-model Example:
|
Enables AAA security and accounting services. |
||
Step 4 |
aaa authentication login fax radius Example:
|
Defines a method list called fax in which RADIUS is defined as the only method of login authentication.
|
||
Step 5 |
aaa accounting connection fax start-stop group radius Example:
|
Defines the accounting method list called fax with RADIUS as a method and with an option to send both start and stop accounting records to the AAA server.
|
||
Step 6 |
radius-server host ip-address auth-port number acct-port number Example:
|
Identifies the RADIUS server and the ports that are used for authentication and accounting services. You can use multiple radius-server host commands to specify multiple hosts. The software searches for hosts in the order in which you specify them.
|
||
Step 7 |
radius-server key {0 string | 7 hidden-string | string } Example:
|
Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon on the server.
|
||
Step 8 |
radius-server vsa send accounting Example:
|
Enables the network access server to recognize and use accounting vendor-specific attributes (VSAs) as defined by RADIUS Internet Engineering Task Force (IETF) attribute 26. VSAs allow vendors to support their own extended attributes not suitable for general use. |
||
Step 9 |
radius-server vsa send authentication Example:
|
Enables the network access server to recognize and use authentication VSAs as defined by RADIUS IETF attribute 26. |
||
Step 10 |
mmoip aaa method fax authentication method-list-name Example:
|
Defines the name of the method list to be used for store-and-forward fax AAA authentication. The method list, which defines the type of authentication services provided for store-and-forward fax, is itself defined using the aaa authentication global configuration command. Unlike standard AAA (in which each defined method list can be applied to specific interfaces and lines), the AAA authentication method lists used in store-and-forward fax are applied globally on the gateway.
|
||
Step 11 |
mmoip aaa receive-authentication enable Example:
|
Enables AAA authentication services if an AAA authentication method list has been defined using both the aaa authentication command and the mmoip aaa method fax authentication command. |
||
Step 12 |
mmoip aaa method fax accounting method-list-name Example:
|
Defines the name of the method list to be used for store-and-forward fax AAA accounting. The method list, which defines the type of accounting services provided for store-and-forward fax, is itself defined using the aaa accounting global configuration command. Unlike standard AAA (in which each defined method list can be applied to specific interfaces and lines), the AAA accounting method lists used in store-and-forward fax are applied globally on the gateway.
|
||
Step 13 |
mmoip aaa receive-accounting enable Example:
|
Enables on-ramp AAA accounting service if an AAA accounting method list has been defined using both the aaa accounting command and the mmoip aaa method fax accounting command. |
||
Step 14 |
end Example:
|
Exits global configuration mode. |
Configuring T.37 IVR Application Security and Accounting
Perform this task to configure the specified T.37 IVR application to perform authentication and accounting tasks in conjunction with a RADIUS server.
Note |
The commands in this section configure an IVR application, and they are not supported by Cisco IOS help. For example, if you type param accounting-list ? , the Cisco IOS software does not supply a list of entries that are valid in place of the question mark because the IVR application commands pass parameters to the named Tcl script, rather than to the Cisco IOS software. |
SUMMARY STEPS
- enable
- configure terminal
- application
- service service-name location
- param accounting enable
- param accounting-list method-list-name
- param authentication enable
- param authen-list method-list-name
- param authen-method {prompt-user | ani | dnis | gateway | redialer-id | redialer-dnis }
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
application Example:
|
Enters application configuration mode to configure voice applications and services. |
||
Step 4 |
service service-name location Example:
|
Loads a VoiceXML document or Tcl script and defines its application name.
|
||
Step 5 |
param accounting enable Example:
|
Enables AAA accounting for a Tcl application. |
||
Step 6 |
param accounting-list method-list-name Example:
|
Defines the name of the accounting method list to be used for AAA with store-and-forward fax on a voice feature card (VFC).
|
||
Step 7 |
param authentication enable Example:
|
Enables AAA authentication for a Tcl application. |
||
Step 8 |
param authen-list method-list-name Example:
|
Specifies the name of an authentication method list for a Tcl application.
|
||
Step 9 |
param authen-method {prompt-user | ani | dnis | gateway | redialer-id | redialer-dnis } Example:
|
Specifies the type of authentication method for the named application.
|
||
Step 10 |
end Example:
|
Exits application configuration mode. |
How to Configure an Off-Ramp Gateway for T.37 Store-and-Forward Fax
The purpose of an off-ramp gateway in store-and-forward fax is to receive fax e-mail messages and TIFF attachments from the packet network and transmit them to the PSTN for delivery to terminating fax machines.
The off-ramp gateway performs the following actions:
-
Converts a TIFF file or fax e-mail to a standard Group 3 fax message. During off-ramp faxing, the gateway uses the receiving MTA and dial peers to convert a fax-mail TIFF file or plain text file into a standard fax format and then delivers it as a standard fax transmission.
-
Appends headers and cover pages only for fax plain-text e-mail messages, as described in the Configuring Fax Headers and Cover Pages on the Off-Ramp Gateway.
-
Forwards fax messages to voice ports that interface with the PSTN, as configured in the dial peers.
Various aspects of the off-ramp gateway must be configured to enable the preceding actions. The off-ramp gateway uses dial peers to route calls to appropriate POTS voice ports. An IVR application handles the conversion of fax messages. In addition, you can configure the gateway to request notifications when the fax messages are delivered. AAA security and accounting are also important for off-ramp fax services.
The off-ramp gateway configuration for store-and-forward fax consists of the following tasks:
Note |
Starting with Cisco IOS Release 12.3(14)T, the call application voice configuration commands were restructured. This application guide uses the new command structure. |
Enabling T.37 Store-and-Forward Fax on the Off-Ramp Gateway
Perform this task to enable T.37 store-and-forward fax by specifying the following information:
-
A fully qualified domain name for the SMTP server
-
The name and location of the T.37 application
-
The type of T.37 processing to occur on this gateway
-
Transmitting-subscriber number definition
Before you begin
This section describes prerequisites for enabling T.37 store-and-forward fax on the off-ramp gateway.
-
The T.37 application that processes fax calls on inbound MMoIP dial peers is an IVR application written in a Tcl script. Download the script from Cisco.com and install it on your network before you load the T.37 application on the gateway (see the How to Configure T.37 Store-and-Forward Fax).
-
After you have installed the script at a location that is accessible to the gateway, load it using a name of your choice. All later commands that refer to this application will use the name that you select when you load the application on the gateway.
SUMMARY STEPS
- enable
- configure terminal
- ip domain-name name
- fax interface-type {fax-mail | modem }
- fax send transmitting-subscriber {$s$ | string }
- service
- service service-name location
- end
DETAILED STEPS
Command or Action | Purpose | |||||
---|---|---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||||
Step 3 |
ip domain-name name Example:
|
Defines a default domain name that the Cisco IOS software uses to complete unqualified hostnames (without dotted-decimal domain names).
|
||||
Step 4 |
fax interface-type {fax-mail | modem } Example:
|
Enables T.37 functionality and specifies the type of fax processing.
|
||||
Step 5 |
fax send transmitting-subscriber {$s$ | string } Example:
|
Configures the on-ramp gateway to send the transmitting subscriber number (TSI) regardless of whether the off-ramp gateway is converting a fax TIFF file to a standard fax or sending an e-mail message as a fax. The TSI is the telephone number associated with the transmitting, or sending, fax device and it typically appears in the LCD of the receiving fax device.
|
||||
Step 6 |
service Example:
|
Specifies the configuration mode to enter voice applications and services. |
||||
Step 7 |
service service-name location Example:
|
Loads a VoiceXML document or Tcl script and defines its application name.
|
||||
Step 8 |
end Example:
|
Exits application configuration mode. |
Configuring Dial Peers on the Off-Ramp Gateway
The purpose for configuring off-ramp gateway dial peers is to allow the router to receive inbound fax traffic from an SMTP server in the packet network and to direct that traffic to voice ports that interface with the PSTN.
This task consists of the following subtasks:
Configuring One or More Inbound MMoIP Dial Peers
The inbound MMoIP dial peer on an off-ramp gateway receives fax traffic from an SMTP server in the packet network. Perform this task to configure inbound MMoIP dial peers.
SUMMARY STEPS
- enable
- configure terminal
- dial-peer voice tag mmoip
- application application-name
- incoming called-number string
- information-type fax
- image encoding {mh | mr | mmr | passthrough }
- image resolution {fine | standard | super-fine | passthrough }
- end
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
dial-peer voice tag mmoip Example:
|
Enters dial-peer configuration mode and defines a local dial peer that directs traffic to or from an SMTP server.
|
Step 4 |
application application-name Example:
|
Names the IVR application to which calls from this dial peer are handed off. |
Step 5 |
incoming called-number string Example:
|
Defines the dialed number identification service (DNIS) string, or called fax telephone number. The called number is used to match the incoming call leg to an inbound dial peer.
|
Step 6 |
information-type fax Example:
|
Identifies calls associated with this dial peer as being fax transmissions, not voice calls. |
Step 7 |
image encoding {mh | mr | mmr | passthrough } Example:
|
(Optional) Selects a specific encoding method for the fax TIFF images that are handled by this dial peer.
|
Step 8 |
image resolution {fine | standard | super-fine | passthrough } Example:
|
(Optional) Selects a specific resolution for the fax TIFF images that are handled by this dial peer.
|
Step 9 |
end Example:
|
Exits dial-peer configuration mode. |
Configuring One or More Outbound POTS Dial Peers
The outbound POTS dial peer on an off-ramp gateway directs fax calls to a POTS interface. Perform this task to configure outbound POTS dial peers.
SUMMARY STEPS
- enable
- configure terminal
- dial-peer voice tag pots
- destination-pattern [+ ]string [T ]
- port voice-port
- prefix string
- max-conn number
- end
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
dial-peer voice tag pots Example:
|
Enters dial-peer configuration mode and defines a local dial peer that directs traffic to or from a POTS interface.
|
Step 4 |
destination-pattern [+ ]string [T ] Example:
|
Identifies the E.164 or private dialing plan telephone number associated with this dial peer. For outbound dial peers, the destination-pattern string is matched against the called number (DNIS string).
|
Step 5 |
port voice-port Example:
|
Maps the dial peer to a specific logical voice-port interface.
|
Step 6 |
prefix string Example:
|
(Optional) Specifies the prefix of the dialed digits associated with this dial peer. If you configure a prefix, when an outgoing call is initiated, the prefix string value is added to the telephone interface first, before the telephone number configured for this dial peer.
|
Step 7 |
max-conn number Example:
|
(Optional) Specifies the maximum number of simultaneous connections that are allowed to and from this dial peer.
The default is the no form of this command, which means that an unlimited number of connections is permitted. |
Step 8 |
end Example:
|
Exits dial-peer configuration mode. |
Configuring Fax Headers and Cover Pages on the Off-Ramp Gateway
The purpose of this task is to create headers and cover pages for fax messages that originate from plain-text e-mail messages. This task does not apply to fax TIFF files because headers and cover pages are generated by the originating fax machines and also because the off-ramp gateway does not alter TIFF files when converting them.
This task consists of the following two subtasks:
Configuring Fax Header Parameters
For faxes in plain-text e-mails that originate in the packet network, the off-ramp gateway can append header information to the top of each faxed cover and text page.
Note |
Because the off-ramp gateway does not alter fax TIFF attachments, fax headers cannot be configured for faxes that are being converted from TIFF files to standard fax transmissions. |
SUMMARY STEPS
- enable
- configure terminal
- fax send center-header {$a$ | $d$ | $p$ | $s$ | $t$ | string }
- fax send right-header {$a$ | $d$ | $p$ | $s$ | $t$ | string }
- fax send left-header {$a$ | $d$ | $p$ | $s$ | $t$ | string }
- end
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
fax send center-header {$a$ | $d$ | $p$ | $s$ | $t$ | string } Example:
|
Specifies the header information to be displayed in the center position.
|
Step 4 |
fax send right-header {$a$ | $d$ | $p$ | $s$ | $t$ | string } Example:
|
Specifies the header information to be displayed on the right.
|
Step 5 |
fax send left-header {$a$ | $d$ | $p$ | $s$ | $t$ | string } Example:
|
Specifies the header information to be displayed on the left.
|
Step 6 |
end Example:
|
Exits global configuration mode. |
Configuring Fax Cover Page Parameters
For faxes from plain-text e-mail messages that originate in the packet network, the off-ramp gateway can create fax cover pages.
Note |
Because the off-ramp gateway does not alter fax TIFF attachments, cover pages cannot be configured for faxes that are being converted from TIFF files to standard fax transmissions. |
The table below contains examples of entries in the e-mail To: field to control the generation of fax cover pages and explains how these entries relate to the fax send coverpage enable command.
To: Field Entry in Fax E-Mail Message |
Description |
---|---|
|
Fax sent to an E.164-compliant long distance telephone number in the United States. If the fax send coverpage enable command has been configured, store-and-forward fax generates a fax cover page. |
|
Fax sent to an E.164-compliant long distance telephone number in the United States. In this example, the fax send coverpage enable command is superseded by the cover=no statement. No cover page is generated. |
|
Fax sent to an E.164-compliant long distance telephone number in the United States. In this example, the fax send coverpage enable command is superseded by the cover=yes statement. Store-and-forward fax generates a fax cover page. |
|
Fax sent to an E.164-compliant long distance telephone number in Germany. |
|
Fax sent to an E.164-compliant long distance telephone number in Australia. |
|
Fax sent to an E.164-compliant long distance telephone number in France. |
SUMMARY STEPS
- enable
- configure terminal
- fax send coverpage enable
- fax send coverpage comment string
- fax send coverpage show-detail
- fax send coverpage email-controllable
- end
DETAILED STEPS
Command or Action | Purpose | |
---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
Step 3 |
fax send coverpage enable Example:
|
Enables the off-ramp gateway to send cover sheets with faxes that originate from e-mail messages. |
Step 4 |
fax send coverpage comment string Example:
|
(Optional) Adds personalized text in the title field of a fax cover sheet generated by the gateway.
|
Step 5 |
fax send coverpage show-detail Example:
|
(Optional) Prints all of the e-mail header information as part of the text on fax cover sheets generated by the gateway. |
Step 6 |
fax send coverpage email-controllable Example:
|
(Optional) Allows the fax e-mail address to enable cover page generation on a per-recipient basis. This means that if an e-mail header has a parameter that sets cover to no or cover to yes, the setting for the fax send coverpage enable command is overridden. For example, if the address has the cover parameter set to no, the parameter overrides the setting for the fax send coverpage enable command and the off-ramp gateway does not generate a fax cover page. If the address has the cover parameter set to yes, the off-ramp gateway defers to the setting configured in the e-mail address and generates a cover page whether or not the fax send coverpage enable command has been used. The table above contains examples of entries in the e-mail To: field to control the generation of fax cover pages. |
Step 7 |
end Example:
|
Exits global configuration mode. |
Configuring MTA Parameters on the Off-Ramp Gateway
Perform this task to configure the way in which the off-ramp gateway receives messages from the MTA. In store-and-forward fax, the MTA is the messaging infrastructure in the packet network that performs message routing, storage, and transport. The MTA can be either a standard Internet MTA (for example, UNIX sendmail) or a custom store-and forward fax software.
For added security, with the MTA, you can define SMTP host aliases that are different from the normal host-name system (DNS) hostnames on your network. The gateway accepts incoming mail if the destination hostname of the incoming mail matches one of the aliases configured by the mta receive aliases command.
The MTA also controls the generation of MDN status messages.
SUMMARY STEPS
- enable
- configure terminal
- mta receive aliases string
- mta receive maximum-recipients number
- mta receive generate [mdn | permanent-error ]
- end
DETAILED STEPS
Command or Action | Purpose | |||||
---|---|---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||||
Step 3 |
mta receive aliases string Example:
|
Defines a hostname to be used as an alias for the off-ramp gateway. Up to ten aliases can be defined. The gateway accepts incoming mail if the destination hostname of the inbound fax e-mail matches an alias.
|
||||
Step 4 |
mta receive maximum-recipients number Example:
|
Defines the number of simultaneous SMTP recipients handled by this gateway. This definition is intended to limit the number of resources allocated for fax transmissions.
|
||||
Step 5 |
mta receive generate [mdn | permanent-error ] Example:
|
Specifies the type of fax delivery response message that a T.37 fax off-ramp gateway should return. To return to the default, use the no form of this command.
The default is that standard SMTP status messages are returned to the SMTP client with error classifications of permanent or transient.
|
||||
Step 6 |
end Example:
|
Exits global configuration mode. |
Configuring MDNs on the Off-Ramp Gateway
MDNs are sent to an address chosen by the sender. The following text is included in the e-mail header of the message:
Disposition-Notification-To:
This text is followed by the address of the sender as defined in the mta send return-receipt-to command.
SUMMARY STEPS
- enable
- configure terminal
- mta receive generate mdn
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
mta receive generate mdn Example:
|
Instructs the off-ramp gateway to respond to and process MDN requests from the SMTP server.
|
||
Step 4 |
end Example:
|
Exits global configuration mode. |
Configuring Security and Accounting on the Off-Ramp Gateway
This task consists of the following subtasks:
Note |
It is recommended that access control lists (ACLs) be configured to restrict which IP addresses can connect to the SMTP port (port 25). For information about configuring ACLs, see the Creating an IP Access List and Applying it to an Interface module in the Cisco IOS Security Configuration Guide. We recommend that the off-ramp gateway accept incoming SMTP connections only from trusted mailers. Configure packet filters to permit only certain trusted IP addresses to send faxes to the store-and-forward fax off-ramp gateway. |
Configuring Off-Ramp Gateway Security and Accounting
Perform this task to set up authorization and billing for the off-ramp gateway.
Note |
Steps 10 through 13 do not apply to Cisco AS5300 gateways with modem cards. |
SUMMARY STEPS
- enable
- configure terminal
- aaa new-model
- aaa authentication login fax radius
- aaa accounting connection fax start-stop group radius
- radius-server host host auth-port number acct-port number
- radius-server key {0 string | 7 hidden-string | string }
- radius-server vsa send accounting
- radius-server vsa send authentication
- mmoip aaa method fax authentication method-list-name
- mmoip aaa receive-authentication enable
- mmoip aaa method fax accounting method-list-name
- mmoip aaa receive-accounting enable
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
aaa new-model Example:
|
Enables AAA security and accounting services. |
||
Step 4 |
aaa authentication login fax radius Example:
|
Defines a method list called fax in which RADIUS is defined as the only method of login authentication.
|
||
Step 5 |
aaa accounting connection fax start-stop group radius Example:
|
Defines the accounting method list called fax with RADIUS as a method and with an option to send both start and stop accounting records to the AAA server. The fax method list is static and is applied by default to all voice interfaces.
|
||
Step 6 |
radius-server host host auth-port number acct-port number Example:
|
Identifies the RADIUS server and the port that is used for authentication and accounting services. You can use multiple radius-server host commands to specify multiple hosts. The software searches for hosts in the order in which you specify them.
|
||
Step 7 |
radius-server key {0 string | 7 hidden-string | string } Example:
|
Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon on the server.
|
||
Step 8 |
radius-server vsa send accounting Example:
|
Enables the network access server to recognize and use accounting vendor-specific attributes (VSAs) as defined by RADIUS Internet Engineering Task Force (IETF) attribute 26. VSAs allow vendors to support their own extended attributes not suitable for general use. |
||
Step 9 |
radius-server vsa send authentication Example:
|
Enables the network access server to recognize and use authentication VSAs as defined by RADIUS IETF attribute 26. |
||
Step 10 |
mmoip aaa method fax authentication method-list-name Example:
|
Defines the name of the method list to be used for store-and-forward fax AAA authentication. The method list, which defines the type of authentication services provided for store-and-forward fax, is itself defined using the aaa authentication global configuration command. Unlike standard AAA (in which each defined method list can be applied to specific interfaces and lines), the AAA authentication method lists used in store-and-forward fax are applied globally on the gateway.
|
||
Step 11 |
mmoip aaa receive-authentication enable Example:
|
Enables AAA authentication services if an AAA authentication method list has been defined using both the aaa authentication command and the mmoip aaa method fax authentication command. |
||
Step 12 |
mmoip aaa method fax accounting method-list-name Example:
|
(Required) Defines the name of the method list to be used for store-and-forward fax AAA accounting. The method list, which defines the type of accounting services provided for store-and-forward fax, is itself defined using the aaa accounting global configuration command. Unlike standard AAA (in which each defined method list can be applied to specific interfaces and lines), the AAA accounting method lists used in store-and-forward fax are applied globally on the gateway.
|
||
Step 13 |
mmoip aaa receive-accounting enable Example:
|
Enables off-ramp AAA accounting services if an AAA accounting method list has been defined using both the aaa accounting command and the mmoip aaa method fax accounting command. |
||
Step 14 |
end Example:
|
Exits global configuration mode. |
Creating SMTP filters with ACLs
Incoming ACLs can be used on Ethernet or Fast Ethernet interfaces to filter SMTP traffic for store-and-forward fax. It is recommended that ACLs be configured to restrict access to the SMTP port (port 25) to only trusted e-mail servers. The creation of ACLs is beyond the scope of this document.
The following example, though, provides a starting point by restricting access to the SMTP port 25 to a trusted e-mail server (IP address 10.0.0.1):
! Configure ACLs to restrict access to the SMTP port (port 25) to only "trusted"
! e-mail servers. Depending on the topology of your particular network, replace the
! any keyword with the destination IP addresses of the Ethernet and Fast Ethernet
! interfaces. Define all trusted e-mail servers using the tcp host ip-address
! portion of this command.
access-list 100 permit tcp host 10.0.0.1 any eq smtp
access-list 100 deny tcp any any eq smtp
access-list 100 permit ip any any
!
! Enter interface configuration mode for Ethernet interface 0.
interface ethernet 0
! Apply the access list to this interface.
access-group 100 in
!
! Enter interface configuration mode for Fast Ethernet interface 0.
interface fastethernet 0
! Apply the access list to this interface.
access-group 100 in
Note |
For complete information about configuring ACLs, see the Cisco IOS Security Configuration Guide. |
Configuring T.37 IVR Application Security and Accounting on the Off-Ramp Gateway
Perform this task to configure the specified IVR application to perform authentication and accounting tasks in conjunction with a RADIUS server. IVR uses (Tcl) scripts to gather information and to process accounting and billing. For example, a Tcl IVR script plays when a caller receives a voice-prompt instruction to enter a specific type of information, such as a personal identification number (PIN). After playing the voice prompt, the Tcl IVR application collects the predetermined number of touch tones and sends the collected information to an external server for user authentication and authorization.
SUMMARY STEPS
- enable
- configure terminal
- application
- service service-name location
- param accounting enable
- param accounting-list method-list-name
- param authentication enable
- param authen-list method-list-name
- param authen-method {prompt-user | ani | dnis | gateway | redialer-id | redialer-dnis }
- end
DETAILED STEPS
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
enable Example:
|
Enables privileged EXEC mode.
|
||
Step 2 |
configure terminal Example:
|
Enters global configuration mode. |
||
Step 3 |
application Example:
|
Enters application configuration mode to configure voice applications and services. |
||
Step 4 |
service service-name location Example:
|
Loads a VoiceXML document or Tcl script and defines its application name.
|
||
Step 5 |
param accounting enable Example:
|
Enables AAA accounting for a Tcl application. |
||
Step 6 |
param accounting-list method-list-name Example:
|
Defines the name of the accounting method list to be used for AAA with store-and-forward fax on a voice feature card (VFC).
|
||
Step 7 |
param authentication enable Example:
|
Enables AAA authentication for a Tcl application. |
||
Step 8 |
param authen-list method-list-name Example:
|
Specifies the name of an authentication method list for a Tcl application.
|
||
Step 9 |
param authen-method {prompt-user | ani | dnis | gateway | redialer-id | redialer-dnis } Example:
|
Specifies the type of authentication method for the named application.
|
||
Step 10 |
end Example:
|
Exits application configuration mode. |
Troubleshooting Tips
Use the following show commands to troubleshoot store-and-forward fax on both the on-ramp and off-ramp gateways.
-
show dial-peer voice [tag ] [summary ]--Displays configuration information for MMoIP and POTS dial peers so that you can verify that store-and-forward fax is enabled.
-
show call application voice summary --Lists all voice applications that are loaded on the router so that you can confirm that the scripts that you are interested in are loaded.
-
show call application voice application-name --Displays the line-by-line contents of the Tcl script associated with the specified application.
-
show accounting --No specific show command exists for either RADIUS or TACACS+ accounting. To obtain accounting records that display information about users currently logged in, use the show accounting command.
Configuration Examples for T.37 Store-and-Forward Fax
Example On-Ramp Gateway
The following example is sample configuration of a T.37 on-ramp gateway:
! Define the called subscriber number. In this case, the number configured as the
! destination pattern will be used as the called subscriber identifier.
fax receive called-subscriber $d$
!
! Specify the originator of the e-mail address. In this case, the originator information
! is derived from the calling number.
mta send mail-from username $s$
!
! (Optional) Provide additional information about the sending device. In this example,
! the sending device's hostname is alabama
mta send origin-prefix alabama
!
! Define where this fax-mail should be delivered (which is the mail server postmaster
! account) if it cannot be delivered to the defined destination.
mta send postmaster postmaster@company.com
!
! (Optional) If configuring MDNs, specify the address to which they should be
! sent.
mta send return-receipt-to username postmaster@company.com
!
! Specify the destination e-mail server that accepts on-ramp fax mail.
mta send server california.fax.com
!
! Define the text string that will be displayed as the subject of the fax mail.
mta send subject Fax-Mail Message
!
! Enter dial-peer configuration mode and define an on-ramp POTS peer.
dial-peer voice 1000 pots
!
! Designate fax as the type of information handled by this dial peer.
information-type fax
!
! Specify direct inward dial for this dial peer.
direct-inward-dial
!
! Define the incoming called number associated with this dial peer.
incoming called number 5105550119
!
! (Optional) Define the maximum number of connections that will be used simultaneously
! to transmit fax mail.
max-conn 10
!
! Define an on-ramp MMoIP dial peer.
dial-peer voice 1001 mmoip
!
! Define the telephone number associated with this dial peer.
destination-pattern 14085550119
!
! Define a destination e-mail address for this dial peer.
session-target mailto:$d$@abccompany.com
!
! (Optional) Request that DSNs be sent.
dsn failure
!
! Specify a particular image encoding method to be used for fax images. In this
! example, Modified Huffman (IETF standard) is being specified.
image encoding mh
!
!Specify a particular fax image resolution. In this example, the image resolution was
!set to 204 by 196 pixels per inch (fine).
image resolution fine
!
!Designate fax as the type of information handled by this dial peer.
info-type fax
!
!(Optional) Define the maximum number of connections that will be used simultaneously
!to transmit fax mail.
max-conn 10
!
!(Optional) Request that MDNs be sent.
mdn
!
! Specify SMTP as the protocol to be used for store-and-forward fax.
session protocol smtp
Example Off-Ramp Gateway
The following is sample configuration of a T.37 off-ramp gateway:
.
.
! Define the transmitting subscriber number (TSI); this is the number that is
! displayed in the LCD of the receiving fax machine. In this example, the sender's
! name (captured by the on-ramp from the sending fax machine) will be used.
fax send transmitting-subscriber $s$
!
! Configure the speed of the fax transmission. In this case, fax transmissions will be
! sent at 14400 bits per second.
fax send max-speed 14400
!
! Define a hostname to be used as an alias for the off-ramp Cisco AS5300 device.
mta receive aliases abccompany.com
!
! (Optional) Specify that the Cisco AS5300 universal access server will respond to an MDN
! request.
mta receive generate mdn
!
! Define the number of simultaneous SMTP recipients (in this case, 10) handled by this
! Cisco AS5300 device.
mta receive maximum-recipients 10
!
!
! Specify that the company name will appear in the center position of the fax
! header information.
fax send center-header Acme Company
!
! Specify that the page count will appear in the right position of the fax header
! information.
fax send right-header $p$
!
! Specify that the date will appear in the left position of the fax header
! information.
fax send left-header $a$
!
! Enable the Cisco AS5300 device to send a cover sheet with faxes that originate from
! e-mail messages.
fax send coverpage enable
!
! Add a personalized comment to the title field of the fax cover sheet. In this case,
! the phrase FAX TRANSMISSION was added.
fax send coverpage comment FAX TRANSMISSION
!
! Enter dial-peer configuration mode and define an off-ramp POTS dial peer.
dial-peer voice 1002 pots
!
! Designate fax as the type of information handled by this dial peer.
information-type fax
!
! Define a telephone number to be associated with this dial peer.
destination-pattern 1408555....
!
! Add prefix.
prefix 9,555
!
! Define an off-ramp MMoIP peer.
dial-peer voice 1003 mmoip
!
! Designate fax as the type of information handled by this dial peer.
information-type fax
!
! Define an incoming called number to be associated with this dial peer.
incoming called-number 14085550020
!
! Specify a particular fax image resolution. In this example, the image resolution was
! set to 204 by 196 pixels per inch (fine).
image resolution fine
!
Example Combined On-Ramp and Off-Ramp Gateway
The following is sample T.37 store-and-forward fax configuration for a single gateway that performs both on-ramp and off-ramp gateway functions:
fax interface-type fax-mail
!
service timestamps debug uptime
service timestamps log uptime
!
hostname fax-gateway
!
enable password lab
!
username betatest password 0 password
!
ip subnet-zero
ip host mars 192.168.254.254
ip host saturn 172.28.129.150
ip domain-name abcwrecking.com
ip name-server 10.14.116.1
!
! Used for fallback from T.38 fax relay to T.37 fax.
voice hunt user-busy
!
!
! Global service for fax relay.
voice service voip
fax protocol t38 ls_redundancy 0 hs_redundancy 0
!
application
service app_offramp tftp://mars/libretto-test/app_offramp5.tcl
param authen-list fax
param authen-method gateway
param accounting-list fax
!
application
service app_onramp tftp://mars/smith/faxdir/onramp13.nc.tcl
param authen-list fax
param authen-method gateway
param language 1 en
param accounting-list fax
application
service app_onramp set-location en 0 tftp://mars/smith/WV/en_new/
!
fax receive called-subscriber $d$
fax send transmitting-subscriber $s$
fax send left-header $s$
fax send center-header $t$
fax send right-header Page: $p$
fax send coverpage enable
fax send coverpage email-controllable
fax send coverpage comment ABC Wrecking cover page
mta receive aliases [10.14.120.2]
mta send server saturn_smtp_server
mta send subject "Facsimile Transmission"
mta send origin-prefix ABCWrecking Fax
mta send postmaster postmaster postmaster@abcwrecking.com
mta send mail-from hostname saturn
mta send mail-from username fax-user
mta send return-receipt-to hostname return.host.com
mta send return-receipt-to username $s$
mta receive aliases bock.abcwrecking.com
mta receive aliases abcwrecking.com
mta receive maximum-recipients 200
mta receive generate mdn
!
!
controller T1 1/1
framing esf
clock source line primary
linecode b8zs
ds0-group 0 timeslots 1-24 type e&m-fgd
!
interface Ethernet0
ip address 10.14.120.2 255.255.0.0
no ip directed-broadcast
!
interface FastEthernet0
no ip address
no ip directed-broadcast
shutdown
duplex auto
speed auto
!
ip default-gateway 10.14.0.1
ip classless
ip route 192.168.254.0 255.255.255.0 10.14.0.1
no ip http server
!
!
voice-port 1/1:0
!
!
! Inbound peer for T.37 on-ramp operation.
dial-peer voice 2 pots
application app_onramp
incoming called-number 5......
direct-inward-dial
port 1/1:0
!
! Outbound peer for T.37 on-ramp operation.
dial-peer voice 3 mmoip
! The application named below must be exactly as shown!
service fax_on_vfc_onramp_app out-bound
destination-pattern 57108..
session target mailto:$d$@mail-server.abcwrecking.com
! MDN and DSN configuration can be set in this peer.
!
! Inbound peer for T.37 off-ramp operation.
dial-peer voice 21 mmoip
application app_offramp
incoming called-number 5......
information-type fax
!
! Outbound peer for T.37 off-ramp operation.
dial-peer voice 20 pots
destination-pattern 5......
port 1/1:0
prefix 5
Example Combined On-Ramp and Off-Ramp Gateway with Security
The following is sample configuration for a combined on-ramp and off-ramp gateway enabled for security:
!
! Enable AAA security services.
aaa new-model
! Define the method list to be used with store-and-forward fax authentication.
mmoip aaa method fax authentication onramp-auth
! Define the method list to be used with store-and-forward fax accounting services.
mmoip aaa method fax accounting onramp-acct
! Define and enable the AAA authentication method list for store-and-forward fax.
aaa authentication login onramp-auth radius local
! Define and enable the AAA accounting method list for store-and-forward fax.
aaa accounting connection onramp-acct stop-only radius
! Enable on-ramp authentication.
mmoip aaa receive-authentication enable
! Enable on-ramp accounting services.
mmoip aaa receive-accounting enable
! Enable off-ramp authorization.
mmoip aaa send-authentication enable.
! Enable off-ramp accounting services.
mmoip aaa receive-accounting enable
! Define the gateway ID as the means by which AAA identifies the user for
! off-ramp authentication.
mmoip aaa send-id primary gateway
! Define the gateway ID as the means by which AAA identifies the user for on-ramp
! authentication.
mmoip aaa receive-id primary gateway
! Configure the Cisco AS5300 device to support RADIUS.
radius-server host 172.18.11.13 auth-port 1645 acct-port 1646
radius-server key password
! Configure the RADIUS server to recognize and use vendor-specific attributes.
radius-server vsa send accounting
radius-server vsa send authentication
Additional References
Related Documents
Related Topic |
Document Title |
---|---|
Cisco IOS commands |
|
Cisco IOS Voice commands : complete command syntax, command mode, command history, defaults, usage guidelines, and examples |
Cisco IOS Voice Command Reference |
Configuring ACL |
Creating an IP Access List and Applying it to an Interface module in the Cisco IOS Security Configuration Guide |
Standards
Standard |
Title |
---|---|
None |
-- |
MIBs
MIB |
MIBs Link |
---|---|
None |
To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
RFCs
RFC |
Title |
---|---|
None |
-- |
Technical Assistance
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
Feature Information for Configuring T.37 Store-and-Forward Fax
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Feature Name |
Releases |
Feature Information |
---|---|---|
Extended Simple Mail Transfer Protocol (ESMTP) Accounting in Store-and-Forward Fax |
12.2 |
The SMTP facilitates the store-and-forward fax functionality, along with an additional functionality that provides confirmation of delivery using existing SMTP mechanisms, such as ESMTP. |
T.37 Store-and-Forward Fax |
12.0(7)T 12.1(5)T) 12.2(8)T 12.2(15)T 12.2(2)XB 12.3(14)T |
Fax pass-through is a method for sending faxes over IP networks. The following command was modified: service fax_on_vfc_onramp_app out-bound . |
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2004-2011 Cisco Systems, Inc. All rights reserved.