mirror of
https://github.com/cgrates/cgrates.git
synced 2026-02-15 13:19:53 +05:00
Adding FreeSWITCH tutorial to documentation
This commit is contained in:
DanB
@@ -7,16 +7,17 @@ We recommend using source installs for advanced users familiar with Go programmi
|
||||
3.1. Using packages
|
||||
-------------------
|
||||
|
||||
3.1.2. Debian Squeeze
|
||||
~~~~~~~~~~~~~~~~~~~
|
||||
3.1.2. Debian Wheezy (Squeeze is also backwards compatible)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This is for the moment the only packaged and the most recommended to use method to install CGRateS.
|
||||
|
||||
On the server you want to install CGRateS, simply execute the following commands:
|
||||
::
|
||||
|
||||
cd /etc/apt/sources.list.d/
|
||||
wget http://apt.itsyscom.com/repos/apt/conf/cgrates.apt.list
|
||||
wget -O - http://apt.itsyscom.com/repos/apt/conf/cgrates.gpg.key|apt-key add -
|
||||
wget http://apt.itsyscom.com/repos/apt/conf/cgrates.apt.list
|
||||
apt-get update
|
||||
apt-get install cgrates
|
||||
|
||||
|
||||
@@ -30,7 +30,7 @@ Of course more SessionManagers can serve multiple Telecom Switches and all of th
|
||||
1.1. CGRateS Features
|
||||
---------------------
|
||||
|
||||
- Reliable and Fast ( very fast ;) ). To get an idea about speed, we have benchmarked 11000+ req/sec on a rather modest machine without requiring special tweaks in the kernel.
|
||||
- Reliable and Fast ( very fast ;) ). To get an idea about speed, we have benchmarked 13000+ req/sec on a rather modest machine without requiring special tweaks in the kernel.
|
||||
- Using most modern programming concepts like multiprocessor support, asynchronous code execution within microthreads.
|
||||
- Built-in data caching system per call duration.
|
||||
- In-Memory database with persistence over restarts.
|
||||
|
||||
97
docs/tutfreeswitch.rst
Normal file
97
docs/tutfreeswitch.rst
Normal file
@@ -0,0 +1,97 @@
|
||||
7.1. FreeSWITCH Integration Tutorials
|
||||
=====================================
|
||||
|
||||
7.1.1. Automated prepaid with CSV CDRs
|
||||
--------------------------------------
|
||||
|
||||
In this tutorial we are going to focus on simplicity of integrating CGRateS as carrier grade real-time charging engine for FreeSWITCH_. CGRateS will serve as both prepaid controller and rater for FreeSWITCH_ default generated CSV CDRs. A screencast version of this tutorial can be found on `YouTube <http://youtu.be/qTQZZpb-m7Q>`_.
|
||||
|
||||
|
||||
7.1.1.1. Prerequisites
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
OS: Debian Wheezy. Default options selected for installer.
|
||||
|
||||
Install Redis_ to serve as DataDB for CGRateS.
|
||||
|
||||
::
|
||||
|
||||
apt-get install redis-server
|
||||
|
||||
|
||||
Install MongoDB_ to serve as LogDB for CGRateS.
|
||||
|
||||
::
|
||||
|
||||
apt-get install mongodb
|
||||
|
||||
|
||||
7.1.1.2. FreeSWITCH_
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
More information regarding installing FreeSWITCH_ on Debian can be found on it's official `installation wiki <http://wiki.freeswitch.org/wiki/Installation_Guide#Debian_packages>`_.
|
||||
|
||||
To get FreeSWITCH_ installed and configured, we have choosen the simplest method, out of *vanilla* packages.
|
||||
Bellow are the commands we have used to get FreeSWITCH_ up.
|
||||
|
||||
::
|
||||
|
||||
gpg --keyserver pool.sks-keyservers.net --recv-key D76EDC7725E010CF
|
||||
gpg -a --export D76EDC7725E010CF | sudo apt-key add -
|
||||
cd /etc/apt/sources.list.d/
|
||||
wget http://apt.itsyscom.com/repos/apt/conf/freeswitch.apt.list
|
||||
apt-get update
|
||||
apt-get install freeswitch-meta-vanilla
|
||||
cp -r /usr/share/freeswitch/conf/vanilla /etc/freeswitch
|
||||
chown -R freeswitch:freeswitch /etc/freeswitch/
|
||||
/etc/init.d/freeswitch start
|
||||
fs_cli
|
||||
|
||||
|
||||
7.1.1.2. CGRateS
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
Installation steps are provided on CGRateS `install documentation <https://cgrates.readthedocs.org/en/latest/installation.html>`_.
|
||||
|
||||
To get CGRateS installed and configured, we have executed the following commands over console:
|
||||
|
||||
::
|
||||
|
||||
cd /etc/apt/sources.list.d/
|
||||
wget -O - http://apt.itsyscom.com/repos/apt/conf/cgrates.gpg.key|apt-key add -
|
||||
wget http://apt.itsyscom.com/repos/apt/conf/cgrates.apt.list
|
||||
apt-get update
|
||||
apt-get install cgrates
|
||||
cd /usr/share/cgrates/data/rates/prepaid1centpsec/
|
||||
cgr-loader
|
||||
cd /etc/cgrates/
|
||||
cp /usr/share/cgrates/data/conf/cgr_fs_prep_csv.cfg cgrates.cfg
|
||||
svc -d /etc/service/cgrates/
|
||||
svc -u /etc/service/cgrates/
|
||||
tail -f /var/log/syslog
|
||||
|
||||
|
||||
7.1.1.3. Final integration tests - Jitsi
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
On our ubuntu desktop host, we have installed Jitsi_ to be used as SIP UA, out of stable provided packages on `Jitsi download <https://jitsi.org/Main/Download>`_ and had Jitsi_ configured with 2 accounts out of default FreeSWITCH_ provided ones: 1001/1234 and 1002/1234.
|
||||
|
||||
Calling between 1001 and 1002 should generate prepaid debits which are to be monitored in */var/log/syslog*.
|
||||
|
||||
To check rating simply rotate the cdr files via fs_cli, checking the CDR prices in the location where CGRateS moves them, */var/log/cgrates/cdr_out*.
|
||||
|
||||
::
|
||||
|
||||
fs_cli -x "cdr_csv rotate"
|
||||
|
||||
.. _Redis: http://redis.io/
|
||||
.. _MongoDB: http://www.mongodb.org/
|
||||
.. _FreeSWITCH: http://www.freeswitch.org/
|
||||
.. _Jitsi: http://www.jitsi.org/
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,2 +1,7 @@
|
||||
7. Tutorials
|
||||
============
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
tutfreeswitch
|
||||
|
||||
@@ -38,7 +38,7 @@ func init() {
|
||||
const (
|
||||
RECURSION_MAX_DEPTH = 4
|
||||
FALLBACK_SUBJECT = "*all"
|
||||
VERSION = "1.0a5"
|
||||
VERSION = "0.9.1rc2"
|
||||
)
|
||||
|
||||
var (
|
||||
|
||||
Reference in New Issue
Block a user