|
|
This feature module describes ITU-T T.38 Fax Relay for Voice over IP (VoIP) H.323 gateway support on Cisco 2600 series, Cisco 3600 series, and Cisco MC3810 series multiservice gateways in Cisco IOS Release 12.1(3)T. This document includes the following sections:
Figure 1 shows an IP network in a mixed vendor network with T.38 Fax Relay capabilities.

Figure 1 shows an IP H.323 network with Cisco and third-party gateways and gatekeepers all capable of T.38 Fax Relay functionality. By using T.38 Fax Relay, all gateways and gatekeepers in this network are able to send faxes to other remote offices, or to the offices of another company on the IP network.
For example, when a fax is sent from the originating gateway, an initial voice call is established. The terminating gateway, detects the fax tone generated by the answering fax machine. The VoIP H.323 call stack then starts a T.38 mode request using H.245 procedures. If the opposite end of the call acknowledges the T.38 mode request, the initial audio channel is closed and a T.38 Fax Relay channel is opened. When the fax transmission is completed, the call is reverted back to voice mode.
Interoperability
The Cisco 2600 series, Cisco3600 series, and CiscoMC3810 series multiservice gateways with ITU-T T.38 Fax Relay capability can interoperate with third-party gateways and gatekeepers over an IP H.323 network. The goal is to work with third-party gateways and gatekeepers to provide ITU-T standards based T.38 Fax Relay services for multi-vendor networks.
Toll Bypass
The Cisco 2600 series, Cisco3600 series, and CiscoMC3810 series multiservice gateways provide standards-based toll by-pass for both fax and voice calls. In addition to existing voice and fax toll bypass capabilities, the multiservice gateways provide toll bypass for Fax Relay with the standards-based ITU-T T.38 Fax Relay implementation.
![]() |
Note The transport protocols specified in the ITU-T Recommendation for T.38 are Transmission Control Protocol (TCP) and UDP; however, only UDP is supported for the Cisco IOS Release 12.1(3)T. For further information on T.38 protocol, refer to ITU-T Recommendation. |
For more information about voice technologies, refer to the Cisco IOS Multiservice Applications Configuration Guide and the Cisco IOS Multiservice Command Reference for Cisco IOS Release 12.1.
Standards
ITU-T Recommendation for T.38
MIBs
No new MIB enhancements. The T.38 fax calls use the pre-existing voice MIBs.
For descriptions of supported MIBs and how to use MIBs, go to the Cisco MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
None.
![]() |
Note Although 96 to 128 MB memory requirement is recommended, the memory requirement is dependent on the platform and the number of calls anticipated to be made through the system. |
You need to configure T.38 Fax Relay in both the originating and terminating gateways for the T.38 Fax Relay for VoIP H.323 to operate. To specify the global default fax protocol for all the VoIP dial peers, configure the dial peers in global configuration mode. To specify the fax protocol for a specific VoIP dial peer, configure the dial peer in dial-peer configuration mode.
![]() |
Note When T.38 Fax Relay is configured under the dial-peer voice configuration, the configuration for the specific dial peer takes precedence over the global configuration under the voice service voip command. |
See the following sections for the T.38 Fax Relay configuration. Each task in the list indicates if the task is required or optional:
| Command | Purpose | |||||
|---|---|---|---|---|---|---|
Step 1 | Router(config)#voice service voip | Enters the voice-service configuration mode. | ||||
Step 2 | Router(config-voi-serv)#fax protocol {cisco | t38
[ls_redundancy value] [hs_redundancy value]}
| Specifies the global default fax protocol for all the VoIP dial peers. The t38 keyword enables the T.38 Fax Relay protocol. The cisco keyword selects the original Cisco proprietary fax protocol. Optional parameters ls_redundancy and hs_redundancy are used to send redundant T.38 fax packets.
The ls_redundancy parameter refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. For the ls_redundancy parameter, the value can be from 0 to 5. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay. The hs_redundancy parameter refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data. For the hs_redundancy parameter, the value can be from 0 to 2. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
| ||||
Step 3 | Router(config-voi-serv)#exit | Exits the voice-service configuration mode and returns to the global configuration mode. | ||||
Step 4 | Router(config)#exit | Exits the global configuration mode. |
![]() |
Note Repeat the configuration steps on both the originating and terminating gateways. |
![]() |
Note When T.38 Fax Relay is configured under the dial-peer voice configuration, the configuration for the specific dial peer takes precedence over the global configuration under the voice service voip command. |
| Command | Purpose | |||||
|---|---|---|---|---|---|---|
Step 1 | Router(config)#dial-peer voice tag voip | Enters dial-peer configuration mode. | ||||
Step 2 | Router(config-dial-peer)#fax protocol {cisco | t38
[ls_redundancy value] [hs_redundancy value] | system}
| Specifies the fax protocol for a dial peer. The t38 keyword enables the T.38 Fax Relay protocol. The cisco keyword selects the original Cisco proprietary fax protocol. When the system keyword is selected in the dial peer, it specifies the global default fax protocol used by a dial peer, set by the fax protocol t.38 command. Optional parameters ls_redundancy and hs_redundancy are used to send redundant T.38 fax packets.
The ls_redundancy parameter refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. For the ls_redundancy parameter, the value can be from 0 to 5. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay. The hs_redundancy parameter refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data. For the hs_redundancy parameter, the value can be from 0 to 2. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
| ||||
Step 3 | Router(config-dial-peer)#fax rate {12000 | 14400 |
2400 | 4800 | 7200 | 9600} {disable | voice} [bytes
bytes]
| Selects the maximum fax transmission speed for a dial peer. | ||||
Step 4 | Router(config-dial-peer)#exit | Exits the dial-peer configuration mode and returns to the global configuration mode. | ||||
Step 5 | Router(config)#exit | Exits the global configuration mode. |
![]() |
Note Repeat the configuration steps on both the originating and terminating gateways. |
To verify that T.38 Fax Relay for VoIP H.323 feature is enabled, follow these steps:
Step 2 Enter the show dial-peer voice command to verify that T.38 Fax Relay is enabled.
To troubleshoot the T.38 Fax Relay for VoIP H.323 feature, perform the following steps:
| Command | Purpose |
|---|---|
Router#show run | Displays the current configuration. |
Router#show dial-peer voice [number | summary] | Displays configuration information for dial peers. The number argument specifies a specific dial peer from 1- 32767. When you use the summary keyword, the output displays a summary of all dial peers. |
This section provides a sample configuration examples of T.38 Fax Relay:
Router# show run Building configuration... Current configuration: ! ..... ! voice service voip fax protocol t38 ! ..... ! interface Ethernet0/0 ip address 10.0.47.47 255.255.0.0 h323-gateway voip interface h323-gateway voip id ipaddr 10.0.47.36 1719 h323-gateway voip h323-id 36402 ! ..... ! dial-peer voice 14151 voip !!! Uses t38 fax from voice service voip destination-pattern 14151.. session target ras ! dial-peer voice 14152 voip !!! Uses Cisco fax for a specific dial peer destination-pattern 14152.. session target ras fax protocol cisco ! gateway ! ! ..... ! end
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Multiservice Applications Command Reference for Cisco IOS Release 12.1.
![]() |
Note The modified command is marked by an asterisk. |
To specify the global default fax protocol for all the VoIP dial peers, use the fax protocol command in voice-service configuration mode. To return to the default fax protocol, use the no form of this command.
fax protocol {cisco | t38 [ls_redundancy value] [hs_redundancy value]}
Syntax Description
cisco Cisco proprietary fax protocol. t38 ITU-T T.38 standard fax protocol. ls_redundancy value (Optional) Low-speed redundancy for the T.38 fax protocol. The value can be from 0 to 5. The default is 0. The ls_redundancy parameter refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. hs_redundancy value (Optional) High-speed redundancy for the T.38 fax protocol. The value can be from 0 to 2. The default is 0. The hs_redundancy parameter refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data.
Defaults
Cisco fax protocol
Command Modes
Voice-service configuration
Command History
Release 12.1(3)T This command was introduced on the Cisco 2600 series routers, Cisco 3600 series routers, and Cisco MC3810 concentrators.
Release
Modification
Usage Guidelines
Use the fax protocol t38 command to configure T.38 Fax Relay for VoIP. The t38 keyword enables the T.38 Fax Relay protocol. The cisco keyword selects the original Cisco proprietary fax protocol. When the system keyword is selected in the dial peer, it specifies the global default fax protocol used by a dial peer, set by the fax protocol t.38 command. Optional parameters ls_redundancy and hs_redundancy are used to send redundant T.38 fax packets.
![]() |
Note The ls_redundancy and hs_redundancy parameters are applicable only to T.38 Fax Relay protocol. |
The ls_redundancy parameter refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. For the ls_redundancy parameter, the value can be from 0 to 5. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
The hs_redundancy parameter refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data. For the hs_redundancy parameter, the value can be from 0 to 2. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
![]() |
Note Setting the hs_redundancy parameter greater than 0 will cause a significant increase in the network bandwidth consumed by the fax call. |
Examples
The following example shows T.38 fax protocol for VoIP in a global configuration mode:
Router(config)# voice service voip Router(config-voi-serv)# fax protocol t38
Related Commands
fax protocol (dial-peer) Specifies the fax protocol for a specific VoIP dial peer.
Command
Description
To specify the fax protocol for a specific VoIP dial peer, use the fax protocol command in dial-peer configuration mode. To return to the default fax protocol, use the fax protocol system command. To disable T.38 fax protocol for a specific dial peer, use the no form of this command.
fax protocol {cisco | t38 [ls_redundancy value] [hs_redundancy value] | system}
Syntax Description
cisco Cisco proprietary fax protocol. t38 ITU-T T.38 standard fax protocol. ls_redundancy value (Optional) Low-speed redundancy for the T.38 fax protocol. The value can be from 0 to 5. The default is 0. The ls_redundancy parameter refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. hs_redundancy value (Optional) High-speed redundancy for the T.38 fax protocol. The value can be from 0 to 2. The default is 0. The hs_redundancy parameter refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data. system Global fax protocol when neither cisco or t38 is specified. The value is taken from the global configuration by default.
Defaults
Default is fax protocol system.
Command Modes
Dial-peer configuration
Command History
Release 12.1(3)T This command was introduced on the Cisco 2600 series routers, Cisco 3600 series routers, and Cisco MC3810 concentrators.
Release
Modification
Usage Guidelines
Use the fax protocol t38 command to configure T.38 Fax Relay for a specific dial peer. The t38 keyword enables the T.38 Fax Relay protocol. The cisco keyword selects the original Cisco proprietary fax protocol. When the system keyword is selected in the dial peer, it specifies the global default fax protocol used by a dial peer, set by the fax protocol t.38 command. Optional parameters ls_redundancy and hs_redundancy are used to send redundant T.38 fax packets.
![]() |
Note The ls_redundancy and hs_redundancy parameters are applicable only to T.38 Fax Relay protocol. |
The ls_redundancy refers to data redundancy in the low-speed V.21 based T.30 fax machine protocol. For the ls_redundancy, the value can be from 0 to 5. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
The hs_redundancy refers to data redundancy in the high-speed V.17, V.27, and V.29 T.4 or T.6 fax machine image data. For the hs_redundancy, the value can be from 0 to 2. The default is 0 (no redundancy). The parameter value sets the redundancy factor for the T.38 Fax Relay.
![]() |
Note Setting the hs_redundancy greater than 0 will cause a significant increase in the network bandwidth consumed by the fax call. |
Examples
The following example shows T.38 Fax Relay for VoIP in dial-peer configuration mode:
Router(config)# dial-peer voice 99 voip Router(config-dial-peer)# fax protocol t38
Related Commands
fax rate Establishes the rate at which a fax is sent to the specified dial peer.
Command
Description
To establish the rate at which a fax is sent to the specified dial peer, use the fax rate dial-peer configuration mode command. To reset the dial peer for voice calls, use the no form of the command.
fax rate {12000 | 14400 | 2400| 4800 | 7200 | 9600} {disable | voice} [bytes bytes]
Syntax Description
12000 Specifies a fax transmission speed of 12,000 bits per second (bps). 14400 Specifies a fax transmission speed of 14,400 bps. 2400 Specifies a fax transmission speed of 2400 bps. 4800 Specifies a fax transmission speed of 4800 bps. 7200 Specifies a fax transmission speed of 7200 bps. 9600 Specifies a fax transmission speed of 9600 bps. disable Disables Fax Relay transmission capability. voice Specifies the highest possible transmission speed allowed by the voice rate. For example, if the voice codec is G.711, fax transmission may occur up to 14400 bps since 14400 bps is less than the 64k voice rate. If the voice codec is G.729 (8k), the fax transmission speed will be 7200 bps. bytes (Optional) Selects the fax payload size. bytes Number of bytes.
Defaults
Voice calls
Command Modes
Dial-peer configuration mode.
Command History
11.3(1)T This command was introduced as fax-rate command. 12.0(2)XH The fax transmission rate of 12000 was added. 12.0(4)T This command was supported on the Cisco MC3810. 12.1(3)T The command name changed from fax-rate command to fax rate command (non-hyphenated).
Release
Modification
Usage Guidelines
Use the fax rate command to specify the fax transmission rate to the specified dial peer.
The values for this command apply only to the fax transmission speed and do not affect the quality of the fax itself. The higher transmission speed values (14,400 bps) provide a faster transmission speed but monopolize a significantly large portion of the available bandwidth. The lower transmission speed values (2400 bps) provide a slower transmission speed and use a relatively smaller portion of the available bandwidth.
![]() |
Note The fax call will not get compressed using the ip rtp header-compression command, because User Datagram Protocol (UDP) is being used and not Real-time Transport Protocol (RTP). For example, 9600 fax call will take about 24 kbps. |
If the fax rate transmission speed is set higher than the codec rate in the same dial peer, the data sent over the network for fax transmission will be above the bandwidth reserved for Resource Reservation Protocol (RSVP).
![]() |
Tips Because a large portion of the available network bandwidth will be monopolized by the fax transmission, Cisco does not recommend setting the fax rate value higher than the value of the selected codec. If the fax rate value is set lower than the codec value, faxes will take longer to send but will use less bandwidth. |
The voice keyword specifies the highest possible transmission speed allowed by the voice rate. For example, if the voice codec is G.711, the fax transmission may occur up to 14400 bps since 14400 bps is less than the 64k voice rate. If the voice codec is G.729 (8k), the fax transmission speed will be 7200 bps.
Examples
The following example shows a fax rate transmission speed of 9600 bps for faxes sent using a dial peer:
Router(config)# dial-peer voice 100 voip Router(config-dial-peer)# fax rate 9600
The following example sets a fax rate transmission speed at 12000 bps and the size of the fax-data frame at 20 bytes:
Router(config-dial-peer)# fax rate 12000 bytes 20
Related Commands
codec (dial-peer) Specifies the voice coder rate of speech for a dial peer. fax protocol (dial-peer) Specifies the fax protocol for a specific VoIP dial peer.
Command
Description
To enter the voice-service configuration mode and specify the voice encapsulation type, use the voice service global configuration command. To exit the voice-service configuration mode, use the exit command.
voice service voip
Syntax Description
voip Specifies Voice over IP parameters.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.1(1)XA This command was introduced for VoATM on the Cisco MC3810 concentrators. 12.1(2)T This command was implemented in Cisco IOS Release 12.1(2)T on the Cisco MC3810 concentrators. 121(3)T This command was implemented in Cisco IOS Release 12.1(3)T for VoIP on the Cisco 2600 series routers, Cisco 3600 series routers, and Cisco MC3810 concentrators.
Release
Modification
Usage Guidelines
Use the voice service command to switch to the voice-service configuration mode from the global configuration mode and to specify a voice encapsulation type. Use the exit command to exit the voice-service configuration mode and return to the global configuration mode.
Examples
The following example shows how to access the voice-service configuration mode and specify VoIP parameters, beginning in global configuration mode:
Router(config)# voice service voip Router(config-voice-service)#
Related Commands
modem passthrough Configures modem pass through over VoIP. fax protocol Specifies the global default fax protocol for all the VoIP dial peers.
Command
Description
ANIAutomatic Number Identification (ANI) is a service that provides the receiver of a telephone call with the number of the calling phone. The service is often provided by sending the digital tone multi frequency (DTMF) tones with the call. Users of ANI can screen callers with this information.
DSPdigital signal processor.
H.235H.235 provides security for the RAS signaling between H.323 endpoints and gatekeepers so that only duly authenticated and authorized endpoints are able to use Gatekeeper resources.
H.323ITU-T Recommendation for "Visual Telephony System" and equipment for local area networks which provide a non-guaranteed quality of service.
HCMHigh-density Compression Module.
MCMMultimedia Conference Manager.
OLCOpen Logical Channel.
RSVPResource Reservation Protocol.
T.30ITU-T Recommendation for analog phone line Group 3 facsimile terminals.
T.38 FaxITU-T Recommendation for T.38 describes the features necessary to transfer facsimile documents in real-time between two standard Group 3 facsimile terminals over the Internet or other networks by using IP protocols. The recommendation allows the use of either TCP or UDP depending on the service environment.
VCMVoice Compression Module.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed Sep 27 12:49:22 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.