codecs.conf.sample: update codec opus docs
[asterisk/asterisk.git] / configs / samples / res_odbc.conf.sample
1 ;;; odbc setup file
2
3 ; ENV is a global set of environmental variables that will get set.
4 ; Note that all environmental variables can be seen by all connections,
5 ; so you can't have different values for different connections.
6 [ENV]
7 ;INFORMIXSERVER => my_special_database
8 ;INFORMIXDIR => /opt/informix
9 ;ORACLE_HOME => /home/oracle
10
11 ; All other sections are arbitrary names for database connections.
12
13 ;
14 ; The context name is what will be used in other configuration files, such
15 ; as extconfig.conf and func_odbc.conf, to reference this connection.
16 [asterisk]
17 ;
18 ; Permit disabling sections without needing to comment them out.
19 ; If not specified, it is assumed the section is enabled.
20 enabled => no
21 ;
22 ; This value should match an entry in /etc/odbc.ini
23 ; (or /usr/local/etc/odbc.ini, on FreeBSD and similar systems).
24 dsn => asterisk
25 ;
26 ; Username for connecting to the database.  The user defaults to the context name if unspecified.
27 ;username => myuser
28 ;
29 ; Password for authenticating the user to the database.  The default
30 ; password is blank.
31 ;password => mypass
32 ;
33 ; Build a connection at startup?
34 pre-connect => yes
35 ;
36 ; What should we execute to ensure that our connection is still alive?  The
37 ; statement should return a non-zero value in the first field of its first
38 ; record.  The default is "select 1".
39 ;sanitysql => select 1
40 ;
41 ; The maximum number of connections to have open at any given time.
42 ; This defaults to 1 and it is highly recommended to only set this higher
43 ; if using a version of UnixODBC greater than 2.3.1.
44 ;max_connections => 20
45 ;
46 ; When the channel is destroyed, should any uncommitted open transactions
47 ; automatically be committed?
48 ;forcecommit => no
49 ;
50 ; How should we perceive data in other transactions within the database?
51 ; Possible values are read_uncommitted, read_committed, repeatable_read,
52 ; and serializable.  The default is read_committed.
53 ;isolation => repeatable_read
54 ;
55 ; Is the backslash a native escape character?  The default is yes, but for
56 ; MS SQL Server, the answer is no.
57 ;backslash_is_escape => yes
58 ;
59 ; How long (in seconds) should we attempt to connect before considering the
60 ; connection dead?  The default is 10 seconds, but you may wish to reduce it,
61 ; to increase responsiveness.
62 ;connect_timeout => 10
63 ;
64 ; When a connection fails, how long (in seconds) should we cache that
65 ; information before we attempt another connection?  This increases
66 ; responsiveness, when a database resource is not working.
67 ;negative_connection_cache => 300
68
69 [mysql2]
70 enabled => no
71 dsn => MySQL-asterisk
72 username => myuser
73 password => mypass
74 pre-connect => yes
75
76 ; Certain servers, such as MS SQL Server and Sybase use the TDS protocol, which
77 ; limits the number of active queries per connection to 1.
78 [sqlserver]
79 enabled => no
80 dsn => mickeysoft
81 max_connections => 5
82 username => oscar
83 password => thegrouch
84 pre-connect => yes
85 sanitysql => select count(*) from systables
86 ; forcecommit => no            ; Default to committing uncommitted transactions?
87                                ; Note:  this is NOT the autocommit flag; this
88                                ; determines the end result of transactions which
89                                ; are not explicitly committed or rolled back.  By
90                                ; default, such transactions are rolled back if the
91                                ; call ends without an explicit commit.
92 ; isolation => read_committed  ; Isolation level; supported levels are:
93                                ; read_uncommitted, read_committed, repeatable_read,
94                                ; serializable.  Note that not all databases support
95                                ; all isolation levels (e.g. Postgres only supports
96                                ; repeatable_read and serializable).  See database
97                                ; documentation for further information.
98 ;
99 ; Many databases have a default of '\' to escape special characters.  MS SQL
100 ; Server does not.
101 backslash_is_escape => no
102
103 ;
104 ; If you are having problems with concurrency, please read this note from the
105 ; mailing lists, regarding UnixODBC:
106 ;
107 ; http://lists.digium.com/pipermail/asterisk-dev/2009-February/036539.html
108 ;
109 ; In summary, try setting "Threading=2" in the relevant section within your
110 ; odbcinst.ini.
111 ;