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