[Docs] Removing old indexing and some obsolete documentation

This commit is contained in:
DanB
2020-04-10 11:55:38 +02:00
parent a1017ca6b6
commit 1ade35d0d0
7 changed files with 21 additions and 63 deletions

View File

@@ -1,11 +1,10 @@
5. Administration Administration
================= ==============
The general steps to get CGRateS operational are: The general steps to get CGRateS operational are:
#. Create CSV files containing the initial data for CGRateS. #. Create CSV files containing the initial data for CGRateS.
#. Load the data in the databases using the Loader application. #. Load the data in the databases using the Loader application.
#. Start a Rater. #. Start the engine with the required components (depending on your setup).
#. Start the SessionManager talking to your VoIP Switch or directly make API calls to the Rater. #. Make API calls to the component you are interested or send events from your environment towards the :ref:`SessionS` via the :ref:`Agents`.
#. Make API calls to the Rater or just let the SessionManager do the work.

View File

@@ -1,15 +1,10 @@
6. Advanced Topics Advanced Topics
================== ===============
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2
apicalls apicalls
cdrserver
cdrclient
cdrexporter
cdrstats
derived_charging
ratinglogic ratinglogic

View File

@@ -1,4 +1,4 @@
.. _Agents:
Agents Agents
====== ======

View File

@@ -1,8 +1,7 @@
.. _configuration: .. _configuration:
*************
Configuration Configuration
************* =============
Has a *JSON* format with commented lines starting with *//*. Has a *JSON* format with commented lines starting with *//*.
@@ -19,7 +18,7 @@ The configuration can be loaded at start and reloaded at run time using APIs des
.. hint:: You can reload from remote HTTP server as well. .. hint:: You can reload from remote HTTP server as well.
Below is the default configuration file which comes hardcoded into :ref:cgr-engine: Below is the default configuration file which comes hardcoded into :ref:`cgr-engine`:
.. literalinclude:: ../data/conf/cgrates/cgrates.json .. literalinclude:: ../data/conf/cgrates/cgrates.json
:language: javascript :language: javascript

View File

@@ -1,5 +1,9 @@
8.1. FreeSWITCH integration .. _FreeSWITCH: http://www.freeswitch.org
================================
FreeSWITCH integration
======================
Being the original platform supported by CGRateS, FreeSWITCH_ has the advantage of support for complete set of CGRateS features. Being the original platform supported by CGRateS, FreeSWITCH_ has the advantage of support for complete set of CGRateS features.
When used as Telecom Switch it fully supports all rating modes: **prepaid**/**postpaid**/**pseudoprepaid**/**rated**. When used as Telecom Switch it fully supports all rating modes: **prepaid**/**postpaid**/**pseudoprepaid**/**rated**.
A typical use case would be like the one in the diagram below: A typical use case would be like the one in the diagram below:
@@ -8,8 +12,8 @@ A typical use case would be like the one in the diagram below:
The process of rating is decoupled into two different components: The process of rating is decoupled into two different components:
8.1.1. SessionManager SessionManager
--------------------- --------------
**TODO** - update and add CDRs and CDRc. **TODO** - update and add CDRs and CDRc.
@@ -49,43 +53,4 @@ The process of rating is decoupled into two different components:
- *hupall MANAGER_REQUEST cgr_reqtype postpaid* - *hupall MANAGER_REQUEST cgr_reqtype postpaid*
8.1.2. Mediator
---------------
**TODO** - remove this section. Mediator functionality is handled by CDRs and CDRc.
Attaches costs to FreeSWITCH_ native written .csv files. Since writing channel variables during hangup is asynchronous and can be missed by the CDR recorder mechanism of FreeSWITCH_, we decided to keep this as separate process after the call is completed and do not write the costs via channel variables.
8.1.2.1. Modes of operation
~~~~~~~~~~~~~~~~~~~~~~~~~~~
The Mediator process for FreeSWITCH works in two different modes:
- Costs from LogDB (activated by setting -1 as *subject_idx* in the *cgrates.cfg*:
- Queries LogDB for a previous saved price by SessionManager.
- This behavior is typical for prepaid/postpaid calls which were previously processed by SessionManager and important in the sense that we write in CDRs exactly what was billed real-time from user's account.
- Costs queried from Rater:
- This mode is specific for multiple process mediation and does not necessary reflect the price which was deducted from the user's account during real-time rating.
- Another application for this mode is pseudoprepaid when there is no SessionManager monitoring and charging calls in real-time (debit done directly from CDRs).
- This mode is triggered from configuration file by setting proper indexes (or leave them defaults if cgrates rating template is using whitin FreeSWITCH_ cdr_csv configuration file.
A typical usage into our implementations is a combination between the two modes of operation (by setting at a minimum -1 as subject_idx to run from LogDB and succesive mediation processes with different indexes).
8.1.2.2. Implementation logic
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- The Mediator process is configured and started in the *cgrates.cfg* file and is alive as long as the *cgr-engine* application is on.
- To avoid concurrency issues, the Mediator does not process active maintained CDR csv files by FreeSWITCH_ but picks them up as soon as FreeSWITCH_ has done with them by rotating. The information about rotation comes in real-time on the Linux OS through the use of inotify.
- Based on configured indexes in the configuration file, the Mediator will start multiple processes for the same CDR.
- For each mediation process configured the Mediator will apped the original CDR with costs calculated. In case of errors of some kind, the value *-1* will be prepended.
- When mediation is completed on a file, the file will be moved to configured *cdr_out_dir* path.
.. _FreeSWITCH: http://www.freeswitch.org

View File

@@ -1,5 +1,5 @@
8. Miscellaneous Miscellaneous
================ =============
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2

View File

@@ -1,5 +1,5 @@
7. Tutorials Tutorials
============ =========
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2