<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>cdr.conf</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><link rel="start" href="index.html" title="Asterisk™: The Future of Telephony" /><link rel="up" href="asterisk-APP-D.html" title="Appendix D. Configuration Files" /><link rel="prev" href="asterisk-APP-D-SECT-7.html" title="asterisk.conf" /><link rel="next" href="asterisk-APP-D-SECT-9.html" title="cdr_manager.conf" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">cdr.conf</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="asterisk-APP-D-SECT-7.html">Prev</a> </td><th width="60%" align="center">Appendix D. Configuration Files</th><td width="20%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-9.html">Next</a></td></tr></table><hr /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="asterisk-APP-D-SECT-8"></a>cdr.conf</h2></div></div></div><p><a id="I_indexterm_tt2621" class="indexterm"></a>The <span class="emphasis"><em>cdr.conf</em></span> file is used to enable
call detail record logging to a flat file or a database. Storing call
records is useful for all sorts of purposes including billing, fraud
prevention, QoS evaluations, and more. The <span class="emphasis"><em>cdr.conf</em></span>
file contains some general parameters that are not specific to any
particular database, but rather indicate how Asterisk should handle the
passing of information to the database. All options are under the <code class="literal">[general]</code> heading of the
<span class="emphasis"><em>cdr.conf</em></span> file:</p><div class="variablelist"><dl><dt><span class="term">
<code class="literal">enable</code>
</span></dt><dd><p>Accepts the arguments <code class="literal">yes</code>
and <code class="literal">no</code>. Specifies whether or not
to use CDR logging. If set to <code class="literal">no</code>,
this will override any CDR module explicitly loaded. The default is
<code class="literal">yes</code>.</p></dd><dt><span class="term">
<code class="literal">batch</code>
</span></dt><dd><p>Accepts the arguments <code class="literal">yes</code>
and <code class="literal">no</code>. Allows Asterisk to write
data to a buffer instead of writing to the database at the end of
every call, to reduce load on the system.</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a id="asterisk-APP-D-NOTE-71"></a>Warning</h3><p>Note that if the system dies unexpectedly when this option
is set to <code class="literal">yes</code>, data loss may
occur.</p></div></dd><dt><span class="term">
<code class="literal">size</code>
</span></dt><dd><p>Sets the maximum number of CDRs to accumulate in the buffer
before posting to the backend CDR storage systems. This setting only
takes effect if the <code class="literal">batch</code> setting
is set to <code class="literal">yes</code>. This setting
defaults to 100 records.</p></dd><dt><span class="term">
<code class="literal">time</code>
</span></dt><dd><p>Accepts an integer (in seconds) as its argument. Sets the
number of seconds before Asterisk flushes the buffer and writes the
CDRs to the database, regardless of the number of records in the
buffer (as defined by <code class="literal">size</code>). The
default is 300 seconds (5 minutes).</p></dd><dt><span class="term">
<code class="literal">scheduleronly</code>
</span></dt><dd><p>Accepts the arguments <code class="literal">yes</code>
and <code class="literal">no</code>. If you are generating a
massive volume of CDRs on a system that is pushing them to a remote
database, setting <code class="literal">scheduleronly</code>
to <code class="literal">yes</code> may be of benefit. Since
the scheduler cannot start a new task until the current one is
finished, slow CDR writes may adversely affect other processes
needing the scheduler. This setting will instruct Asterisk to handle
CDR writes in a new thread, essentially assigning a dedicated
scheduler to this function. In normal operation, this would yield
very little benefit.</p></dd><dt><span class="term">
<code class="literal">safeshutdown</code>
</span></dt><dd><p>Accepts the arguments <code class="literal">yes</code>
and <code class="literal">no</code>. Setting <code class="literal">safeshutdown</code> to <code class="literal">yes</code> will prevent Asterisk from shutting
down completely until the buffer is flushed and all information is
written to the database. If this parameter is set to <code class="literal">no</code> and you shut down Asterisk with
information still residing in the buffers, that information will
likely be lost.</p></dd><dt><span class="term">
<code class="literal">endbeforehexten</code>
</span></dt><dd><p>Normally, CDR records are not closed out until after all
extensions are finished executing. By enabling this option, the CDR
will be ended before executing the <code class="literal">h</code> extension so that CDR values such as
<code class="literal">end</code> and <code class="literal">billsec</code> may be retrieved inside of this
extension. Defaults to <code class="literal">no</code>.</p></dd></dl></div><p>The rest of <code class="filename">cdr.conf</code> contains
setup for several of the backend CDR engines. See the sample <code class="filename">cdr.conf</code> for more information.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="asterisk-APP-D-SECT-7.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="asterisk-APP-D.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-9.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">asterisk.conf </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> cdr_manager.conf</td></tr></table></div><div xmlns="" id="svn-footer"><hr /><p>You are reading <em>Asterisk: The Future of Telephony</em> (2nd Edition for Asterisk 1.4), by Jim van Meggelen, Jared Smith, and Leif Madsen.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-Noncommercial-No Derivative Works License v3.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://oreilly.com/catalog/9780596510480/">http://www.oreilly.com/</a>.</p></div></body></html>
distrib
>
Mandriva
>
2008.1
>
i586
>
media
>
contrib-updates
>
by-pkgid
>
c7095aefea7b97fbd2a596dcbfb9d481
>
files
>
268
