Merge the realtime failover branch
[asterisk/asterisk.git] / configs / extconfig.conf.sample
index 32ec6ad..bde5d12 100644 (file)
@@ -9,7 +9,7 @@
 ;
 ; Static configuration files:
 ;
-; file.conf => driver,database[,table]
+; file.conf => driver,database[,table[,priority]]
 ;
 ; maps a particular configuration file to the given
 ; database driver, database and table (or uses the
 ; database and table (or uses the name of
 ; the family if the table is not specified
 ;
-;example => odbc,asterisk,alttable
+;example => odbc,asterisk,alttable,1
+;example => mysql,asterisk,alttable,2
 ;example2 => ldap,"dc=oxymium,dc=net",example2
 ;
+; Additionally, priorities are now supported for use as failover methods
+; for retrieving realtime data.  If one connection fails to retrieve any
+; information, the next sequential priority will be tried next.  This
+; especially works well with ODBC connections, since res_odbc now caches
+; when connection failures occur and prevents immediately retrying those
+; connections until after a specified timeout.  Note:  priorities must
+; start at 1 and be sequential (i.e. if you have only priorities 1, 2,
+; and 4, then 4 will be ignored, because there is no 3).
+;
 ; "odbc" is shown in the examples below, but is not the only valid realtime
 ; engine.  There is:
 ;    odbc ... res_config_odbc
 ;    sqlite ... res_config_sqlite
 ;    pgsql ... res_config_pgsql
+;    curl ... res_config_curl
+;    ldap ... res_config_ldap
 ;
 ;iaxusers => odbc,asterisk
 ;iaxpeers => odbc,asterisk