| 
									
										
										
										
											2004-10-05 06:46:11 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Static and realtime external configuration | 
					
						
							|  |  |  | ; engine configuration | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2011-02-02 18:56:42 +00:00
										 |  |  | ; See https://wiki.asterisk.org/wiki/display/AST/Realtime+Database+Configuration | 
					
						
							|  |  |  | ; for basic table formatting information. | 
					
						
							| 
									
										
										
										
											2004-10-08 05:36:23 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-06-11 00:12:35 +00:00
										 |  |  | [settings] | 
					
						
							| 
									
										
										
										
											2004-10-05 06:46:11 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2009-05-28 14:39:21 +00:00
										 |  |  | ; Static configuration files: | 
					
						
							| 
									
										
										
										
											2004-10-05 06:46:11 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2010-07-23 16:19:21 +00:00
										 |  |  | ; file.conf => driver,database[,table[,priority]] | 
					
						
							| 
									
										
										
										
											2004-10-05 06:46:11 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; maps a particular configuration file to the given | 
					
						
							|  |  |  | ; database driver, database and table (or uses the | 
					
						
							|  |  |  | ; name of the file as the table if not specified) | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;uncomment to load queues.conf via the odbc engine. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ;queues.conf => odbc,asterisk,ast_config | 
					
						
							| 
									
										
										
										
											2007-03-13 21:22:33 +00:00
										 |  |  | ;extensions.conf => sqlite,asterisk,ast_config | 
					
						
							| 
									
										
										
										
											2005-07-05 22:11:43 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; The following files CANNOT be loaded from Realtime storage: | 
					
						
							|  |  |  | ;	asterisk.conf | 
					
						
							|  |  |  | ;	extconfig.conf (this file) | 
					
						
							|  |  |  | ;	logger.conf | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; Additionally, the following files cannot be loaded from | 
					
						
							|  |  |  | ; Realtime storage unless the storage driver is loaded | 
					
						
							|  |  |  | ; early using 'preload' statements in modules.conf: | 
					
						
							|  |  |  | ;	manager.conf | 
					
						
							|  |  |  | ;	cdr.conf | 
					
						
							|  |  |  | ;	rtp.conf | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-10-05 06:46:11 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Realtime configuration engine | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; maps a particular family of realtime | 
					
						
							|  |  |  | ; configuration to a given database driver, | 
					
						
							|  |  |  | ; database and table (or uses the name of | 
					
						
							|  |  |  | ; the family if the table is not specified | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2010-07-23 16:19:21 +00:00
										 |  |  | ;example => odbc,asterisk,alttable,1 | 
					
						
							|  |  |  | ;example => mysql,asterisk,alttable,2 | 
					
						
							| 
									
										
										
										
											2005-12-27 06:42:29 +00:00
										 |  |  | ;example2 => ldap,"dc=oxymium,dc=net",example2 | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2010-07-23 16:19:21 +00:00
										 |  |  | ; 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). | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2007-03-13 21:22:33 +00:00
										 |  |  | ; "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 | 
					
						
							| 
									
										
										
										
											2010-07-23 16:19:21 +00:00
										 |  |  | ;    curl ... res_config_curl | 
					
						
							|  |  |  | ;    ldap ... res_config_ldap | 
					
						
							| 
									
										
										
										
											2007-03-13 21:22:33 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-02-10 21:14:11 +00:00
										 |  |  | ;iaxusers => odbc,asterisk | 
					
						
							|  |  |  | ;iaxpeers => odbc,asterisk | 
					
						
							|  |  |  | ;sipusers => odbc,asterisk | 
					
						
							|  |  |  | ;sippeers => odbc,asterisk | 
					
						
							| 
									
										
										
										
											2007-02-15 12:10:55 +00:00
										 |  |  | ;sipregs => odbc,asterisk | 
					
						
							| 
									
										
										
										
											2004-10-08 05:36:23 +00:00
										 |  |  | ;voicemail => odbc,asterisk | 
					
						
							| 
									
										
										
										
											2004-11-28 21:28:30 +00:00
										 |  |  | ;extensions => odbc,asterisk | 
					
						
							| 
									
										
										
										
											2009-08-18 19:25:09 +00:00
										 |  |  | ;meetme => mysql,general | 
					
						
							| 
									
										
										
										
											2005-06-02 21:42:49 +00:00
										 |  |  | ;queues => odbc,asterisk | 
					
						
							|  |  |  | ;queue_members => odbc,asterisk | 
					
						
							| 
									
										
										
										
											2009-08-18 19:25:09 +00:00
										 |  |  | ;musiconhold => mysql,general | 
					
						
							|  |  |  | ;queue_log => mysql,general | 
					
						
							| 
									
										
										
										
											2008-12-15 21:17:07 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; While most dynamic realtime engines are automatically used when defined in | 
					
						
							|  |  |  | ; this file, 'extensions', distinctively, is not.  To activate dynamic realtime | 
					
						
							|  |  |  | ; extensions, you must turn them on in each respective context within | 
					
						
							|  |  |  | ; extensions.conf with a switch statement.  The syntax is: | 
					
						
							|  |  |  | ;      switch => Realtime/[[db_context@]tablename]/<opts> | 
					
						
							|  |  |  | ; The only option available currently is the 'p' option, which disallows | 
					
						
							|  |  |  | ; extension pattern queries to the database.  If you have no patterns defined | 
					
						
							|  |  |  | ; in a particular context, this will save quite a bit of CPU time.  However, | 
					
						
							|  |  |  | ; note that using dynamic realtime extensions is not recommended anymore as a | 
					
						
							|  |  |  | ; best practice; instead, you should consider writing a static dialplan with | 
					
						
							|  |  |  | ; proper data abstraction via a tool like func_odbc. | 
					
						
							| 
									
										
										
										
											2004-06-11 00:12:35 +00:00
										 |  |  | 
 |