/******************************************************************************* (C) 2017 Garant Plus Ltd @doc app_rescue @rev app_rescue release 1.0.2 Install and build instructions. ********************************************************************************/ The Solution ============= The Rescue-4E1 device is reading the status of E1 spans on Alvis-GW-2E1 or any Asterisk system with E1 DAHDI board installed with activated app_rescue application. In case of E1 line down or Asterisk unavailability the Rescue switches the incoming E1 link to the backup Asterisk system. This document describes the details on how to build and install the app_rescue Asterisk Application on your Asterisk system. Packages Requrements: ==================== Please install the following packages prior a future steps: dahdi-linux, asterisk-dev Environment: ============= Verified with: - Asterisk 1.8 on Centos 5 (x86/x64). - Asterisk 11 on Unbuntu 14 (x86/x64). - Asterisk 11 on Unbuntu 14 (x64). Hardware Compatibility List ============================ Digium (r) PCI and PCIe based E1/T1 Adapters. How to Build on Centos: ======================= 1. Please download and install the dahdi-linux and asterisk-dev packages for your Linux Distributive. 2. Please download the app_rescue SRPM package from: http://packages.otx.ru/csirep/rescue/asterisk-app-rescue-1.0.2-1.src.rpm 3. Build app_rescue. rpmbuild --rebuild asterisk-app-rescue-1.0.2-1.src.rpm Note !!: In case you are compiling for a specific Asterisk version in a system with multiple Asterisk sources! Please specify the Asterisk / DAHDI Sources location include search path env variables before invoking the rmpbuild! export ASTERISK_INC=/path/where/asterisk/headers/located/ export DAHDI_INC=/path/where/dahdi/headers/located/ 4. Install the app_rescue to the Asterisk for i386: rpm -Uvh ~/rpmbuild/RPMS/i386/asterisk-app-rescue-1.0.2-1.i368.rpm for the x68-64: rpm -Uvh ~/rpmbuild/RPMS/x86_64/asterisk-app-rescue-1.0.2-1.x86_64.rpm 5. Stop/start Asterisk or use asterisk -rx "module load app_rescue.so" to load the application. How to build from the sources manually: ======================================= 1. Please make sure you have all dev tools needed to build with the Asterisk. 2. Download the http://packages.otx.ru/csirep/rescue/asterisk-app-rescue-1.0.2-1.tar.gz and untar to the sub-directory to your directory with the Asterisk sources (see item 3.1) or a standalone directory (item 3.2). Type: tar -xvzf asterisk-app-rescue-1.0.2-1.tar.gz cd asterisk-app-rescue-1.0.2-1 3. Build the app_rescue: In the directory with the app_rescue sources please set the env variables: 3.1 export ASTERISK_INC=../ export DAHDI_INC=../ Or 3.2 (if you have a custom Asterisk sources path): export ASTERISK_INC=/path/where/asterisk/headers/located/ export DAHDI_INC=/path/where/dahdi/headers/located/ Then build, type: make 4. To install the app_rescue.so and the default config file to the Asterisk binaries please type: make install 5. Stop/start Asterisk or use asterisk -rx "module load app_rescue.so" to load the application. Typical configuration: ====================== The default configuration is stored rescue.conf in /etc/asterisk/rescue.conf [general] timeout = 1 ; Period between the DAHDI E1 spans status read operationst in seconds, default is 1 second. port = 10000 ; Local port to read commands from Rescue-4E1. address = 0.0.0.0 ; Local address to read commands from Rescue-4E1, default is 0.0.0.0. mode = sync ; Operation mode, 'async' or 'sync', default is 'sync'. Usually the user does not need to alter the configuration file. Please contact the GarantPlus Support Team if you need to alter the configuration. Version History: =================== Legend: [*] Bug fixes [+] Added features [.] Other Changes 26/01/2017 app_rescue 1.0.2 released. [+] Added support of Digium Boards. [+] Added support of RPM builds. [+] Added support of Rescue-4E1 communication protocol. 12/12/2016 app_rescue 1.0.0-1.0.1 [.] Internal releases