[asterisk-commits] russell: branch 1.6.0 r106315 - in /branches/1.6.0: ./ doc/tex/realtime.tex

[SVN commits to the Asterisk project]

Author: russell
Date: Wed Mar  5 18:20:35 2008
New Revision: 106315

URL: http://svn.digium.com/view/asterisk?view=rev&rev=106315
Log:
Merged revisions 106186 via svnmerge from 
https://origsvn.digium.com/svn/asterisk/trunk

........
r106186 | mvanbaak | 2008-03-05 15:19:06 -0600 (Wed, 05 Mar 2008) | 7 lines

document var_metric usage to prevent bugreports that are actually configuration issues

(closes issue #12151)
Reported by: caio1982
Patches:
      DB_metric3.diff uploaded by caio1982 (license 22)

........

Modified:
    branches/1.6.0/   (props changed)
    branches/1.6.0/doc/tex/realtime.tex

Propchange: branches/1.6.0/
------------------------------------------------------------------------------
--- trunk-merged (original)
+++ trunk-merged Wed Mar  5 18:20:35 2008
@@ -1,1 +1,1 @@
-/trunk:1-105595,105675,105677,105733-105734,105773,105785,105804,105840-105841,105864,105899,105933,106036,106040,106139
+/trunk:1-105595,105675,105677,105733-105734,105773,105785,105804,105840-105841,105864,105899,105933,106036,106040,106139,106186

Modified: branches/1.6.0/doc/tex/realtime.tex
URL: http://svn.digium.com/view/asterisk/branches/1.6.0/doc/tex/realtime.tex?view=diff&rev=106315&r1=106314&r2=106315
==============================================================================
--- branches/1.6.0/doc/tex/realtime.tex (original)
+++ branches/1.6.0/doc/tex/realtime.tex Wed Mar  5 18:20:35 2008
@@ -38,6 +38,20 @@
 modules that read configurations, there's no difference between a static
 file in the file system, like extensions.conf, and a configuration loaded
 from a database.
+
+You just have to always make sure the var\_metric values are properly set and
+ordered as you expect in your database server if you're using the static mode
+with ARA (either sequentially or with the same var\_metric value for everybody).
+
+If you have an option that depends on another one in a given configuration
+file (i.e, 'musiconhold' depending on 'agent' from agents.conf) but their
+var\_metric are not sequential you'll probably get default values being assigned for
+those options instead of the desired ones. You can still use the same
+var\_metric for all entries in your DB, just make sure the entries
+are recorded in an order that does not break the option dependency.
+
+That doesn't happen when you use a static file in the file system. Although
+this might be interpreted as a bug or limitation, it is not.
 
 \subsubsection{Realtime SIP friends}