(Page 1 of 1 in this chapter)

Chapter 3

Configuration and Performance Optimization

: 3.1 Introduction
: 3.2 Maximize the Ports For Fax Transmission
: 3.3 Maximizing Universal Ports
: 3.4 Supporting All Ports on the Board

3.1 Introduction

This chapter explains how to use the AG boards in your system to optimize a NaturalFax application's performance. NaturalFax is supported on the following AG boards: · AG-8/80 · AG-T1 · AG-E1 · AG-24+ · AG-30 · AG-48 · AG-60 · AG-T1 v2 · AG-E1 v2 · AG Quad T AG Quad E
An AG board's DSP resources can support a combination of voice, fax transmit, and fax receive operations. Voice operations include basic CT Access telephony functionality such as voice play and record, tone detection, and tone generation. You can control DSP resource allocation for a particular board by editing its configuration in the AG configuration file.
Hardware-related performance is measured by the available: Ports per board Number and type of operations that can be run per port
Use one of the following strategies to make the most efficient use of AG board resources, as appropriate to the design and purpose of the application: Maximize the number of ports that can run voice and fax transmit operations Maximize the number of universal ports (each port can run any voice or fax function) Support all ports on a board
All of the configurations presented in the following sections have been load tested without echo cancellation, using NMS speech encoding for voice functions. If your application requires a different use of DSP resources (e.g., adding echo cancellation or using different speech encoding), you may achieve different performance results.
Refer to the appropriate sample AG configuration files, as listed in each table, for detailed comments editing specific configuration statements to achieve the desired performance.
In some configurations, a board's DSP resources cannot support an application that uses all the ports on the board; some ports must be left idle. If the number of operations performed exceed the board's ability to support them, an NFXEVN_SESSION_DONE event is returned with the reason CTAERR_OUT_OF_RESOURCES.
Test your application carefully using the number of ports and the functionality that it will use during normal operation to ensure you have sufficient DSP resources.
Refer to the AG Runtime Configuration and Developer's Manual for further information on ADI service DSP requirements. Refer to Appendix F of this manual for further information on NaturalFax DSP requirements.

3.2 Maximizing Ports For Fax Transmission

The following table shows the maximum number of ports that support voice and fax transmit operations for each AG board. It also lists the appropriate example AG configuration files.
This strategy provides the highest number of ports per board that support fax transmit operations, but all ports may not support all operations. Some of the hardware configurations listed can support only voice and fax transmit operations and cannot support fax receive operations on any ports. Maximum Fax Transmit Operations per Board Configuration file for: Board Number of Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 24 Voice and Fax Transmit only agt1fax.cfg None AG-E1 30 Voice and Fax Transmit only None age1fxtx.cfg AG-24+ 24 Voice and Fax Transmit only ag24fax.cfg ag24faxa.cfg AG-30 30 Voice and Fax Transmit only ag30fax.cfg ag30faxa.cfg AG-48 48 Voice and Fax Transmit only ag48fxtx.cfg ag48fxta.cfg AG-60 60 Voice and Fax Transmit only ag60fxtx.cfg ag60fxta.cfg AG-T1 v2 24 None agt1fax.cfg None AG-E1 v2 30 None None age1fax.cfg AG Quad T 48 Voice and Fax Transmit only agqtfax.cfg None AG Quad E 48 Voice and Fax Transmit only None agqefax.cfg

