codecs.conf.sample: update codec opus docs
[asterisk/asterisk.git] / configs / samples / sla.conf.sample
1 ;
2 ; Configuration for Shared Line Appearances (SLA).
3 ;
4 ; See http://wiki.asterisk.org or doc/AST.pdf for more information.
5 ;
6
7 ; ---- General Options ----------------
8 [general]
9
10 ;attemptcallerid=no         ; Attempt CallerID handling.  The default value for this
11                             ; is "no" because CallerID handling with an SLA setup is
12                             ; known to not work properly in some situations.  However,
13                             ; feel free to enable it if you would like.  If you do, and
14                             ; you find problems, please do not report them.
15 ; -------------------------------------
16
17
18 ; ********************************
19 ; **** Configuration Ordering ****
20 ; ********************************
21
22 ; Note that SLA configuration processing assumes that *all* trunk declarations are
23 ; listed in the configuration file before any stations.
24
25 ; ********************************
26 ; ********************************
27
28
29 ; ---- Trunk Declarations -------------
30 ;
31 ;[line1]                    ; Provide a name for this trunk.
32
33 ;type=trunk                 ; This line is what marks this entry as a trunk.
34
35 ;device=DAHDI/3             ; Map this trunk declaration to a specific device.
36                             ; NOTE: You can not just put any type of channel here.
37                             ;       DAHDI channels can be directly used.  IP trunks
38                             ;       require some indirect configuration which is
39                             ;       described in
40                             ; https://wiki.asterisk.org/wiki/display/AST/SLA+Trunk+Configuration
41
42 ;autocontext=line1          ; This supports automatic generation of the dialplan entries
43                             ; if the autocontext option is used.  Each trunk should have
44                             ; a unique context name.  Then, in chan_dahdi.conf, this device
45                             ; should be configured to have incoming calls go to this context.
46
47 ;ringtimeout=30             ; Set how long to allow this trunk to ring on an inbound call before hanging
48                             ; it up as an unanswered call.  The value is in seconds.
49
50 ;barge=no                   ; If this option is set to "no", then no station will be
51                             ; allowed to join a call that is in progress.  The default
52                             ; value is "yes".
53
54 ;hold=private               ; This option configure hold permissions for this trunk.
55                             ;   "open"    - This means that any station can put this trunk
56                             ;               on hold, and any station can retrieve it from
57                             ;               hold.  This is the default.
58                             ;   "private" - This means that once a station puts the
59                             ;               trunk on hold, no other station will be
60                             ;               allowed to retrieve the call from hold.
61
62 ;[line2]
63 ;type=trunk
64 ;device=DAHDI/4
65 ;autocontext=line2
66
67 ;[line3]
68 ;type=trunk
69 ;device=DAHDI/3
70 ;autocontext=line3
71
72 ;[line4]
73 ;type=trunk
74 ;device=Local/disa@line4_outbound ; A Local channel in combination with the Disa
75                                   ; application can be used to support IP trunks.
76                                   ; See https://wiki.asterisk.org/wiki/display/AST/SLA+Trunk+Configuration
77 ;autocontext=line4
78 ; --------------------------------------
79
80
81 ; ---- Station Declarations ------------
82
83 ;[station1]                 ; Define a name for this station.
84
85 ;type=station               ; This line indicates that this entry is a station.
86
87 ;device=SIP/station1        ; Each station must be mapped to a device.
88
89 ;autocontext=sla_stations   ; This supports automatic generation of the dialplan entries if
90                             ; the autocontext option is used.  All stations can use the same
91                             ; context without conflict.  The device for this station should
92                             ; have its context configured to the same one listed here.
93
94 ;ringtimeout=10             ; Set a timeout for how long to allow the station to ring for an
95                             ; incoming call, in seconds.
96
97 ;ringdelay=10               ; Set a time for how long to wait before beginning to ring this station
98                             ; once there is an incoming call, in seconds.
99
100 ;hold=private               ; This option configure hold permissions for this station.  Note
101                             ; that if private hold is set in the trunk entry, that will override
102                             ; anything here.  However, if a trunk has open hold access, but this
103                             ; station is set to private hold, then the private hold will be in
104                             ; effect.
105                             ;   "open"    - This means that once this station puts a call
106                             ;               on hold, any other station is allowed to retrieve
107                             ;               it.  This is the default.
108                             ;   "private" - This means that once this station puts a
109                             ;               call on hold, no other station will be
110                             ;               allowed to retrieve the call from hold.
111
112
113 ;trunk=line1                ; Individually list all of the trunks that will appear on this station.  This
114                             ; order is significant.  It should be the same order as they appear on the
115                             ; phone.  The order here defines the order of preference that the trunks will
116                             ; be used.
117 ;trunk=line2
118 ;trunk=line3,ringdelay=5    ; A ring delay for the station can also be specified for a specific trunk.
119                             ; If a ring delay is specified both for the whole station and for a specific
120                             ; trunk on a station, the setting for the specific trunk will take priority.
121                             ; This value is in seconds.
122
123 ;trunk=line4,ringtimeout=5  ; A ring timeout for the station can also be specified for a specific trunk.
124                             ; If a ring timeout is specified both for the whole station and for a specific
125                             ; trunk on a station, the setting for the specific trunk will take priority.
126                             ; This value is in seconds.
127
128
129 ;[station](!)               ; When there are a lot of stations that are configured the same way,
130                             ; it is convenient to use a configuration template like this so that
131                             ; the common settings stay in one place.
132 ;type=station
133 ;autocontext=sla_stations
134 ;trunk=line1
135 ;trunk=line2
136 ;trunk=line3
137 ;trunk=line4
138
139 ;[station2](station)        ; Define a station that uses the configuration from the template "station".
140 ;device=SIP/station2
141 ;
142 ;[station3](station)
143 ;device=SIP/station3
144 ;
145 ;[station4](station)
146 ;device=SIP/station4
147 ;
148 ;[station5](station)
149 ;device=SIP/station5
150 ; --------------------------------------