Fax Boards and Fax Drivers Installation 6.1 www.esker.
VSI-FAX Version 6.1 Issued April 2009 Copyright © 2001-2009 Esker S.A. All rights reserved. Esker, the Esker logo, Esker on Demand, VSI-FAX and LanFax are registered trademarks of Esker, S.A. in the United States, France, and other countries. Microsoft, Windows, Windows Server, Outlook, Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Intel and Pentium are registered trademarks of Intel Corporation in the U.S.
Table of Contents Fax boards and fax drivers installation ................................................... 5 Dialogic Brooktrout fax boards and drivers............................................ 7 Installing Brooktrout drivers on Windows .............................................. 9 Installing the Plug and Play driver for TR1034, TruFax boards................................... 10 Configuring the Brooktrout driver for TR1034, TruFax boards or SR140....................
Fax boards and fax drivers installation This section's aim is to help you install fax board drivers to fax through VSI-FAX. VSI-FAX takes advantage of device-independent fax drivers to support a wide variety of fax solutions. The deviceindependent fax drivers give you the flexibility to choose the appropriate fax hardware or software. The faxed output will be the same high-quality image, regardless of the brand of the fax solution you choose.
Dialogic Brooktrout fax boards and drivers VSI-FAX supports various Dialogic® Brooktrout® drivers from Dialogic Corporation®. This allows you to choose the ® ® most appropriate fax solution for your needs. The two main Dialogic Brooktrout fax solutions that you can set up with VSI-FAX are : Faxing using a fax board: Brooktrout TR1034™ or TruFax fax boards. Refer to Recommended modems and fax boards in the VSI-FAX Recommended Modems and Fax Boards documentation for a complete list of the supported boards.
FAX BOARDS AND FAX DRIVERS INSTALLATION Installing the Brooktrout drivers Depending on your platform, refer to the corresponding topic below to install the drivers for your Brooktrout board: Installing Brooktrout drivers on Windows (page 9) Installing Brooktrout drivers on Unix/Linux (page 35) 8
Installing Brooktrout drivers on Windows VSI-FAXsupports Dialogic® Brooktrout® TR1034 boards, TruFax boards and SR140 software on a Windows platform. Follow the roadmap that corresponds to the type of fax system you have chosen to set up. TR1034, TruFax boards on Windows roadmap You must install the Brooktrout fax driver provided with VSI-FAX when the fax board is detected by your system and before VSI-FAX installation.
FAX BOARDS AND FAX DRIVERS INSTALLATION Installing the Plug and Play driver for TR1034, TruFax boards The Brooktrout TR1034, TruFax boards come with a plug and play (PnP) driver. Follow the explanations below to install or update this driver depending on your situation. In case of fresh installation... If you do not have any Brooktrout board physically installed in your server: 1. Stop your server. 2. Install your board. 3. Switch on your server. 4.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS Click No. You need to update the Plug and Play driver with the one included in the new version of VSI-FAX. Follow the steps below. To launch the update of the Plug and Play driver: 1. Verify that all faxes are completed prior to installing the new driver. 2. Stop the VSI-FAX Server service. 3. Set the VSI-FAX Server service to manual if it was on automatic. 4.
FAX BOARDS AND FAX DRIVERS INSTALLATION 2.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS 3. Click Finish when the installation is completed: 4. Open the Device Manager and check that the Brooktrout device appears with no error: If the device appears with an error, try to reboot the server and repeat the Plug and Play installation. Now that you have installed/updated the Plug and Play driver, you can launch VSI-FAX Server setup. During the server upgrade, you will configure your Brooktrout board with the new driver you have just upgraded to.
FAX BOARDS AND FAX DRIVERS INSTALLATION 2. You will install the driver from the VSI-FAX CD-ROM, not from the disc that came with the board. Click I don't have the disc. Show me the other options: 3.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS 4.
FAX BOARDS AND FAX DRIVERS INSTALLATION 5.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS 6.
FAX BOARDS AND FAX DRIVERS INSTALLATION 7. Open the Device Manager and check that the Brooktrout device appears with no error: If the device appears with an error, try to reboot the server and repeat the Plug and Play installation. Now that you have installed/updated the Plug and Play driver, you can launch VSI-FAX Server setup. During the server upgrade, you will configure your Brooktrout board with the new driver you have just upgraded to.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS From the main installation program For details on the wizards, refer to Driver installation and configuration procedure. From a standalone installation program You may launch the Brooktrout fax driver's setup separately from the server setup at any time. This is the recommended method in case of a fresh installation.
FAX BOARDS AND FAX DRIVERS INSTALLATION • To use a TR1034 or TruFax fax board, you should install/update the plug and play driver with the one provided in the \drivers subfolder of the VSI-FAX CD-ROM. Refer to Installing the Plug and Play driver for TR1034, TruFax boards (page 10). • To use SR140, ignore this message and click Yes. 2.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS 3. Click Next to proceed with the Brooktrout TR1034-SR140 drivers support installation.
FAX BOARDS AND FAX DRIVERS INSTALLATION • In the case of an upgrade, you can change the option selection. Leave the screen as is with Install/Reinstall and Keep actual boards configuration options selected to keep your configuration and simply update it. Be aware that selecting Reset actual boards configuration clears all your configurations and performs a fresh installation of the Brooktrout drivers. Click Next to launch the Brooktrout TR1034SR140 drivers installation.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS Fax board in PSTN mode configuration After the steps described in Configuring the Brooktrout driver for TR1034, TruFax boards or SR140 (page 18), continue with the steps below if you own a fax board with which you will perform PSTN physical faxing only. 1. If your fax board supports Fax over IP, the Configure IP Stack dialog box displays when the Brooktrout Configuration Tool is launched.
FAX BOARDS AND FAX DRIVERS INSTALLATION 3. Expand the Call Control Parameters node in the tree view, click the fax board item (e.g. Module 0x2: TR1034...) On the Global Settings tab in the Call Control Type field, select PSTN not to use Fax over IP even if available. You should not have to change the port or anything. The next step is to apply your configuration and quit Brooktrout Configuration Tool. 4. IMPORTANT: Click the Apply button ( ) in the toolbar to apply your configuration.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS change boards or add a new one, run vsi-boston-config.exe under \VSI-FAX\FaxServer\lbin\ in the installation directory. Fax board with Fax over IP configuration After the steps described in Configuring the Brooktrout driver for TR1034, TruFax boards or SR140 (page 18), continue with the steps below if you own a fax board with which you perform both PSTN physical faxing and Fax over IP. 1.
FAX BOARDS AND FAX DRIVERS INSTALLATION 3. Expand the Call Control Parameters node in the tree view, click the fax board item (e.g. Module 0x2: TR1034...) On the Global Settings tab in the Call Control Type field, select IP to configure Fax over IP (be it with H323 and/or SIP stack). 4. (if you selected H323 in the IP Stack dialog box) To configure the Brooktrout H323 stack to run on the board, expand the Call Control Parameters node in the tree view, click the fax board item (e.g. Module 0x2: TR1034...
INSTALLING BROOKTROUT DRIVERS ON WINDOWS Then expand the IP Call Control Modules node in the tree view, and select H.323. In the right pane, open the IP Parameters tab, and enter the default gateway as shown below: 5. (if you selected SIP in the IP Stack dialog box) To configure the Brooktrout SIP stack to run on the board, expand the Call Control Parameters node in the tree view, click the fax board item (e.g. Module 0x2: TR1034...
FAX BOARDS AND FAX DRIVERS INSTALLATION Then expand the IP Call Control Modules node in the tree view, and select SIP. In the right pane, open the IP Parameters tab, and enter the default gateway as shown below: 6. IMPORTANT: Click the Apply button ( ) in the toolbar to apply your configuration. This ensures that the Brooktrout board is correctly installed. You can see a progress bar during configuration update. 7.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS 10. Click Yes to start VSI-FAX Server. 11. Click Finish on the final summary screen to complete. Note After the installation, you can modify your board configuration by launching the Brooktrout Configuration Tool. For this, run the configtool.exe program located in the %ProgramFiles%\Brooktrout\bin directory. If you need to change boards or add a new one, run vsi-boston-config.exe under \VSI-FAX\FaxServer\lbin\ in the installation directory.
FAX BOARDS AND FAX DRIVERS INSTALLATION 2. To set up Fax over IP with SR140 software solution, you must specify an SR140 Fax Software license. Click on the License button in Brooktrout Configuration Tool. Brooktrout License Manager is launched. You will use it to display and copy the NodeId of your computer and to obtain an SR140 license for this NodeId. • In the Brooktrout License Manager, select Utilities > Display Nodes Lock. Double-click to select the Node ID.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS • Once you have received your license file (i.e. .lic file), select License > Install license in Brooktrout License Manager. Specify your license file and close Brooktrout License Manager. • In the Brooktrout Configuration Tool, check that your license is correctly recognized under Call Control Parameters: 3. In the Configure IP Stack dialog box, select SIP or H323 depending on which Brooktrout stack you want to use and click OK. 4.
FAX BOARDS AND FAX DRIVERS INSTALLATION Then expand the IP Call Control Modules node in the tree view, and select H.323. In the right pane, open the IP Parameters tab, and enter the default gateway as shown below: 5. (if you selected SIP in the IP Stack dialog box) To configure the Brooktrout SIP stack, expand the Call Control Parameters node in the tree view, click the SR140 item (e.g.
INSTALLING BROOKTROUT DRIVERS ON WINDOWS Then expand the IP Call Control Modules node in the tree view, and select SIP.
FAX BOARDS AND FAX DRIVERS INSTALLATION 6. IMPORTANT: Click the Apply button ( progress bar during configuration update. ) in the toolbar to apply your configuration. You can see a 7. Once your configuration has been applied, select File > Exit to quit the Brooktrout Configuration Tool. 8. A summary screen displays. Click Next to complete. 9. If you have launched the Brooktrout TR1034-SR140 drivers installation from VSI-FAX Server's main setup, you are asked whether to start the VSI-FAX Server. 10.
Installing Brooktrout drivers on Unix/Linux VSI-FAX supports Dialogic® Brooktrout® TR1034 boards, TruFax boards and SR140 software on a UNIX/Linux platform. Follow the roadmap that corresponds to the type of UNIX/Linux fax system you have chosen to set up on your UNIX/Linux platform. TR1034, TruFax boards on Unix/Linux roadmap To set up VSI-FAX with Dialogic® Brooktrout® TR1034 boards, TruFax boards on a UNIX/Linux platform, you have to follow these main steps: 1. Install VSI-FAX Server.
FAX BOARDS AND FAX DRIVERS INSTALLATION The explanations below only lists the main steps of the installation under Unix/Linux platform with the CD-ROM. If you need more details on the steps, information about installing the Fax Server using a downloaded file, refer to Installing VSI-FAX Server on Unix/Linux in the Installation and Administration documentation. 1. Mount the CD-ROM drive. 2. Change directory to the CD-ROM mount point by entering: cd /mnt/cdrom 3. Run the installation program by entering: .
INSTALLING BROOKTROUT DRIVERS ON UNIX/LINUX 3. Enter the name of the directory to extract the drivers install files into. This directory must have at least 60 MB free. (The default location is /tmp) 4. Check the installation path. (The default location is /usr/vsifax). 5. Answer yes when prompted to shut down running VSI-FAX servers. 6. If you were using a Brooktrout board with a former version of VSI-FAX, we recommend that you answer no when prompted whether you want to keep the existing configuration.
FAX BOARDS AND FAX DRIVERS INSTALLATION The setup chcon -t chcon -t chcon -t chcon -t has to run these commands to allow loading the Dialogic deamon: textrel_shlib_t /usr/sys/boston/lib/4.1/bostlib_mt.so textrel_shlib_t /usr/sys/boston/lib/4.1/brkth323_mt.so textrel_shlib_t /usr/sys/boston/lib/4.1/brktsip_mt.so textrel_shlib_t /usr/sys/boston/lib/4.1/bostvb.so Can the setup run the above commands ? (y/n) [y] : When you see the above prompt, answer yes.
INSTALLING BROOKTROUT DRIVERS ON UNIX/LINUX Your board is now installed. 14. Answer yes when asked if you want to start automatically the VSI-FAX Brooktrout TR1034 drivers at boot time. 15. Answer yes when asked if you want to start the VSI-FAX Admin Server. 16. Answer yes when asked if you want to start the VSI-FAX Fax Server. 17. The fax board configuration is now complete. You can use the vfxstat command to view the status of each fax line.
FAX BOARDS AND FAX DRIVERS INSTALLATION 6. Services are shut down and VSI-FAX Brooktrout TR1034-SR140 drivers are installed: Installing VSI-FAX Brooktrout TR1034-SR140 drivers ............................................ Installing the Boston driver Installing Brooktrout Boston Device Driver Version 6.0.0 Configuring Boston driver: Max PCI hw modules 16 Phys buf size 32768 App buf size 10240 Machine ID 1 History disabled The Brooktrout Boston Driver has been installed on your system.
INSTALLING BROOKTROUT DRIVERS ON UNIX/LINUX Can the setup run the above commands ? (y/n) [y] : y If you answer no, the installation will abort after displaying the following message: Can the setup run the above commands ? (y/n) [y] : n The setup will abort because the listed libraries have not text relocation attributes. 8.
FAX BOARDS AND FAX DRIVERS INSTALLATION You can open this file from the \docs folder on the VSI-FAX CD-ROM. Step 3: Complete the Brooktrout drivers installation 1. Once you have your license file, return to the Brooktrout drivers installation program at this stage: Did you already generate SR140 Fax Software license for this computer with NodeId: Is this OK? (y/n) [y] : Answer yes. 2. Enter the source path of your SR140 Fax Software license file, for example, /root/Desktop/licens.lic. 3.
INSTALLING BROOKTROUT DRIVERS ON UNIX/LINUX ch06 ch07 ch08 ch09 ch10 ch11 SR140 SR140 SR140 SR140 SR140 SR140 mod mod mod mod mod mod 65 65 65 65 65 65 ch ch ch ch ch ch 8 9 10 11 12 13 bm bm bm bm bm bm yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes ch65-8 ch65-9 ch65-10 ch65-11 ch65-12 ch65-13 (slave (slave (slave (slave (slave (slave of of of of of of ch00) ch00) ch00) ch00) ch00) ch00) Recompiling on Linux platforms Use the instructions below to recompile the Bost
FAX BOARDS AND FAX DRIVERS INSTALLATION under /usr/sys/boston/kernel. Once the driver has been successfully recompiled, please resume the setup procedure by relaunching /usr/vsifax/lbin/vsi-boston-config.sh Installation aborted. The source files that will let you recompile the driver are located in the following directory: /usr/sys/boston/kernel 3.
INSTALLING BROOKTROUT DRIVERS ON UNIX/LINUX Modifying the Brooktrout board or SR140 configuration on Unix/Linux The configuration of your Brooktrout board (or virtual board in case of the SR140 Fax Software) is stored in the following directory: /usr/sys/boston This directory contains various configuration files, binaries and tools used by the fax board or SR140 Fax Software. The global settings used by your board or the SR140 Fax Software are stored in the btcall.cfg configuration file.
FAX BOARDS AND FAX DRIVERS INSTALLATION Troubleshooting problems with Brooktrout boards and SR140 on Unix/Linux For the platforms that use Brooktrout SDK version 6.0.0. (i.e. Red Hat Enterprise 4 and Red Hat Enterprise 5), the vfxsched restart command does not fully reinitialize the (virtual) fax board. For this reason, you need to issue the following commands each time you need to restart the Fax Server: 1. vfxsched stop 2. vsibost.sh stop (under /usr/vsifax/lbin/vsibost.sh) 3. vsibost.sh start 4.
Brooktrout configuration files This section explains the following configuration files for Dialogic Brooktrout TR1034 boards, TruFax boards, and SR140 software. Configuration file Description btcall The user-defined configuration file that contains configuration parameters for the API and driver. callctrl The call control configuration file is an ASCII file that contains general PCM configuration parameters for all telephony hardware units and static telephony connections to be formed for all modules.
FAX BOARDS AND FAX DRIVERS INSTALLATION Keyword agc Description Automatic gain control (AGC) method to use during speech recording (in decimal). 0=None. 1=Dynamic AGC; levels adjusted during recording. 2=Postrecord AGC; optimal level computed and reported at end of record. Value Type decimal Default value 1 busy_dt_ct Number of consecutive BUSY1, BUSY2, ROBUSY, or DIALTON call progress values that must occur before BfvLineOriginateCall will terminate with that result.
BROOKTROUT CONFIGURATION FILES Keyword Description Default value disabled, stdout dtmf_thresh DTMF detection threshold during voice play and record. 0.5 dB units, two's complement. Value is added to the default DTMF threshold of -28dB. Value Type decimal Default value 0 (-28dB) ecm_enable ECM (error correction mode) is enabled or disabled. The normal ECM frame size is 256 bytes. You can enable a frame size of 64 bytes, but the fax board uses that frame size on transmit only.
FAX BOARDS AND FAX DRIVERS INSTALLATION Keyword Description Value Type decimal Default value 1 error_mult Error multiplication value used to determine if the error percentage on a received page is too high. The number of errors per page is multiplied by this number and the product is divided by 2. If this result exceeds the number of lines on the page, the error percentage per page is too high and an RTN signal is returned to the transmitting station.
BROOKTROUT CONFIGURATION FILES Keyword Description values are: 0 = MH only. 1 = MR or MH. 5 = MMR, MR, or MH. Value Type decimal Default value 5 max_pagelist The maximum number of pages for which to store results during a call. The last max_pagelist PAGE_RES structures are accessible via the FAX_RES structure if this feature has been enabled. Value Type decimal Default value 30 max_timeout Specifies the maximum time, in milliseconds, that the API will delay waiting for activity to occur on a board.
FAX BOARDS AND FAX DRIVERS INSTALLATION Keyword Description Value Type decimal Default value 0 missing_wait Specifies the delay to apply during dialing when the dial string does not contain a w or a , at the start of the dial string or immediately following an initial 8 or 9 50 ms units. Value Type decimal Default value 20 (1 second) restrict_res Specifies allowable resolutions for fax reception.
BROOKTROUT CONFIGURATION FILES Keyword subpwdsep Description Enables reception of the SUB, PWD, and SEP FSK signals. Applications typically use these signals to direct or validate incoming calls. Value Type hex Default value 0 teleph The name of the telephony configuration file, which contains telephony hardware configuration information and static telephony connection information. If the file specified by the teleph keyword is present, then the file specified by the digital keyword will not be used.
FAX BOARDS AND FAX DRIVERS INSTALLATION Keyword Description mode after having missed the initial CED tone. Value Type decimal Default value 1 v34_enable Enables (1) or disables (0) V.34 fax modulation capability, if the hardware and firmware support it. Value Type decimal Default value 1 width_res_behavior Specifies the action taken as a result of page width or resolution mismatches on fax transmission. Does not affect fax reception.
BROOKTROUT CONFIGURATION FILES Global options internal_trace verbose = Stores a complete trace of operations in the specified trace_file. host_module_trace ip_stack_trace trace_file Turns on tracing and reports results to the filename specified for this parameter. To turn off tracing, comment this parameter out. max_trace_files Specifies the maximum size, in megabytes, allowed for the trace file.
FAX BOARDS AND FAX DRIVERS INSTALLATION Global options Each of these lines begins with the keyword connect, and is followed in order by the connection mode, source port class, unit, stream, and slot, and the destination port class, unit, stream, and slot. The meanings of these values follow. If you use this parameter to specify connections, the call control ignores any value set in the auto_connect parameter.
BROOKTROUT CONFIGURATION FILES Clock Configuration Parameters TrunkB = The network trunk, port B. TrunkC = The network trunk, port C. TrunkD = The network trunk, port D. TrunkE = The network trunk, port E. TrunkF = The network trunk, port F. TrunkG = The network trunk, port G. TrunkH = The network trunk, port H. Netref1 = The H.100/H.110 network reference (1) clock. Netref2 = The H.100/H.110 network reference (2) clock. clock_a = The H.100/H.110 A clock. clock_b = The H.100/H.110 B clock.
FAX BOARDS AND FAX DRIVERS INSTALLATION Port Configuration Parameters Use this parameter in conjunction with the fractional_start_channel parameter. Note: Set this parameter to -1 when not using fractional channels. Setting this parameter to 0 makes zero B-channels available.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for Analog Ports input_gain Specifies a value that defines the number of decibels (dB) to increase or decrease the power of the incoming audio signal on the phone line.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for Analog Ports Default: 100 (1 second) num_rings Specifies a value that defines the number of rings the system must detect before the system reports a new incoming call to the application. Range: 1 to 255 Default value: 2 output_gain Specifies a value that defines the number of decibels (dB) to increase or decrease the power of the outgoing audio signal on the phone line.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for BRI Ports multipoint circuit. Valid values are: AUTO = Automatically detects the datalink setting POINT2POINT = Configures for a point-to-point circuit POINT2MULTIPOINT = Configures for a point-to-multipoint circuit Default value: AUTO default_caller_id_channel_0 Specifies a string of up to 15 characters that provides the caller ID to use or when placing outbound calls on channel 0 ( or 1).
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for BRI Ports Default value: CPE max_did_digits Specifies a value that defines the maximum number of DID digits to expect before accepting an incoming call.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for BRI Ports preferred Specifies a Boolean value that causes outbound calls to set a use preference for the B channel when the port uses a point-to-multipoint circuit. Set this parameter only if the port uses a point-to-multipoint circuit. If other devices share the BRI line with the Brooktrout hardware, you must set this parameter to TRUE to make the B channel setting preferred on outbound calls.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for BRI Ports number. USER_NOT_SCREENED Indicates that the port provides the calling party number without validating it. USER_VERIFICATION_FAILED Indicates that the port failed to validate the calling party number. USER_VERIFICATION_PASSED Indicates that the port provided the calling party number and passed a successfully validated number to the called party. Note: Set the parameter to USER_NOT_SCREENED when connected to a public network.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for BRI Ports connect request before advancing an incoming call to the connected state. Default value: FALSE Configuration Parameters for E1 ISDN Ports call_type Specifies the call type to use when making the outbound call. Use one of the following values for this field: AUTO = Makes a call using the modem type and then automatically retries the call using the voice type if the other end cannot accept modem calls. MODEM = Makes a modem (3.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for E1 ISDN Ports Range: 0 through 20 Default value: 10 (used when the API does not find another value for this parameter) disable_conn_ack Specifies a Boolean value that determines whether the system sends a connection acknowledgment after receiving a connect message from the network. Set the parameter as follows: FALSE = The system sends a connection acknowledgment message after receiving a connect message from the network.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for E1 ISDN Ports numbering_type Specifies a value that identifies the type of telephone number used for outbound calls (called party number). Valid values are: ABBREVIATED Indicates that the port uses an abbreviated numbering type. INTERNATIONAL Indicates that the port uses an international numbering type. NATIONAL Indicates that the port uses a national numbering type. SUBSCRIBER Indicates that the port uses a subscriber numbering type.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for E1 ISDN Ports Asynchronous Balanced Mode Extended (SABME) messages. Set the parameter as follows: FALSE = Indicates that the port does not send SABME messages TRUE = Indicates that the port does send layer 2 SABME messages Default value: TRUE screening Specifies a value that indicates whether the port provides and validates the calling party number passed to the called party.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for E1 ISDN Ports transfer_variant Specifies the transfer method that the network (refer to the vendor specifications for your switch) runs for call transfers or disables call transfer.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for E1 R2 CAS Ports Default value: 120 max_did_digits Specifies a value that defines the maximum number of DID digits to wait for before accepting an incoming call.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for T1 ISDN Ports did_offset Specifies a value that defines the number of digits to remove from the beginning of the string of DID digits received from the network. Valid values are: 0 = Does not remove any DID digits 1 - 63 = Specifies the number of digits to remove Range: 0 through 63 Default value: 0 did_timeout Specifies a value that defines the maximum timeout allowed before processing the call after assuming receipt of the last DID digit.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for T1 ISDN Ports line_coding Specifies a value defining the type of line encoding to use for the port. Valid values are: B8ZS = Selects Bipolar 8-Zero Suppression JBZS = Selects Jammed Bit Zero Suppression ZBTSI = Selects Zero Byte Time Slot Interchange AMI = Selects Alternate Mark Inversion Default value: B8ZS max_did_digits Specifies a value that defines the maximum number of DID digits to expect before accepting an incoming call.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for T1 ISDN Ports (called party number). Valid values are: ABBREVIATED Indicates that the port uses an abbreviated numbering type. INTERNATIONAL Indicates that the port uses an international numbering type. NATIONAL Indicates that the port uses a national numbering type. SUBSCRIBER Indicates that the port uses a subscriber numbering type. UNKNOWN Indicates that the port uses an unknown numbering type.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for T1 ISDN Ports Asynchronous Balanced Mode Extended (SABME) messages. Set the parameter as follows: FALSE = Indicates that the port does not send SABME messages TRUE = Indicates that the port does send layer 2 SABME messages Default value: TRUE screening Specifies a value that indicates whether the port provides and validates the calling party number passed to the called party.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for T1 ISDN Ports FALSE = Requests that the system puts all the B-channels in service as soon as the D-channel is in service. TRUE = Requests that the system waits for the network to specifically enable each B-channel on the trunk before allowing the application to use a B-channel. Default value: Depends on the value set in the switch_type parameter.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuration Parameters for T1 RBS Ports connection between the board and the T1 service: 0_133 = Specifies a length of 0 to 133 feet 133_266 = Specifies a length of 133 to 266 feet 266_399 = Specifies a length of 266 to 399 feet 399_533 = Specifies a length of 399 to 533 feet 533_655 = Specifies a length of 533 to 655 feet 7_5_DB = Specifies a length of negative 7.5 dB 15_DB = Specifies a length of negative 15.0 dB 22_5_DB = Specifies a length of negative 22.
BROOKTROUT CONFIGURATION FILES Configuration Parameters for T1 RBS Ports reject_incomplete_did Specifies the action to take when the number of DID digits received from the incoming call is less than the number of digits specified for the max_did_digits field. Set the parameter as follows: FALSE = Reports the call to the application even if the number of received DID digits is less than the max_did_digits value.
FAX BOARDS AND FAX DRIVERS INSTALLATION Configuring T.38 Fax Transport Parameters Specify values for the following T38-specific parameters in the host_module.#/t38parameters section of the call control configuration file. Parameter media_renegotiate_ delay_inbound Value Specifies how long the system waits to renegotiate the media when the system uses media renegotiation on inbound calls.
BROOKTROUT CONFIGURATION FILES Parameter Value (UAC) has responsibility for renegotiating the media to image. Numbers greater than 0 indicate the number of milliseconds for the system to wait before attempting media renegotiation. Set this parameter to: -1 Disables media renegotiation on outbound calls. Use this value for a Cisco router. 0 Does not delay before attempting to renegotiate the media. >0 Waits this number of milliseconds before attempting to renegotiate the media.
FAX BOARDS AND FAX DRIVERS INSTALLATION Parameter t38_fax_transcoding_MMR Value Specifies whether the API can convert to and from MMR fax compression to reduce the bandwidth of the transport mechanism when using a reliable transport (for example, TCP). Set this parameter to: FALSE Indicates that the API does not support the capability. TRUE Indicates that the API can convert MMR compression. Value type: Boolean Default value: FALSE Note This parameter does not affect the normal T.
BROOKTROUT CONFIGURATION FILES Parameter Value the beginning of T.30. Value Type: Boolean Default value: FALSE t38_t30_fastnotify Specifies whether the transport signals the beginning of T.30 by means of a zero-length data field or uses a T.30 indicator value. Set this to parameter to: FALSE: Indicates that the T.38 fax transport uses a zero-length data field to signal the beginning of T.30. TRUE: Indicates that the transport uses a T30_INDICATORvalue to signal the beginning of T.30.
FAX BOARDS AND FAX DRIVERS INSTALLATION Key Name h323_default_gateway Description Indicates the IP address of a default gateway to use for outbound calls. If a user only specifies a phone number when making an H.323 call and the application is not using an H.323 gatekeeper, the API forwards the call to the gateway specified with this parameter. The API forwards the specified phone number to the gateway for routing purposes. When set, this parameter must contain an IP address in the form: xxx.xxx.xxx.
BROOKTROUT CONFIGURATION FILES Key Name Description Unit: second Range: 0 - 32,000,000 (0 means that gatekeeper registrations do not expire; 32,000,000 seconds equals one calendar year) Value Type: integer Default value: 0 h323_h323IDalias Specifies the H.323 ID of the H.323 terminal. The system uses this alias during gatekeeper registration and call establishment. The alias identifies the name of the H.323 terminal.
FAX BOARDS AND FAX DRIVERS INSTALLATION Key Name Description multicast gatekeeper discovery routine to find an available gatekeeper. 0 Does not support alternate gatekeepers. 1 Supports alternate gatekeepers when necessary. Value type: integer Default value: 0 Table 2. Basic Predefined SIP IP Call Control Stack Parameters Key Name sip_Contact Description Indicates the value provided in the SIP header for the Contact parameter.
BROOKTROUT CONFIGURATION FILES Key Name Description Value Type: character string (up to 256 characters) Default value: (empty string) sip_email Indicates the value used for the e=line in the SIP SDP. The e=line identifies the email address of the person or entity responsible for the session. Range: 1 - 255 characters Value Type: character string (up to 256 characters) Default value: (empty string) sip_From Indicates the value provided in the SIP header for the From parameter.
FAX BOARDS AND FAX DRIVERS INSTALLATION Key Name Description Do not use the DHCP value. It is reserved for future use. sip_registration_server1 Indicates the address of the specified SIP registration server. The user can define a maximum of 4 registration servers. sip_registration_server2 DHCP Causes the system to use the SIP DNS server locator capability to discover the domain name of the SIP registration server.
BROOKTROUT CONFIGURATION FILES Key Name Description system discards the request. Range: 1 - 200inclusive Value Type:decimal Default value: 70 sip_registration_interval Indicates the frequency for sending REGISTER requests to a registration server. 0 Indicates that the system does not send REGISTER requests to the registration server.
FAX BOARDS AND FAX DRIVERS INSTALLATION Key Name Description proxies. Range: 1 - 255characters (multiple addresses separated by a comma",") Value Type: character string (up to 256 characters) Default value: (empty string indicating no forced routing) Configuring Ethernet Interface Parameters In the module.#/ethernet.# section of the configuration file, identify the module's interface x using the 1-based index of the Ethernet interface.
BROOKTROUT CONFIGURATION FILES Parameter ip_arp_timeout Value Specifies the arp (address resolution protocol) timeout value that the module's Ethernet interface uses. Set this parameter to: Unit: minutes Range: 0 - 1,000,000 where 0 indicates that the timeout is disabled. Value type:decimal Default value: 10 ip_broadcast Specifies the IP broadcast address of the module's Ethernet interface. Set this parameter to: xxx.xxx.xxx.xxx Configures the Ethernet interface to use the specified broadcast address.
FAX BOARDS AND FAX DRIVERS INSTALLATION Parameter media_port_max Value Specifies the highest IP port number that the module can use. Set this value to a value 1000 above the value specified for the media_port_min parameter. 57000 Sets this value as the highest port number. Range: 2024-65535 Value type:decimal Default value: 57000 media_port_min Specifies the lowest IP port number that the module can use for media transmissions.
BROOKTROUT CONFIGURATION FILES sip_session_description=description_brooktrout sip_session_name=session_brooktrout sip_username=brooktrout [module.2] [module.2/clock_config] clock_source=internal clock_mode=master clock_compatibility=none [module.2/ethernet.1] dhcp=disabled ip_address=192.168.0.100 ip_netmask=255.255.255.0 ip_gateway=192.168.0.1 ip_broadcast=192.168.0.2 ip_arp_broadcast=10 media_port_min=1000 media_port_max=2000 ethernet_speed=auto [module.2/host_cc.
FAX BOARDS AND FAX DRIVERS INSTALLATION ip_netmask=255.255.255.0 ip_gateway=192.168.0.1 ip_arp_timeout=600 media_port_min=56000 media_port_max=57000 ethernet_speed=auto [module.2/host_cc.
Dialogic Diva Server fax boards and drivers Qualified platforms A supported operating system is one for which the software has been designed and tested. While it is possible that the software will operate properly with other versions, but we have not necessarily tested our software on platforms that are not listed. Esker does not support platforms and versions that are not in the following list: Windows Server 2003 SP2 32-bits or 64-bits. Windows Server 2008 32-bits or 64-bits.
FAX BOARDS AND FAX DRIVERS INSTALLATION For all these preliminary steps, refer to Dialogic documentation and technical support. Then, you are ready to install the fax server following the installation procedure explained in VSI-FAX Pre-Installation in the Installation and Administration documentation. Diva Server drivers installation for UNIX/Linux To install and configure Diva Server board drivers on UNIX/Linux: 1.
DIALOGIC DIVA SERVER FAX BOARDS AND DRIVERS Reinstallation If you want to install a Dialogic Diva Server board after the VSI-FAX server installation, you must execute the fax server installation using the following commands: Windows: launch vsiconfig.exe in the vsifax\lbin folder, where vsifax is the installation folder. Linux: execute ./vsi-server-config.sh in the vsifax/lbin directory, where vsifax is the installation directory.
