OpenVox FA40 user manual en
From Wiki
Contents |
Chapter 1 Overview
In most of the time, users need to reconnect the PSTN line to analog telephone to get it work when the PBX Server becomes power off. It may cause only a little extra work for people who use simple and small PBX servers. But for those who run complex PBXs in server rooms, it becomes real problems.
How to eliminate this problem? The release of OpenVox FA40 failover box for analog line answers it. The FA40 can automatically switch the PSTN line to analog telephone when the power of the PBX server has been cut off and will automatically switch back to normal when the power is on again. In this way, no more worries about getting the PSTN line connected to the telephone when the server is down.
FA40 is controlled through an Asterisk loadable module res_failover.so. This module keeps sending “running” signal to FA40 when Asterisk is running. Once Asterisk is down or system power is cut off, the module will not be able to send out the “running” signal to FA40 and thus FA40 will automatically switch to the standby telephone.
FA40 provides a reliable and flexible solution to Asterisk PBX.
Chapter 2 Features
Easy installation; uses USB to connect computer or server.
Industry standard USB type B connector.
USB 2.0 and 1.1 compliant.
Low power consumption, takes power from USB bus.
Standard length type A to type B cable provided.
Supports software watchdog.
Supports up to 4 standby telephones.
Supports multiple FA40 devices in one system.
Fully supports Asterisk (Version1.2/1.4/1.6).
Supports Elastix, Trixbox.
Small plastic enclosure: 285mm x 110mm x 34mm.
4 power supply indicator LEDs.
5 year warranty.
Supports all OpenVox analog cards, Digium, Sangoma analog cards and other compatible analog cards.
Chapter 3 Installation Guide
Hardware Connection
FA40 Connection Instruction: connect with the server by a USB interface. There are another four group ports, every group include four ports, LINE ports connect to PSTN, PHONE ports connect to analog phone, FXO ports of FA40 connect to FXO port of A series products and the same with FXS ports.
Device Driver Detection
The device driver of FA40 has been integrated with many Linux distributions. Users can run the following command to see if the FA40 has been recognized or detected by the system. (Please connect the FA40 to the server with attached USB cable that comes together with the product. Note: Please make sure that all the lights are on by switching the on-of button when the FA40 is connected to the server.)
# dmesg | grep FTDI
User can also run the lsusb command to check whether the FA40 device is connected. If the USB has been detected, you will see “Bus 003 Device 002” is included in outputs information.
# lsusb
Working Principle
When the PBX Server is ON, the PSTN signal goes from:PSTN network -> LINE port -> FXO port of FA40 -> FXO port of analog cards -> FXS port of a analog card -> FXS port of FA40-> PHONE port -> an analog phone.When calls from internal, the PSTN signal goes into reverse.
When the PBX Server stops working (poweroff), the PSTN signal goes from:PSTN network ->LINE port -> PHONE port -> an analog phone, in other words, the PSTN signal skip FXO and FXS port and connects LINE port to PHONE port directly.When calls from internal, the PSTN signal goes into reverse.
Software Installation
Software Download
# wget www.openvox.cn/download/drivers/failover/failover-1.0-current.tar.gz
Software Installation
It allows you to select one from three methods below to install asterisk.
Installation with asterisk 1.2.X
1) Unzip the file
# tar -xzvf failover-1.0-current.tar.gz # cd failover
2) Copy the file to res directory under asterisk
# cp res_failover.c $asterisksource/res/
3) Copy the configuration file to /etc/asterisk directory
# cp failover.conf /etc/asterisk/
4) Compile Makefile in res directory under asterisk
# vi /usr/src/asterisk/Makefile
5) Modify Makefile
MODS=res_indications.so res_monitor.so res_adsi.so res_agi.so res_features.so To: MODS=res_indications.so res_monitor.so res_adsi.so res_agi.so res_features.so res_failover.so
6) If asterisk is installed, please compile it and re-install
# cd $asterisksource # make # make install
7) Configure the /etc/asterisk/failover.conf file on requirements.
8) Reboot asterisk.
Installation with asterisk 1.4.X
1) Unzip the file
# tar -xzvf failover-1.0-current.tar.gz # cd failover
2) Copy the file to res directory under asterisk
# cp res_failover.c $asterisksource/res/
3) Copy the configuration file to /etc/asterisk directory
# cp failover.conf /etc/asterisk/
4) If asterisk is installed, please compile it and re-install
# cd $asterisksource # make # make install
5) Configure the /etc/asterisk/failover.conf file on requirements.
6) Reboot asterisk.
Installation with asterisk 1.6.X
1) Unzip the file
# tar -xzvf failover-1.0-current.tar.gz # cd failover
2) Copy the file to res directory under asterisk
# cp res_failover.c $asterisksource/res/
3) Copy the configuration file to /etc/asterisk directory
# cp failover.conf /etc/asterisk/
4) If asterisk is installed, please compile it and re-install
# cd $asterisksource # make # make install
5) Configure the /etc/asterisk/failover.conf file on requirements.
6) Reboot asterisk.
Explanation of Configuration Files
[openvox_failover_1] device=/dev/ttyUSB0 ;kick_time_interval=4000 ;event_cmd=logger ;autorun=yes
[openvox_failover_2] device=/dev/ttyUSB1 kick_time_interval=500 event_cmd=logger autorun=no
[openvox_failover_1]：Name of FA40 Device, to distinguish from different devices, a must to configuration;
device=/dev/ttyUSB0：Name of USB device that FA40 uses, a must to configuration;
kick_time_interval：the time interval of software watch dog; the default time is 4000ms, user can customize the time with 100ms for Minimum and 9000ms for Maximum;
event_cmd：event command, the default is logger, it will record the FA40 status in system log;
autorun：this decides if FA40 will start when asterisk boots; the default is yes which means the FA40 starts when asterisk boots; if no, the FA40 will not start when asterisk boots and user may need manually boot the device by running failover start command.
Steps to Use
1) Start asterisk
# asterisk –vvvgc
2) Start FA40 device
*CLI> failover start # This command can start all the FA40 devices. or *CLI> failover start 1 # This command can be use to start the first FA40. A difference number means to start a specific FA40 in the server.
3) Stop FA40 device
*CLI> failover stop # This command can stop all the FA40 devices. or *CLI> failover stop 1 # This command can be use to stop the first FA40. A difference number means to stop a specific FA40 in the server.
4) Show FA40 device information
*CLI> failover show # Show FA40 device information
5) Reload FA40 device configuration file
*CLI> failover stop # All the FA40 device must be stopped before reloading the configuration file *CLI> failover reload # Reload the configuration file
Software Installation by the res_failover.so
If you do not have the gcc compiler and the source code of the asterisk, you can also download the res_failover.so and use it directly as below.
1) Download res_failover.so
Check the asterisk version
# asterisk –V
Download the suitable version from http://www.openvox.cn/download/drivers/failover/
2) Unzip the file
# tar -xzvf res_failover-1.X.X.so-for-asterisk-1.X.X.tar.gz # cd res_failover-1.X.X.so-for-asterisk-1.X.X
3) Copy the so module file to /usr/lib/asterisk/modules
# cp res_failover.so /usr/lib/asterisk/modules
4) Copy the configuration file to /etc/asterisk directory
# cp failover.conf /etc/asterisk/
5) Configure the /etc/asterisk/failover.conf file on requirements.
6) Reboot asterisk.
Reference
www.openvox.cn
www.digium.com
www.asterisk.org
www.voip-info.org
www.asteriskguru.com
