08849f6903d24ec28fc954d42d83cdf08d5acb65
[asterisk/asterisk.git] / configs / h323.conf.sample
1 ; The NuFone Network's
2 ; Open H.323 driver configuration
3 ;
4 [general]
5 port = 1720
6 ;bindaddr = 1.2.3.4     ; this SHALL contain a single, valid IP address for this machine
7 ;tos=ef
8 ;
9 ; You may specify a global default AMA flag for iaxtel calls.  It must be
10 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
11 ; are used in the generation of call detail records.
12 ;
13 ;amaflags = default
14 ;
15 ; You may specify a default account for Call Detail Records in addition
16 ; to specifying on a per-user basis
17 ;
18 ;accountcode=lss0101
19 ;
20 ; You can fine tune codecs here using "allow" and "disallow" clauses
21 ; with specific codecs.  Use "all" to represent all formats.
22 ;
23 ;disallow=all
24 ;allow=all              ; turns on all installed codecs
25 ;disallow=g723.1        ; Hm...  Proprietary, don't use it...
26 ;allow=gsm              ; Always allow GSM, it's cool :)
27 ;allow=ulaw             ; see doc/rtp-packetization for framing options
28 ;
29 ; User-Input Mode (DTMF)
30 ;
31 ; valid entries are:   rfc2833, inband, cisco, h245-signal
32 ; default is rfc2833
33 ;dtmfmode=rfc2833
34 ;
35 ; Default RTP Payload to send RFC2833 DTMF on.  This is used to
36 ; interoperate with broken gateways which cannot successfully
37 ; negotiate a RFC2833 payload type in the TerminalCapabilitySet.
38 ; To specify required payload type, put it after colon in dtmfmode
39 ; option like
40 ;dtmfmode=rfc2833:101
41 ; or
42 ;dtmfmode=cisco:121
43 ;
44 ; Set the gatekeeper 
45 ; DISCOVER                      - Find the Gk address using multicast
46 ; DISABLE                       - Disable the use of a GK
47 ; <IP address> or <Host name>   - The acutal IP address or hostname of your GK
48 ;gatekeeper = DISABLE
49 ;
50 ;
51 ; Tell Asterisk whether or not to accept Gatekeeper
52 ; routed calls or not. Normally this should always
53 ; be set to yes, unless you want to have finer control
54 ; over which users are allowed access to Asterisk.
55 ; Default: YES
56 ;
57 ;AllowGKRouted = yes
58 ;
59 ; When the channel works without gatekeeper, there is possible to
60 ; reject calls from anonymous (not listed in users) callers.
61 ; Default is to allow anonymous calls.
62 ;
63 ;AcceptAnonymous = yes
64 ;
65 ; Optionally you can determine a user by Source IP versus its H.323 alias.
66 ; Default behavour is to determine user by H.323 alias.
67 ;
68 ;UserByAlias=no
69 ;
70 ; Default context gets used in siutations where you are using 
71 ; the GK routed model or no type=user was found. This gives you 
72 ; the ability to either play an invalid message or to simply not 
73 ; use user authentication at all.
74 ;
75 ;context=default
76 ;
77 ; Use this option to help Cisco (or other) gateways to setup backward voice
78 ; path to pass inband tones to calling user (see, for example,
79 ; http://www.cisco.com/warp/public/788/voip/ringback.html)
80 ;
81 ; Add PROGRESS information element to SETUP message sent on outbound calls
82 ; to notify about required backward voice path. Valid values are:
83 ;   0 - don't add PROGRESS information element (default);
84 ;   1 - call is not end-end ISDN, further call progress information can
85 ;        possibly be available in-band;
86 ;   3 - origination address is non-ISDN (Cisco accepts this value only);
87 ;   8 - in-band information or an appropriate pattern is now available;
88 ;progress_setup = 3
89 ;
90 ; Add PROGRESS information element (IE) to ALERT message sent on incoming
91 ; calls to notify about required backwared voice path. Valid values are:
92 ;   0 - don't add PROGRESS IE (default);
93 ;   8 - in-band information or an appropriate pattern is now available;
94 ;progress_alert = 8
95 ;
96 ; Generate PROGRESS message when H.323 audio path has established to create
97 ; backward audio path at other end of a call.
98 ;progress_audio = yes
99 ;
100 ; Specify how to inject non-standard information into H.323 messages. When
101 ; the channel receives messages with tunneled information, it automatically
102 ; enables the same option for all further outgoing messages independedly on
103 ; options has been set by the configuration. This behavior is required, for
104 ; example, for Cisco CallManager when Q.SIG tunneling is enabled for a
105 ; gateway where Asterisk lives.
106 ; The option can be used multiple times, one option per line.
107 ;tunneling=none               ; Totally disable tunneling (default)
108 ;tunneling=cisco              ; Enable Cisco-specific tunneling
109 ;tunneling=qsig               ; Enable tunneling via Q.SIG messages
110 ;
111 ; Specify how to pass hold notification to remote party. Default is to
112 ; use H.450.4 supplementary service message.
113 ;hold=none                    ; Do not pass hold/retrieve notifications
114 ;hold=notify                  ; Use H.225 NOTIFY message
115 ;hold=q931only                ; Use stripped H.225 NOTIFY message (Q.931 part
116 ;                             ; only, usable for Cisco CallManager)
117 ;hold=h450                    ; Pass notification as H.450.4 supplementary
118 ;                             ; service
119 ;
120 ;------------------------------ JITTER BUFFER CONFIGURATION --------------------------
121 ; jbenable = yes              ; Enables the use of a jitterbuffer on the receiving side of a
122                               ; H323 channel. Defaults to "no". An enabled jitterbuffer will
123                               ; be used only if the sending side can create and the receiving
124                               ; side can not accept jitter. The H323 channel can accept jitter,
125                               ; thus an enabled jitterbuffer on the receive H323 side will only
126                               ; be used if the sending side can create jitter and jbforce is
127                               ; also set to yes.
128
129 ; jbforce = no                ; Forces the use of a jitterbuffer on the receive side of a H323
130                               ; channel. Defaults to "no".
131
132 ; jbmaxsize = 200             ; Max length of the jitterbuffer in milliseconds.
133
134 ; jbresyncthreshold = 1000    ; Jump in the frame timestamps over which the jitterbuffer is
135                               ; resynchronized. Useful to improve the quality of the voice, with
136                               ; big jumps in/broken timestamps, usualy sent from exotic devices
137                               ; and programs. Defaults to 1000.
138
139 ; jbimpl = fixed              ; Jitterbuffer implementation, used on the receiving side of a H323
140                               ; channel. Two implementations are currenlty available - "fixed"
141                               ; (with size always equals to jbmax-size) and "adaptive" (with
142                               ; variable size, actually the new jb of IAX2). Defaults to fixed.
143
144 ; jblog = no                  ; Enables jitterbuffer frame logging. Defaults to "no".
145 ;-----------------------------------------------------------------------------------
146 ;
147 ; H.323 Alias definitions
148 ;
149 ; Type 'h323' will register aliases to the endpoint
150 ; and Gatekeeper, if there is one.
151 ;
152 ; Example: if someone calls time@your.asterisk.box.com
153 ; Asterisk will send the call to the extension 'time' 
154 ; in the context default
155 ;
156 ;   [default]
157 ;   exten => time,1,Answer
158 ;   exten => time,2,Playback,current-time
159 ;
160 ; Keyword's 'prefix' and 'e164' are only make sense when
161 ; used with a gatekeeper. You can specify either a prefix 
162 ; or E.164 this endpoint is responsible for terminating.
163
164 ; Example: The H.323 alias 'det-gw' will tell the gatekeeper
165 ; to route any call with the prefix 1248 to this alias. Keyword
166 ; e164 is used when you want to specifiy a full telephone
167 ; number. So a call to the number 18102341212 would be 
168 ; routed to the H.323 alias 'time'.
169 ;
170 ;[time]
171 ;type=h323
172 ;e164=18102341212
173 ;context=default
174 ;
175 ;[det-gw]
176 ;type=h323
177 ;prefix=1248,1313
178 ;context=detroit
179 ;
180 ;
181 ; Inbound H.323 calls from BillyBob would land in the incoming
182 ; context with a maximum of 4 concurrent incoming calls 
183
184 ;
185 ; Note: If keyword 'incominglimit' are omitted Asterisk will not 
186 ; enforce any maximum number of concurrent calls.
187 ;
188 ;[BillyBob]
189 ;type=user
190 ;host=192.168.1.1
191 ;context=incoming
192 ;incominglimit=4
193 ;h245Tunneling=no
194 ;
195 ;
196 ; Outbound H.323 call to Larry using SlowStart
197 ;
198 ;[Larry]
199 ;type=peer
200 ;host=192.168.2.1
201 ;fastStart=no
202
203
204