diff options
author | seanbright <seanbright@f38db490-d61c-443f-a65b-d21fe96a405b> | 2009-06-23 23:58:26 +0000 |
---|---|---|
committer | seanbright <seanbright@f38db490-d61c-443f-a65b-d21fe96a405b> | 2009-06-23 23:58:26 +0000 |
commit | e73cee077addebff581115af84c57684d3491645 (patch) | |
tree | d2a274b509ac3bbc53380c4ef111ce20a156a1cd /doc | |
parent | 377fca7c1655654acc43bc436763797da3a390ef (diff) |
Merged revisions 202840-202841 via svnmerge from
https://origsvn.digium.com/svn/asterisk/trunk
........
r202840 | seanbright | 2009-06-23 19:53:45 -0400 (Tue, 23 Jun 2009) | 1 line
Remove some trailing whitespace before making content changes.
........
r202841 | seanbright | 2009-06-23 19:57:07 -0400 (Tue, 23 Jun 2009) | 1 line
Change some section names in the CDR tex documentation.
........
git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.6.2@202842 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'doc')
-rw-r--r-- | doc/tex/billing.tex | 10 | ||||
-rw-r--r-- | doc/tex/cdrdriver.tex | 56 |
2 files changed, 35 insertions, 31 deletions
diff --git a/doc/tex/billing.tex b/doc/tex/billing.tex index 9fae40be8..5c7f68a60 100644 --- a/doc/tex/billing.tex +++ b/doc/tex/billing.tex @@ -15,7 +15,7 @@ For more information, use the "core show application $<$application$>$" command. You can set default account codes and AMA flags for devices in channel configuration files, like sip.conf, iax.conf etc. -\section{Fields of the CDR in Asterisk} +\section{CDR Fields} \begin{itemize} \item accountcode: What account number to use, (string, 20 characters) @@ -53,11 +53,11 @@ transfers with IAX2 to avoid this problem, or turn off transfers completely (although this can result in a media latency increase since the media packets have to traverse the middle server(s) in the call). -\section{CDR Variables} +\section{Variables} -If the channel has a cdr, that cdr record has its own set of variables which -can be accessed just like channel variables. The following builtin variables -are available. +If the channel has a CDR, that CDR has its own set of variables which can be +accessed just like channel variables. The following builtin variables are +available. \begin{verbatim} ${CDR(clid)} Caller ID diff --git a/doc/tex/cdrdriver.tex b/doc/tex/cdrdriver.tex index 2937fc9fc..3fe7e148b 100644 --- a/doc/tex/cdrdriver.tex +++ b/doc/tex/cdrdriver.tex @@ -1,10 +1,10 @@ -\section{CDR Back Ends} +\section{Storage Backends} -\subsection{MSSQL} +\subsection{Microsoft SQL Server} Asterisk can currently store CDRs into an MSSQL database in two different ways: cdr\_odbc or cdr\_tds - + Call Data Records can be stored using unixODBC (which requires the FreeTDS package) [cdr\_odbc] or directly by using just the FreeTDS package [cdr\_tds] The following provide some @@ -195,11 +195,11 @@ call to the database when it's complete. -\subsection{MYSQL} +\subsection{MySQL} Using MySQL for CDR records is supported by using ODBC and the cdr\_odbc module. -\subsection{PGSQL} +\subsection{PostgreSQL} If you want to go directly to postgresql database, and have the cdr\_pgsql.so compiled you can use the following sample setup. On Debian, before compiling asterisk, just install libpqxx-dev. @@ -246,10 +246,14 @@ Using MySQL for CDR records is supported by using ODBC and the cdr\_odbc module. \end{verbatim} \end{astlisting} -\subsection{SQLLITE} +\subsection{SQLite 2} SQLite version 2 is supported in cdr\_sqlite. +\subsection{SQLite 3} + +SQLite version 3 is supported in cdr\_sqlite3\_custom. + \subsection{RADIUS} \subsubsection{What is needed} @@ -291,9 +295,9 @@ SQLite version 2 is supported in cdr\_sqlite. \subsubsection{Installation of the Radiusclient library} - Download the sources from + Download the sources from \url{http://developer.berlios.de/projects/radiusclient-ng/} - + Untar the source tarball: \begin{verbatim} @@ -310,15 +314,15 @@ SQLite version 2 is supported in cdr\_sqlite. \end{verbatim} \subsubsection{Configuration of the Radiusclient library} - + By default all the configuration files of the radiusclient library will be in \path{/usr/local/etc/radiusclient-ng} directory. - + File "radiusclient.conf" Open the file and find lines containing the following: authserver localhost - + This is the hostname or IP address of the RADIUS server used for authentication. You will have to change this unless the server is running on the same host as your Asterisk PBX. @@ -330,10 +334,10 @@ SQLite version 2 is supported in cdr\_sqlite. on the same host as your Asterisk PBX. \textbf{File "servers"} - + RADIUS protocol uses simple access control mechanism based on shared secrets that allows RADIUS servers to limit access from RADIUS clients. - + A RADIUS server is configured with a secret string and only RADIUS clients that have the same secret will be accepted. @@ -347,7 +351,7 @@ SQLite version 2 is supported in cdr\_sqlite. are going to use. \textbf{File "dictionary"} - + Asterisk uses some attributes that are not included in the dictionary of radiusclient library, therefore it is necessary to add them. A file called dictionary.digium (kept in the contrib dir) @@ -362,7 +366,7 @@ SQLite version 2 is supported in cdr\_sqlite. Download sources tarball from: \url{http://freeradius.org/} - + Untar, configure, build, and install the server: \begin{verbatim} @@ -375,15 +379,15 @@ SQLite version 2 is supported in cdr\_sqlite. All the configuration files of FreeRADIUS server will be in /usr/local/etc/raddb directory. - + \subsubsection{Configuration of the FreeRADIUS Server} - + There are several files that have to be modified to configure the RADIUS server. These are presented next. File "clients.conf" - + File \path{/usr/local/etc/raddb/clients.conf} contains description of RADIUS clients that are allowed to use the server. For each of the clients you need to specify its hostname or IP address and also a @@ -396,26 +400,26 @@ SQLite version 2 is supported in cdr\_sqlite. secret = mysecret shortname = foo } -\end{verbatim} +\end{verbatim} This fragment allows access from RADIUS clients on "myhost" if they use - "mysecret" as the shared secret. + "mysecret" as the shared secret. The file already contains an entry for localhost (127.0.0.1), so if you are running the RADIUS server on the same host as your Asterisk server, then modify the existing entry instead, replacing the default password. - + File "dictionary" - + Note: as of version 1.1.2, the dictionary.digium file ships with FreeRADIUS. The following procedure brings the dictionary.digium file to previous versions of FreeRADIUS. - + File \path{/usr/local/etc/raddb/dictionary} contains the dictionary of FreeRADIUS server. You have to add the same dictionary file (dictionary.digium), which you added to the dictionary of radiusclient-ng library. You can include it into the main file, adding the following line at the end of file \path{/usr/local/etc/raddb/dictionary}: - + \$INCLUDE /path/to/dictionary.digium That will include the same new attribute definitions that are used @@ -429,7 +433,7 @@ SQLite version 2 is supported in cdr\_sqlite. The module will be compiled as long as the radiusclient-ng library has been detected on your system. - + By default FreeRADIUS server will log all accounting requests into \path{/usr/local/var/log/radius/radacct} directory in form of plain text files. The server will create one file for each hostname in the directory. The @@ -440,7 +444,7 @@ SQLite version 2 is supported in cdr\_sqlite. separated values will be created in \path{/var/log/asterisk/cdr-csv}. The configuration file for cdr\_radius.so module is \path{/etc/asterisk/cdr.conf} - + This is where you can set CDR related parameters as well as the path to the radiusclient-ng library configuration file. |