Maximum Fax Transmit Operations per Board	Configuration file for:
Board	Number of Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	24	Voice and Fax Transmit only	`agt1fax.cfg`	None
AG-E1	30	Voice and Fax Transmit only	None	`age1fxtx.cfg`
AG-24+	24	Voice and Fax Transmit only	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	30	Voice and Fax Transmit only	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	48	Voice and Fax Transmit only	`ag48fxtx.cfg`	`ag48fxta.cfg`
AG-60	60	Voice and Fax Transmit only	`ag60fxtx.cfg`	`ag60fxta.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None
AG-E1 v2	30	None	None	`age1fax.cfg`
AG Quad T	48	Voice and Fax Transmit only	`agqtfax.cfg`	None
AG Quad E	48	Voice and Fax Transmit only	None	`agqefax.cfg`

3.3 Maximizing Universal Ports

The following table shows the maximum number of universal ports that each AG board can support. It also lists the appropriate example AG configuration files.
Universal ports can run any voice or fax operation. In some configurations, using the maximum number of universal ports does not permit any of remaining ports to be used. Under these conditions, each available port can support all operations, but all ports on the board may not be available. This strategy provides the best functionality per port. Maximum Universal (Fax and Voice) Ports per Board Configuration file for: Board Number of Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 20 Remaining ports must be unused agt1fax.cfg None AG-E1 20 Remaining ports must be unused None age1fax.cfg AG-24+ 20 Remaining ports must be unused ag24fax.cfg ag24faxa.cfg AG-30 20 Remaining ports must be unused ag30fax.cfg ag30faxa.cfg AG-48 40 Remaining ports must be unused ag48fax.cfg ag48faxa.cfg AG-60 40 Remaining ports must be unused ag60fax.cfg ag60faxa.cfg AG-T1 v2 24 None agt1fax.cfg None AG-E1 v2 30 None None age1fax.cfg AG Quad T Refer to the NaturalFax readme file for details agqtfax.cfg None AG Quad E Refer to the NaturalFax readme file for details None agqefax.cfg
For example, for an application requiring two full T1 spans running fax transmit and receive operations, you would need two AG-T1 boards and an AG-8/80 DSP board. The AG-T1 boards each provide 24 telephone channels and DSP resources for 20 ports of fax and voice operations. The AG-8/80 DSP board provides the DSP resources for 8 additional ports of fax and voice operations.
Refer to Appendix F of this manual for further information on NaturalFax DSP resource consumption.

Maximum Universal (Fax and Voice) Ports per Board	Configuration file for:
Board	Number of Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	20	Remaining ports must be unused	`agt1fax.cfg`	None
AG-E1	20	Remaining ports must be unused	None	`age1fax.cfg`
AG-24+	20	Remaining ports must be unused	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	20	Remaining ports must be unused	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	40	Remaining ports must be unused	`ag48fax.cfg`	`ag48faxa.cfg`
AG-60	40	Remaining ports must be unused	`ag60fax.cfg`	`ag60faxa.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None
AG-E1 v2	30	None	None	`age1fax.cfg`
AG Quad T	Refer to the NaturalFax `readme` file for details	`agqtfax.cfg`	None
AG Quad E	Refer to the NaturalFax `readme` file for details	None	`agqefax.cfg`

3.4 Supporting All Ports on the Board

The following table shows the configurations for supporting all ports on a board. It also lists the appropriate example AG configuration files.
In some configurations, fax operations are only allowed on a subset of the ports. This strategy provides the highest number of available ports per board, but each port may not support all operations. Supporting All Ports per Board Configuration file for: Board Number of Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 15 9 Voice, Fax Transmit, Fax Receive Voice only agt1fax.cfg None AG-E1 4 26 Voice, Fax Transmit, Fax Receive Voice only None age1fax.cfg AG-24+ 15 9 Voice, Fax Transmit, Fax Receive Voice only ag24fax.cfg ag24faxa.cfg AG-30 4 26 Voice, Fax Transmit, Fax Receive Voice only ag30fax.cfg ag30faxa.cfg AG-48 30 18 Voice, Fax Transmit, Fax Receive Voice only ag48fax.cfg ag48faxa.cfg AG-60 8 52 Voice, Fax Transmit, Fax Receive Voice only ag60fax.cfg ag60faxa.cfg AG-T1 v2 24 None agt1fax.cfg None AG-E1 v2 30 None None age1fax.cfg AG Quad T Refer to the NaturalFax readme file for details agqtfax.cfg None AG Quad E Refer to the NaturalFax readme file for details None agqefax.cfg
For example, for an application supporting a full T1 span, your application may use any combination of voice and fax functions on the first 15 ports on the AG-T1 board. Your application must restrict the remaining 9 ports to use only voice functions to ensure that enough DSP resources are available for each port.

Supporting All Ports per Board	Configuration file for:
Board	Number of Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	15 9	Voice, Fax Transmit, Fax Receive Voice only	`agt1fax.cfg`	None
AG-E1	4 26	Voice, Fax Transmit, Fax Receive Voice only	None	`age1fax.cfg`
AG-24+	15 9	Voice, Fax Transmit, Fax Receive Voice only	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	4 26	Voice, Fax Transmit, Fax Receive Voice only	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	30 18	Voice, Fax Transmit, Fax Receive Voice only	`ag48fax.cfg`	`ag48faxa.cfg`
AG-60	8 52	Voice, Fax Transmit, Fax Receive Voice only	`ag60fax.cfg`	`ag60faxa.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None
AG-E1 v2	30	None	None	`age1fax.cfg`
AG Quad T	Refer to the NaturalFax `readme` file for details	`agqtfax.cfg`	None
AG Quad E	Refer to the NaturalFax `readme` file for details	None	`agqefax.cfg`

(Page 1 of 1 in this chapter)

tech_support@nmss.com