Fax For Asterisk Manual

Fax For Asterisk
Administrator Manual
601-00012 Rev. D7

Digium, Inc.
445 Jan Davis Drive NW
Huntsville, AL 35806
Unite !tates
"ain Num#er$ %.&56.4&8.6000
'ec( !u))*rt$ %.&56.4&8.6%6%
U.!. '*ll +ree$ %.8,,.344.486%
!ales$ %.&56.4&8.6&6&
www.asterisk.org
www.digium.com
www.asterisknow.org
- Digium
.
, Inc. &0%&
All rig(ts reserve.
N* )art */ t(is )u#licati*n ma0 #e c*)ie, istri#ute, transmitte, transcri#e, st*re in a
retrieval s0stem, *r translate int* an0 (uman *r c*m)uter language 1it(*ut t(e )ri*r 1ritten
)ermissi*n */ Digium, Inc.
Digium, Inc. (as mae ever0 e//*rt t* ensure t(at t(e instructi*ns c*ntaine in t(is *cument
are ae2uate an err*r /ree. '(e manu/acturer 1ill, i/ necessar0, e3)lain issues 1(ic( ma0
n*t #e c*vere #0 t(is *cumentati*n. '(e manu/acturer4s lia#ilit0 /*r an0 err*rs in t(e
*cuments is limite t* t(e c*rrecti*n */ err*rs an t(e a/*rementi*ne avis*r0 services.
'(is *cument (as #een )re)are /*r use #0 )r*/essi*nal an )r*)erl0 traine )ers*nnel,
an t(e cust*mer assumes /ull res)*nsi#ilit0 1(en using it.
A*#e an Acr*#at are registere traemar5s, an Acr*#at 6eaer is a traemar5 */ A*#e
!0stems Inc*r)*rate.
Asteris5, Digium, !1itc(v*3, an Asteris5N7W are registere traemar5s an Asteris5
8usiness 9iti*n, Asteris5:UI, an Asteris5 A))liance are traemar5s */ Digium, Inc.
An0 *t(er traemar5s menti*ne in t(e *cument are t(e )r*)ert0 */ t(eir res)ective *1ners.
Digium, n!. "age 2

'A8L9 7+ ;7N'9N'!
#$a%ter 1& 'vervie(.................................................................................................................6
%.% W(at is Asteris5.<..........................................................................................................,
%.& Asteris5 as a =(*ne !1itc( >=8?@..................................................................................,
%.3 Asteris5 as a :ate1a0.....................................................................................................,
%.4 Asteris5 as a +eatureA"eia !erver................................................................................,
%.5 Asteris5 in t(e ;all ;enter...............................................................................................,
%.6 Asteris5 in t(e Net1*r5....................................................................................................8
%., Asteris5 9ver01(ere........................................................................................................8
#$a%ter 2& nstallation..............................................................................................................)
&.% Installati*n 7vervie1......................................................................................................%0
&.& 6egister +a3 +*r Asteris5..............................................................................................%0
&.3 Determine 7)timum 8uil.............................................................................................%%
&.4 Determine 6e2uire ;*m)*nents.................................................................................%&
&.5 Install resB/a3.................................................................................................................%&
&.6 Install resB/a3Bigium....................................................................................................%3
&., L*a +a3 +*r Asteris5 "*ules.....................................................................................%3
&.,.% a))B/a3 ;*n/lict......................................................................................................%4
&.8 Ceri/0 Installati*n...........................................................................................................%5
&.D 8ac5u) License +ile.......................................................................................................%6
#$a%ter *& #on+iguration........................................................................................................17
3.% A))licati*n Inter/aces....................................................................................................%,
3.%.% +A?7=' +uncti*n .................................................................................................%,
3.%.& !en+A? A))licati*n ............................................................................................&0
3.%.3 6eceive+A? A))licati*n.........................................................................................&%
3.& resB/a3.c*n/...................................................................................................................&3
3.3 resB/a3Bigium.c*n/.......................................................................................................&4
Digium, n!. "age *

3.4 ;*m)ati#ilit0 1it( !)anD!=..........................................................................................&4
#$a%ter ,& -rou.les$ooting...................................................................................................2/
4.% "anager 9vents.............................................................................................................&5
4.%.% +a3 'ransmissi*n ;*m)leti*n 9vents....................................................................&5
4.%.& +a3 !tatus 9vents..................................................................................................&6
4.%.3 '.38 +a3 !tatus 9vents..........................................................................................&,
4.%.4 +a3 D*cument !tatus 9vents.................................................................................&8
4.& "anager Acti*ns............................................................................................................&D
4.&.% +a3LicenseList Acti*n............................................................................................&D
4.&.& +a3License!tatus Acti*n........................................................................................&D
4.3 +A?7='>err*r@ Calues..................................................................................................30
4.4 Asteris5 ;*mman Line Inter/ace >;LI@........................................................................33
4.4.% /a3 set e#ug *n.....................................................................................................33
4.4.& /a3 set e#ug *//.....................................................................................................34
4.4.3 /a3 set g,%%ca) *//.................................................................................................34
4.4.4 /a3 set g,%%ca) *n.................................................................................................34
4.4.5 /a3 set t38ca) *//....................................................................................................34
4.4.6 /a3 set t38ca) *n....................................................................................................34
4.4., /a3 s(*1 ca)a#ilities..............................................................................................34
4.4.8 /a3 s(*1 (*sti.......................................................................................................35
4.4.D /a3 s(*1 licenses...................................................................................................35
4.4.%0 /a3 s(*1 sessi*n EiF..........................................................................................35
4.4.%% /a3 s(*1 sessi*ns................................................................................................35
4.4.%& /a3 s(*1 settings..................................................................................................35
4.4.%3 /a3 s(*1 stats.......................................................................................................35
4.4.%4 /a3 s(*1 versi*n...................................................................................................36
4.5 +re2uentl0 As5e Guesti*ns.........................................................................................3,
A%%endix A& Dial%lan 0xam%les............................................................................................,*
A.% !im)le +a3 'ransmit A 6eceive.....................................................................................43
A.& 'run5, a))B/a3, an !)anD!= 0.0.6............................................................................45
A.3 Asteris5 %.4, ag3HastHa*ns, an !)anD!= 0.0.4......................................................46
Digium, n!. "age ,

A%%endix 1& 2lossar3 and A!ron3ms..................................................................................,4
A%%endix #& D25M 06D-570R "5R#8A70 A6D 9#0670 A2R00M06-..................../)
Digium, n!. "age /

#$a%ter 1& 'vervie(
Digium4s +a3 +*r Asteris5I is a c*mmercial /acsimile >/a3@ terminati*n an *riginati*n
s*luti*n esigne t* en(ance t(e ca)a#ilities */ 7)en !*urce an c*mmercial Asteris5, as
1ell as !1itc(v*3. +a3 +*r Asteris5 #unles a suite */ userH/rienl0 Asteris5 a))licati*ns an
/a3 m*em s*/t1are. +a3 +*r Asteris5 )r*vies l*1 s)ee >%4,400 #)s@ =!'N /a3ing via
DAHDIHc*m)ati#le tele)(*n0 #*ars as 1ell as C*I= /a3ing t* '.38Hc*m)ati#le !I= en)*ints
an service )r*viers. License *n a )erHc(annel #asis, Digium4s +a3 +*r Asteris5 )r*vies a
c*m)lete, c*stHe//ective, c*mmercial /a3 s*luti*n /*r Asteris5 users.
+a3 +*r Asteris5 )r*vies t1* c*m)*nents$ resB/a3 an resB/a3Bigium. '(e resB/a3 Asteris5
res*urce m*ule as /a3 terminati*n an *riginati*n /uncti*nalit0 in Asteris5. It )r*vies t(e
+A?7=' Asteris5 ial)lan /uncti*n an t(e !en+A? an 6eceive+A? ial)lan a))licati*ns
t* ena#le t(e user t* #uil (ig(l0Hcust*miJa#le /a3 s*luti*ns. '(e resB/a3Bigium Asteris5
res*urce m*ule )r*vies c*re /a3 )r*cessing /uncti*nalit0 in t(e /*rm */ '.38 su))*rt an
several su))*rte /a3 m*ems K C.&%, C.&,ter, C.&D, an C.%, K 1(ic( ac(ieve s)ees u) t*
%4,400 #)s.
+a3 +*r Asteris5 )r*vies t(e /uncti*nalit0 t* sen an receive /a3es t* an /r*m 'D" an I=
c(annels K 'D" c(annels are esta#lis(e acr*ss Digium tele)(*n0 #*ars, an I= c(annels
using '.38 enca)sulati*n. +a3es transmitte an receive #0 +a3 +*r Asteris5 #egin an en
as 'I++ image /iles. 'I++ /iles ma0 #e reail0 c*nverte int* *r /r*m *t(er /*rmats using
stanar Linu3 c*mmanHline utilities.
Digium4s cust*mers */ +a3 +*r Asteris5 ma0 )urc(ase license 5e0s c*e /*r a s)eci/ic
num#er */ c(annels. 9ac( license c(annel all*1s +a3 +*r Asteris5 t* initiate *ne m*em
sessi*n *r )r*cess *ne /a3 sessi*n. As cust*mers nee t* e3)an t(eir /a3 ca)acit0, t(e0
ma0 )urc(ase aiti*nal license 5e0s t* register *n t(eir e3isting Asteris5 s0stem. '(e
aggregate num#er */ c(annels acr*ss all registere license 5e0s 1ill #e mae availa#le t*
Asteris5.
9ac( *)en s*urce *r c*mmercial Asteris5 s0stem is eligi#le t* receive /r*m Digium, a single
c(annel */ +a3 +*r Asteris5, calle +ree +a3 +*r Asteris5, /*r n* c*st. +ree +a3 +*r Asteris5
is )r*vie uner license asHis, 1it(*ut tec(nical su))*rt, an is availa#le t* all Asteris5 users
as a /ree, Jer* c*st )urc(ase /r*m t(e Digium 1e#st*re. 7nl0 *ne c(annel */ +ree +a3 +*r
Asteris5 ma0 #e use 1it( an installati*n */ Asteris5. I/ 0*u re2uire multi)le c(annels */ +a3
ca)a#ilit0 *r i/ 0*u re2uire DigiumLs tec(nical su))*rt, 0*u ma0 )urc(ase c(annels */ +a3 +*r
Asteris5 /r*m http://www.digium.com .
Digium, n!. "age 6

1.1 :$at is Asterisk;<
Asteris5 is t(e 1*rl4s leaing *)en s*urce tele)(*n0 engine an t**l 5it. 7//ering /le3i#ilit0
un(ear */ in t(e 1*rl */ )r*)rietar0 c*mmunicati*ns, Asteris5 em)*1ers evel*)ers an
integrat*rs t* create avance c*mmunicati*n s*luti*ns.../*r /ree. Asteris5 is release as
*)en s*urce uner t(e :NU :eneral =u#lic License >:=L@, an it is availa#le /*r *1nl*a
/ree */ c(arge. Asteris5 is t(e m*st )*)ular *)en s*urce tele)(*n0 s*/t1are availa#le, 1it(
t(e Asteris5 ;*mmunit0 #eing t(e t*) in/luencer in C*I=.
1.2 Asterisk as a "$one 7(it!$ ="1>?
Asteris5 can #e c*n/igure as t(e c*re */ an I= *r (0#ri =8?, s1itc(ing calls, managing
r*utes, ena#ling /eatures, an c*nnecting callers 1it( t(e *utsie 1*rl *ver I=, anal*g
>=7'!@, an igital >'%A9%AJ%A86I@ c*nnecti*ns. Asteris5 runs *n a 1ie variet0 */ *)erating
s0stems incluing Linu3, "ac 7! ?, 7)en8!D, +ree8!D, an !un !*laris. It )r*vies all */
t(e /eatures 0*u 1*ul e3)ect /r*m a =8? incluing man0 avance /eatures t(at are */ten
ass*ciate 1it( (ig( en >an (ig( c*st@ )r*)rietar0 =8?s. Asteris5Ls arc(itecture is esigne
/*r ma3imum /le3i#ilit0 an su))*rts C*ice *ver I= in man0 )r*t*c*ls, an can inter*)erate
1it( alm*st all stanarsH#ase tele)(*n0 e2ui)ment using relativel0 ine3)ensive (ar1are.
1.* Asterisk as a 2ate(a3
It can als* #e #uilt *ut as t(e (eart */ a meia gate1a0, #riging t(e legac0 =!'N t* t(e
e3)aning 1*rl */ I= tele)(*n0. Asteris54s m*ular arc(itecture all*1s it t* c*nvert #et1een
a 1ie range */ c*mmunicati*ns )r*t*c*ls an meia c*ecs.
1., Asterisk as a Feature@Media 7erver
Nee an IC6< Asteris54s g*t 0*u c*vere. H*1 a#*ut a c*n/erence #rige< Me). It4s in t(ere.
W(at a#*ut an aut*mate attenant< Asteris5 *es t(at t**. H*1 a#*ut a re)lacement /*r
0*ur aging legac0 v*icemail s0stem< ;an *. Uni/ie messaging< N* )r*#lem. Nee a
tele)(*n0 inter/ace /*r 0*ur 1e# site< 75a0.
1./ Asterisk in t$e #all #enter
Asteris5 (as #een a*)te #0 call centers ar*un t(e 1*rl #ase *n its /le3i#ilit0. ;all center
an c*ntact center evel*)ers (ave #uilt c*m)lete A;D s0stems #ase *n Asteris5. Asteris5
(as als* ae ne1 li/e t* e3isting call center s*luti*ns #0 aing rem*te I= agent
ca)a#ilities, avance s5illsH#ase r*uting, )reictive an #ul5 ialing, an m*re.
Digium, n!. "age 7

1.6 Asterisk in t$e 6et(ork
Internet 'ele)(*n0 !ervice =r*viers >I'!=s@, ;*m)etitive L*cal 93c(ange ;arriers >;L9;s@
an even /irstHtier incum#ents (ave isc*vere t(e )*1er */ *)en s*urce c*mmunicati*ns
1it( Asteris5. +eature servers, (*ste services clusters, v*icemail s0stems, an )reH)ai
calling s*luti*ns, all #ase *n Asteris5 (ave (el)e reuce c*sts an ena#le /le3i#ilit0.
1.7 Asterisk 0ver3($ere
Asteris5 (as #ec*me t(e #asis /*r t(*usans */ c*mmunicati*ns s*luti*ns. I/ 0*u nee t*
c*mmunicate, Asteris5 is 0*ur ans1er. +*r m*re in/*rmati*n *n Asteris5, visit
http://www.asterisk.org *r http://www.digium.com.
Digium, n!. "age 4

#$a%ter 2& nstallation
'(is c(a)ter 1ill guie 0*u t(r*ug( t(e necessar0 ste)s t* install DigiumLs +a3 +*r Asteris5.
nstall 6otes&
'.38 'erminati*n is *nl0 availa#le in t(e resB/a3 an resB/a3Bigium m*ules /*r
t(e 7)en !*urce Asteris5 %.6 >an later@ releases. '(is is #ecause t(e 7)en
!*urce Asteris5 %.4 releases * n*t su))*rt '.38 'erminati*n.
I/ 0*u 1ill #e using an 7)en !*urce Asteris5 %.4 release, Digium rec*mmens
using 7)en !*urce Asteris5 %.4.&& *r ne1er. Cersi*ns )ri*r t* %.4.&& (ave n*t
#een teste.
I/ 0*u 1ill #e /a3ing *ver 'D", Digium rec*mmens using DAHDI &.%.0.3 *r ne1er.
Cersi*ns )ri*r t* &.%.0.3 (ave n*t #een teste.
Digium rec*mmens a minimum versi*n /*r t(e vari*us *//erings */ Asteris5. '(e
rec*mmenati*ns are )r*vie in t(e ta#le s(*1n #el*1. Cersi*ns )ri*r t* t(*se
rec*mmene (ave n*t #een teste.
Asterisk Re!ommended Minimum Aersion
7)en !*urce Asteris5 #ranc( %.4 %.4.&&
7)en !*urce Asteris5 #ranc( %.6.& %.6.&.0
7)en !*urce Asteris5 #ranc( %.8 %.8.0
Digium, n!. "age )

2.1 nstallation 'vervie(
7nce 0*u (ave 0*ur +a3 +*r Asteris5 license 5e0, t(ere are a /e1 tas5s t* )er/*rm in *rer t*
install +a3 +*r Asteris5.
%. D*1nl*a an e3ecute t(e register utilit0 t* generate a vali license.
&. D*1nl*a an e3ecute t(e benchfax utilit0 t* etermine t(e *)timum #uil.
3. Use t(e Fax Selector 1e# utilit0 t* etermine 0*ur re2uire c*m)*nents.
4. D*1nl*a an install t(e res_fax #inar0 t(at is #uilt /*r 0*ur )lat/*rm >Asteris5 %.4 an
%.6 *nl0@.
5. D*1nl*a an install t(e res_fax_digium #inar0 t(at is #uilt /*r 0*ur )lat/*rm.
'(e register utilit0 ma0 #e *1nl*ae /r*m$
http://downloads.digium.com/pub/register/
'(e #enc(/a3 utilit0 ma0 #e *1nl*ae /r*m$
http://downloads.digium.com/pub/telephony/fax/benchfax/
'(e +a3 !elect*r 1e# utilit0 ma0 #e accesse /r*m$
http://www.digium.com/en/docs/FAX/faadownload.php
'(e resB/a3 #inar0 ma0 #e *1nl*ae /r*m$
http://downloads.digium.com/pub/telephony/fax/res_fax/
!he res_fax_digium binary may be downloaded from:
http://downloads.digium.com/pub/telephony/fax/res_fax_digium/
6ote& !u))*rte s*/t1are #uils are )r*vie /*r 3&H#it an 64H#it 386 )lat/*rms, an
are *)timiJe /*r a variet0 */ )r*cess*r t0)es. ;(**se t(e irect*r0 t(at cl*sest
matc(es 0*ur Asteris5 versi*n an )r*cess*r t0)e. 9ac( */ t(ese irect*ries c*ntains
'A6 /iles 1(ic( inclue t(e /a3 m*ules /*r eac( t0)e */ su))*rte )r*cess*r.
2.2 Register Fax For Asterisk
6egistrati*n */ t(e +a3 +*r Asteris5 license 5e0 1ill #e *ne using t(e Digium register utilit0 in
t(e same 1a0 as 1it( *t(er m*ules li5e ;e)stral, H=9;, an :.,&D. '(e registrati*n utilit0
1ill )r*m)t 0*u /*r 0*ur +a3 +*r Asteris5 license 5e0. An e3am)le /*r 3&H#it Linu3 (as #een
)r*vie #el*1. 8e sure t* l*g in as t(e user Nr**tO #e/*re e3ecuting similar c*mmans.
Digium, n!. "age 10

# cd /root
# wget http://downloads.digium.com/pub/register/x86-32/register
# chmod 500 /root/register
# /root/register
6otes&
Internet access is re2uire /r*m 0*ur Asteris5 server in *rer t* register 0*ur +a3 +*r
Asteris5 5e0 /*r license use. 7utg*ing net1*r5 tra//ic *n ';= )*rt 443 >!!L@ must #e
all*1e in *rer /*r t(e register utilit0 t* success/ull0 c*mmunicate 1it( DigiumLs
license server an c*m)lete t(e registrati*n )r*cess. M*u must (ave at least *ne
9t(ernet evice in 0*ur Asteris5 server in *rer /*r t(e registrati*n )r*cess t* c*m)lete
success/ull0.
"ulti)le +a3 +*r Asteris5 5e0s ma0 #e registere *n t(e same Asteris5 server. '(is 1ill
all*1 0*u t* increase t(e t*tal num#er */ availa#le +a3 +*r Asteris5 c(annels *n 0*ur
Asteris5 server. Ne1 +a3 +*r Asteris5 5e0s ma0 #e registere t* 0*ur Asteris5 server
using t(e same instructi*ns )r*vie a#*ve. '(ere 1ill #e an aiti*nal +a3 +*r
Asteris5 license /ile generate in t(e AvarAli#Aasteris5Alicenses irect*r0 /*r eac( +a3
+*r Asteris5 5e0 t(at is success/ull0 registere t* 0*ur Asteris5 server. It is e3tremel0
im)*rtant t(at 0*u /*ll*1 t(e instructi*ns )r*vie in secti*n ".# 1(enever a ne1 +a3
+*r Asteris5 5e0 is success/ull0 registere t* 0*ur Asteris5 server.
A +a3 +*r Asteris5 5e0 must #e reHregistere i/ an0 */ t(e 9t(ernet evices in 0*ur
Asteris5 server are c(ange, ae, *r rem*ve. '(e uni2ue +a3 +*r Asteris5 license
/ile 1(ic( is l*cate in 0*ur AvarAli#Aasteris5Alicenses irect*r0 is tie t* t(e "A;
aress */ all t(e 9t(ernet evices installe in 0*ur s0stem. A +a3 +*r Asteris5 5e0 can
*nl0 #e reHregistere *nce 1it(*ut aut(*riJati*n /r*m Digium. Digium must #e
c*ntacte #0 )(*ne in *rer t* re2uest aut(*riJati*n t* (ave 0*ur +a3 +*r Asteris5 5e0
incremente. Digium reserves t(e rig(t t* en0 aut(*riJati*n /*r (aving a +a3 +*r
Asteris5 5e0 incremente. =lease n*te t(at Digium 1ill n*t )r*vie assistance 1it(
+ree +a3 +*r Asteris5 5e0sP su))*rt is *nl0 )r*vie /*r )ai +a3 +*r Asteris5
cust*mers.
2.* Determine '%timum 1uild
'(ere are vari*us *)timiJe versi*ns */ t(e /a3 m*ule availa#le /*r i//erent ;=U t0)es in
386H3& an 386H64 arc(itectures. '* etermine 1(ic( #uil */ t(e m*ule )er/*rms #est *n
0*ur s0stem, t(e benchfax utilit0 1ill run a series */ tests, an re)*rt 1(ic( /a3 m*ule 1ill
ma3imiJe )er/*rmance *n 0*ur s0stem. An e3am)le (as #een )r*vie #el*1.
Digium, n!. "age 11

# wget http://downloads.digium.com/pub/telephon/!ax/bench!ax/"
x86-32/bench!ax-#.#.0-x86$32 -% bench!ax
# chmod 500 /root/bench!ax
# /root/bench!ax
2., Determine ReBuired #om%onents
De)ening u)*n 0*ur versi*n */ Asteris5 an )r*cess*r arc(itecture, i//erent c*m)*nents
are re2uire /*r t(e use */ +a3 +*r Asteris5. Digium )r*vies a Fax Selector 1e# utilit0 in
*rer t* assist 1it( c(**sing t(e c*rrect c*m)*nents. '(e Fax Selector 1e# utilit0 s(*ul #e
vie1e using a stanar 1e# #r*1ser an ma0 #e accesse via t(e /*ll*1ing U6L$
http://www.digium.com/en/docs/FAX/faadownload.php
'(e /iles t(at t(e Fax Selector 1e# utilit0 in/*rms 0*u are re2uire /*r 0*ur )lat/*rm are t(e
*nes t(at 0*u s(*ul use in )lace */ t(e /*ll*1ing installati*n e3am)les.
2./ nstall resC+ax
!ince Asteris5 %.8 >an later@ c*mes )re)ac5age 1it( res_fax, t(is secti*n a))lies *nl0 t*
Asteris5 %.4 an %.6. '(ere are i//erent versi*ns */ res_fax /*r vari*us Asteris5 releasesP
t(ere is a single versi*n /*r Asteris5 %.4.&& an a#*ve, an t(ere are versi*ns /*r Asteris5
%.6.& releases. 'a5e n*te t(at t(ese m*ules are not l*aa#le in )ri*r releases */ Asteris5,
*nl0 t(e s)eci/ic versi*n t(e0 are esigne t* #e use 1it(. =lease #e sure t(at 0*u *1nl*a
t(e c*rrect versi*n */ res_fax /*r 0*ur Asteris5 versi*n as rec*mmene #0 t(e Fax Selector
1e# utilit0. 8e a1are t(at t(e Fax Selector 1e# utilit0 ma0 inicate t(at 0*ur versi*n */
Asteris5 *es n*t re2uire t(at 0*u *1nl*a an install t(e res_fax m*ule.
I/ t(e Fax Selector 1e# utilit0 i n*t inicate t(at a res_fax *1nl*a is re2uire /*r 0*ur
s0stem, )lease s5i) t* secti*n ".$.
'(ere are /re2uentl0 u)ate #uils */ res_fax )*ste, an eac( #uil (as a %ersion number.
'(is versi*n num#er is )art */ t(e /ilename, an is als* inclue in t(e c*)0rig(tAlicense
message t(at is is)la0e 1(en t(e m*ule is l*ae int* Asteris5. In t(is *cument, #uil
num#er &.'.( (as #een use as an e3am)le, #ut 1(en 0*u rea t(is *cument t(e current
#uil num#er ma0 #e i//erent >(ig(er@.
'(e res_fax m*ule must #e e3tracte an )lace in Asteris5Ls m*ules irect*r0 >e/ault
is AusrAli#Aasteris5Am*ules@. An e3am)le (as #een )r*vie #el*1.
# wget http://downloads.digium.com/pub/telephon/!ax/res$!ax/"
asteris&-#.6.2/x86-32/res$!ax-#.6.2$#.3.0-x86$32.tar.g'
Digium, n!. "age 12

# tar x'(! res$!ax-#.6.2$#.3.0-x86$32.tar.g'
# cp /root/res$!ax-#.6.2$#.3.0-x86$32/res$!ax.so "
/usr/lib/asteris&/modules
2.6 nstall resC+axCdigium
'(ere are i//erent versi*ns */ res_fax_digium /*r vari*us Asteris5 releasesP t(ere is a single
versi*n /*r Asteris5 %.4.&& an a#*ve, an t(ere are versi*ns /*r Asteris5 %.6.& releases an
Asteris5 %.8.3 )*int releases. 'a5e n*te t(at t(ese m*ules are not l*aa#le in )ri*r releases
*/ Asteris5, *nl0 t(e s)eci/ic versi*n t(e0 are esigne t* #e use 1it(. =lease #e sure t(at
0*u *1nl*a t(e c*rrect versi*n */ res_fax_digium /*r 0*ur Asteris5 versi*n as
rec*mmene #0 t(e Fax Selector 1e# utilit0.
'(ere are /re2uentl0 u)ate #uils */ res_fax_digium )*ste, an eac( #uil (as a %ersion
number. '(is versi*n num#er is )art */ t(e /ilename, an is als* inclue in t(e
c*)0rig(tAlicense message t(at is is)la0e 1(en t(e m*ule is l*ae int* Asteris5. In t(is
*cument, #uil num#er &.'.( (as #een use as an e3am)le, #ut 1(en 0*u rea t(is
*cument t(e current #uil num#er ma0 #e i//erent >(ig(er@.
'(e res_fax_digium m*ule must #e e3tracte an )lace in Asteris5Ls m*ules irect*r0
>e/ault is AusrAli#Aasteris5Am*ules@. An e3am)le (as #een )r*vie #el*1.
# wget http://downloads.digium.com/pub/telephon/!ax/res$!ax$digium/"
asteris&-#.6.2/x86-32/res$!ax$digium-#.6.2$#.3.0-pentium)m.tar.g'
# tar x'(! res$!ax$digium-#.6.2$#.3.0-pentium)m.tar.g'
# cp /root/res$!ax$digium-#.6.2$#.3.0-pentium)m/res$!ax$digium.so "
/usr/lib/asteris&/modules
2.7 9oad Fax For Asterisk Modules
'(e resB/a3 an resB/a3Bigium Asteris5 res*urce m*ules must #e l*ae in Asteris5 in
*rer t* use t(e +a3 +*r Asteris5 c(annels. An e3am)le is )r*vie #el*1.
*+,-. module load res$!ax.so
*+,-. module load res$!ax$digium.so
I/ 0*u alrea0 (ave resB/a3Bigium.s* l*ae an (ave registere a ne1 license 5e0 t*
increase t(e num#er */ +a3 +*r Asteris5 c(annels, sim)l0 rel*a t(e m*ule #0 issuing t(e
/*ll*1ing c*mman.
Digium, n!. "age 1*

*+,-. module reload res$!ax$digium.so
6el*aing t(is m*ule 1ill *nl0 #e success/ul i/ n* /a3 sessi*ns are in )r*gress. I/ t(ere are
active /a3 sessi*ns, 0*u 1ill eit(er (ave t* 1ait until t(e0 (ave c*m)lete t* manuall0 rel*a
t(e m*ule, *r sc(eule Asteris5 t* restart *nce t(ere are n* active calls #0 e3ecuting t(e
/*ll*1ing c*mman.
# asteris& -rx /restart when con(enient0
2.7.1 a%%C+ax #on+li!t
I/ t(e !)anD!= li#rar0 is installe *n 0*ur s0stem an 0*u are using an 7)en !*urce Asteris5
%.6 release, it is )*ssi#le t(at a c*n/licting Asteris5 m*ule #0 t(e name */ a))B/a3 is l*cate
in 0*ur Asteris5 m*ules irect*r0. I/ t(is is t(e case, 0*u 1ill nee t* a t(e /*ll*1ing line t*
t(e )modules* secti*n */ t(e AetcAasteris5Am*ules.c*n/ /ile in *rer t* )r*)erl0 l*a t(e
resB/a3 m*ule.
noload 1. app$!ax.so
I/ 0*u alrea0 (ave a))B/a3.s* l*ae, sim)l0 unl*a t(e m*ule #0 issuing t(e /*ll*1ing
c*mman.
*+,-. module unload app$!ax.so
Unl*aing t(is m*ule 1ill *nl0 #e success/ul i/ n* /a3 sessi*ns are in )r*gress. I/ t(ere are
active /a3 sessi*ns, 0*u 1ill eit(er (ave t* 1ait until t(e0 (ave c*m)lete t* manuall0 unl*a
t(e m*ule, *r sc(eule Asteris5 t* restart *nce t(ere are n* active calls #0 e3ecuting t(e
/*ll*1ing c*mman.
# asteris& -rx /restart when con(enient0
Digium, n!. "age 1,

2.4 Aeri+3 nstallation
Ceri/0 t(at t(e num#er */ +a3 +*r Asteris5 c(annels availa#le t* Asteris5 matc(es t(e num#er
*/ +a3 +*r Asteris5 c(annels t(at 0*u )urc(ase. '(is can #e veri/ie #0 issuing Q/a3 s(*1
statsQ in t(e Asteris5 ;LI. 'a5e int* c*nsierati*n an0 )revi*us +a3 +*r Asteris5 c(annels t(at
0*u ma0 (ave alrea0 (a registere t* 0*ur Asteris5 server #e/*re veri/0ing t(is num#er. An
e3am)le is )r*vie #el*1.
# asteris& -r(((
*+,-. !ax show stats
2ax 3tatistics:
---------------
+urrent 3essions
4ransmit 5ttempts
6ecei(e 5ttempts
+ompleted 2axes
2ailed 2axes
: 0
: 0
: 0
: 0
: 0
7igium 4.38
,icensed +hannels
8ax +oncurrent
3uccess
+anceled
9o 2ax
:artial
9egotiation 2ailed
4rain 2ailure
:rotocol ;rror
-% :artial
-% 2ail
: 200
: 0
: 0
: 0
: 0
: 0
: 0
: 0
: 0
: 0
: 0
7igium <.=##
,icensed +hannels
8ax +oncurrent
3uccess
3witched to 4.38
+anceled
9o 2ax
:artial
: 200
: 0
: 0
: 0
: 0
: 0
: 0
Digium, n!. "age 1/

9egotiation 2ailed
4rain 2ailure
: 0
: 0
:rotocol ;rror : 0
-% :artial : 0
-% 2ail : 0
2.) 1a!ku% 9i!ense File
It is e3tremel0 im)*rtant t(at 0*u #ac5u) all */ t(e /iles l*cate in t(e AvarAli#Aasteris5Alicenses
irect*r0. '(is irect*r0 c*ntains t(e H*stHID s)eci/ic license /iles /*r 0*ur s0stem. '(ese
license /iles are tie t* t(e "A; aress */ all t(e 9t(ernet evices installe in 0*ur s0stem.
;reating a #ac5u) */ t(is irect*r0 1ill all*1 0*u t* rest*re 0*ur +a3 +*r Asteris5 licenses in
case 0*u nee t* reinstall 0*ur *)erating s0stem.
6ote& A +a3 +*r Asteris5 5e0 must #e reHregistere i/ an0 */ t(e 9t(ernet evices in
0*ur Asteris5 server are c(ange, ae, *r rem*ve. A +a3 +*r Asteris5 5e0 can *nl0
#e reHregistere *nce 1it(*ut aut(*riJati*n /r*m Digium. Digium must #e c*ntacte #0
)(*ne in *rer t* re2uest aut(*riJati*n t* (ave 0*ur +a3 +*r Asteris5 5e0 incremente.
Digium reserves t(e rig(t t* en0 aut(*riJati*n /*r (aving a +a3 +*r Asteris5 5e0
incremente. =lease n*te t(at Digium 1ill n*t )r*vie assistance 1it( +ree +a3 +*r
Asteris5 5e0sP su))*rt is *nl0 )r*vie /*r )ai +a3 +*r Asteris5 cust*mers.
Digium, n!. "age 16

#$a%ter *& #on+iguration
DigiumLs +a3 +*r Asteris5 (as a variet0 */ c*n/igurati*n *)ti*ns. '(is c(a)ter )r*vies an
e3)lanati*n */ t(e c*n/igurati*n *)ti*ns 1(ic( are availa#le.
*.1 A%%li!ation nter+a!es
'(e +A?7=' ial)lan /uncti*n an t(e !en+A? an 6eceive+A? Asteris5 a))licati*ns
)r*vie /a3 inter/aces t* t(e Asteris5 ial)lan. Arguments are use t* s)eci/0 /a3 transmissi*n
etails li5e in)utA*ut)ut /a3 /ile an t(e ena#lement */ e#ug *r 9;". '(e /*ll*1ing secti*ns
etail t(e *)ti*ns /*r t(e +A?7=' /uncti*n an t(e /a3 a))licati*ns.
*.1.1 FA>'"- Fun!tion
'(e +A?7=' ial)lan /uncti*n is use t* set *)ti*ns t* #e use #0 t(e !en+A? an
6eceive+A? a))licati*ns, an t* rea results a/ter a !en+A? *r 6eceive+A? a))licati*n
c*m)letes. '(e *)ti*ns availa#le t* +A?7=' are liste in t(e ta#le #el*1.
Digium, n!. "age 17

'%tion -3%e Des!ri%tion Aalues
ecm 6W !)eci/0 t(e 9rr*r ;*rrecti*n "*e >9;"@ 0es R n*
err*r 67 6ea /a3 transmissi*n /ailure reas*n Eerr*rF
/ilename 67
6ea t(e /ilename use uring t(e /a3 transmissi*n.
Limite t* is)la0ing a single /ilename.
E/ilenameF
/ilenames 67
6ea t(e /ilenames use uring t(e /a3
transmissi*n. '(e *ut)ut is c*mma se)arate.
E/ilenamesF
(eaerin/* 6W !)eci/0 t(e /a3 (eaer EstringF
l*calstati*ni 6W !)eci/0 t(e l*cal stati*n ienti/icati*n EstringF
ma3rate 6W
!)eci/0 t(e ma3imum trans/er rate t* #e use uring
t(e /a3 transmissi*n rate neg*tiati*n
&400 R 4800 R ,&00 R D600 R %&&00 R %4400
minrate 6W
!)eci/0 t(e minimum trans/er rate t* #e use uring
t(e /a3 transmissi*n rate neg*tiati*n
&400 R 4800 R ,&00 R D600 R %&&00 R %4400
m*em 6W
!)eci/0 t(e m*em>s@ ca)a#ilities /*r a sessi*n.
!)eci/icati*n */ a single m*em 1ill /*rce t(at
m*em t0)e. !)eci/icati*n is a c*mmaHse)arate
list */ *ne *r m*re */ t(e )*ssi#le values
C%, R C&, R C&D R C34
)ages 67
6ea t(e num#er */ )ages trans/erre uring t(e /a3
transmissi*n
EintF
rate 67 6ea t(e neg*tiate /a3 transmissi*n rate &400 R 4800 R ,&00 R D600 R %&&00 R %4400
rem*testati*ni 67 6ea t(e rem*te stati*n ienti/icati*n EstringF
res*luti*n 67 6ea t(e image neg*tiati*n Eimage res*luti*nF
status 67 6ea t(e result status */ t(e /a3 transmissi*n !U;;9!! R +AIL9D
statusstr 67
6ea a ver#*se result status string */ t(e /a3
transmissi*n
EstatusstrF
+A?7=' *)ti*ns */ 6W >6eaAWrite@ t0)es are 1ritten #e/*re t(e /a3 transmissi*n an are
t0)icall0 eit(er reaa#le a/ter t(e /a3 transmissi*n (as c*m)lete *r /*ll*1ing a +A?7='
1rite *)erati*n. +A?7=' *)ti*ns */ 67 >6ea 7nl0@ t0)es can *nl0 #e rea /*ll*1ing t(e
c*m)leti*n */ a !en+A? *r 6eceive+A? a))licati*n. +A?7=' *)ti*ns */ W7 >Write 7nl0@
t0)es can *nl0 #e 1ritten )ri*r t* t(e initiati*n */ !en+A? *r 6eceive+A?. 8el*1 are s*me
escri)ti*ns */ *)ti*ns t(at ma0 n*t #e intuitive.
e!m K 9rr*r ;*rrecti*n "*e >9;"@ ena#leAisa#le *)ti*n. '(is a))licati*n argument
is use t* s)eci/0 *r *verrie t(e current e/ault c*n/igurati*n setting. '(e e/ault
setting is 9;" ena#le. !ee secti*n '." /*r a list */ vali settings.
error K !ee secti*n +.' /*r a list */ )*ssi#le values.
lo!alstationid K L*cal stati*n ienti/icati*n. 'e3t string t(at ienti/ies t(e sener
ienti/icati*n t* t(e rem*te sie */ t(e /a3 transmissi*n.
maxrate K "a3imum trans/er rate use uring /a3 rate neg*tiati*n. !ee secti*n '." /*r
a list */ vali settings. '(e e/ault ma3imum trans/er rate is %4400.
Digium, n!. "age 14

minrate K "inimum trans/er rate use uring /a3 rate neg*tiati*n. !ee secti*n '." /*r a
list */ vali settings. '(e e/ault minimum trans/er rate is &400.
modem K A c*mma se)arate list */ *ne *r m*re */ t(e )*ssi#le values. '(e e/ault
value is NC%,,C&,,C&DO. '(is *)ti*n is intene t* re)lace t(e e)recate
+A?B+76;9B33 an +A?BDI!A8L9B33 c(annel varia#les.
Digium, n!. "age 1)

*.1.2 7endFA> A%%li!ation
'(e !en+A? a))licati*n is t(e e/ault a))licati*n /*r sening *ne *r m*re /a3 /iles. '(e %.4
versi*n */ resB/a3 )r*vies a rxtxappnames c*n/igurati*n *)ti*n t(at is intene t* ease
c*nversi*n t* resB/a3 /r*m !)anD!=H#ase a))licati*ns. An01(ere t(is *cument re/ers t*
SendFAX im)lies t(e *)ti*nal use */ !xFAX /*r t(e %.4 versi*n */ resB/a3 i/
AetcAasteris5AresB/a3.c*n/ inclues rxtxappnames,yes. '(e /*ll*1ing secti*n escri#es t(e
!en+A? inter/ace.
3end25>?@!ilenameAB!ilename2B!ilename3B...C.ADadCE
@!ilename. : 2ull path to the 4-22 image to transmit. -! sending
multiple !ax !ilesD append each additional !ull path using the
ampersand ?BE.
FdF G ;nables !ax debug reporting. 8ore granular e(ent reporting will
be obser(ed when F(erboseF logging is enabled in 5steris&. 8anager
sessions will recei(e manager e(ents !or each granular !ax session
e(ent. 4his is an optional argument. ?de!ault: o!!E
F!F G 5llow !ax !allbac& to audio mode on 4.38-capable channels
F'F G initiate a 4.38 rein(ite on the channel i! the remote end does
not
FsF G 3end progress 8anager e(ents ?o(errides statuse(ents setting in
res$!ax.con!E
'(e /*ll*1ing in)ut c(annel varia#les are use #0 !en+A? /*r #ac51ars c*m)ati#ilit0 1it(
)revi*us !)anD!=H#ase Asteris5 a))licati*ns. Ne1 evel*)ment an ial)lan creat*rs
s(*ul use t(e +A?7=' ial)lan /uncti*n. +A?7=' 1ill *verrie c(annel varia#les in t(e slim
case t(at #*t( +A?7=' an a c(annel varia#le 1ere use /*r t(e same call t* !en+A? *r
6eceive+A?P e.g. +A?7='>(eaerin/*@ an L7;ALH9AD96IN+7.
9'#A97-A-'6D K 'e3t string t(at ienti/ies t(e sener ienti/icati*n t* t(e rem*te
sie */ t(e /a3 transmissi*n.
9'#A980AD0R6F' K 'e3t string t(at #ec*mes t(e /a3 (eaer sent *n eac( )age. I/
t(is varia#le is n*t set, n* (eaer 1ill #e use.
'(e %.4 versi*n */ resB/a3 su))*rts t(e /*ll*1ing c(annel varia#les /*r #ac51ars
c*m)ati#ilit0, #ut it s(*ul #e n*te t(at t(ese c(annel varia#les are e)recate an n*t
su))*rte in %.6 *r ne1er versi*ns */ resB/a3.
FA>CD7A190CA17 K !et t* L%L t* isa#le C.%,.
FA>CF'R#0CA17 K !et t* L%L t* /*rce C.%,.
FA>CF'R#0CA27 K !et t* L%L t* /*rce C.&,.
FA>CF'R#0CA2) K !et t* L%L t* /*rce C.&D.
Digium, n!. "age 20

"8A7007-A-57 K '(is c(annel varia#le 1ill al1a0s (ave t(e same value as t(e
+A?!'A'U! c(annel varia#le an is in *nl0 intene t* ease c*nversi*n t* resB/a3.
"8A7007-R62 K '(is c(annel varia#le 1ill al1a0s (ave t(e same value as t(e
+A?!'A'U!!'6IN: c(annel varia#le an is *nl0 intene t* ease c*nversi*n */
resB/a3.
'(e /*ll*1ing *ut)ut varia#les are set #0 !en+A? 1(en t(e /a3 transmissi*n c*m)letes.
FA>7-A-57 K '(e /a3 *)erati*n result.
FA>0RR'R K '(e reas*n /*r a /a3 /ailure.
FA>7-A-577-R62 K '(e /a3 *)erati*n result string.
R0M'-07-A-'6D K 'e3t string t(at ienti/ies t(e rem*te stati*n.
FA>"A207 K '(e num#er */ )ages trans/erre uring t(e /a3 transmissi*n.
FA>1-RA-0 K '(e transmissi*n rate use /*r t(e /a3 transmissi*n.
FA>R07'95-'6 K '(e /a3 image res*luti*n use /*r t(e /a3 transmissi*n.
*.1.* Re!eiveFA> A%%li!ation
'(e 6eceive+A? a))licati*n is t(e e/ault a))licati*n /*r receiving a /a3 /ile. '(e %.4 versi*n
*/ resB/a3 )r*vies a rxtxappnames c*n/igurati*n *)ti*n t(at is intene t* ease c*nversi*n
t* resB/a3 /r*m !)anD!=H#ase a))licati*ns. An01(ere t(is *cument re/ers t* -ecei%eFAX
im)lies t(e *)ti*nal use */ -xFAX /*r t(e %.4 versi*n */ resB/a3 i/ AetcAasteris5AresB/a3.c*n/
inclues rxtxappnames,yes. '(e /*ll*1ing secti*n escri#es t(e 6eceive+A? inter/ace.
6ecei(e25>?@!ilename.ADcdCE
@!ilename. : 2ull path to the !ile to recei(eD o(erwrite i! !ile
alread exists
FdF G ;nables !ax debug reporting. 8ore granular e(ent reporting will
be obser(ed when F(erboseF logging is enabled in 5steris&. 8anager
sessions will recei(e manager e(ents !or each granular !ax session
e(ent. 4his is an optional argument ?de!ault: o!!E
F!F G 5llow !ax !allbac& to audio mode on 4.38-capable channels
FsF G 3end progress 8anager e(ents ?o(errides statuse(ents setting in
res$!ax.con!E
'(e /*ll*1ing in)ut c(annel varia#les are use #0 6eceive+A? /*r #ac51ars c*m)ati#ilit0
1it( )revi*us !)anD!=H#ase Asteris5 a))licati*ns. Ne1 evel*)ment an ial)lan creat*rs
s(*ul use t(e +A?7=' ial)lan /uncti*n. +A?7=' 1ill *verrie c(annel varia#les in t(e slim
case t(at #*t( +A?7=' an a c(annel varia#le 1ere use /*r t(e same call t* !en+A? *r
6eceive+A?P e.g. +A?7='>(eaerin/*@ an L7;ALH9AD96IN+7.
Digium, n!. "age 21

9'#A97-A-'6D K 'e3t string t(at ienti/ies t(e sener ienti/icati*n t* t(e rem*te
sie */ t(e /a3 transmissi*n.
9'#A980AD0R6F' K 'e3t string t(at #ec*mes t(e /a3 (eaer sent *n eac( )age. I/
t(is varia#le is n*t set, n* (eaer 1ill #e use.
'(e %.4 versi*n */ resB/a3 su))*rts t(e /*ll*1ing c(annel varia#les /*r #ac51ars
c*m)ati#ilit0, #ut it s(*ul #e n*te t(at t(ese c(annel varia#les are e)recate an n*t
su))*rte in %.6 *r ne1er versi*ns */ resB/a3.
FA>CD7A190CA17 K !et t* L%L t* isa#le C.%,.
FA>CF'R#0CA17 K !et t* L%L t* /*rce C.%,.
FA>CF'R#0CA27 K !et t* L%L t* /*rce C.&,.
FA>CF'R#0CA2) K !et t* L%L t* /*rce C.&D.
"8A7007-A-57 K '(is c(annel varia#le 1ill al1a0s (ave t(e same value as t(e
+A?!'A'U! c(annel varia#le an is in *nl0 intene t* ease c*nversi*n t* resB/a3.
"8A7007-R62 K '(is c(annel varia#le 1ill al1a0s (ave t(e same value as t(e
+A?!'A'U!!'6IN: c(annel varia#le an is *nl0 intene t* ease c*nversi*n t*
resB/a3.
'(e /*ll*1ing *ut)ut varia#les are set #0 6eceive+A? 1(en t(e /a3 transmissi*n c*m)letes.
FA>7-A-57 K '(e /a3 *)erati*n result.
FA>0RR'R K '(e reas*n /*r a /a3 /ailure.
FA>7-A-577-R62 K '(e /a3 *)erati*n result string.
R0M'-07-A-'6D K 'e3t string t(at ienti/ies t(e rem*te stati*n.
FA>"A207 K '(e num#er */ )ages trans/erre uring t(e /a3 transmissi*n.
FA>1-RA-0 K '(e transmissi*n rate use /*r t(e /a3 transmissi*n.
FA>R07'95-'6 K '(e /a3 image res*luti*n use /*r t(e /a3 transmissi*n.
Digium, n!. "age 22

*.2 resC+ax.!on+
'(e resB/a3.c*n/ /ile is *)ti*nal an 1ill su))*rt t(e c*n/igurati*n *)ti*ns liste in t(e ta#le
#el*1. I/ t(e resB/a3.c*n/ is n*t /*un at m*ule l*a time, c*m)ileHtime e/aults 1ill #e use.
'(e resB/a3 m*ule reas t(e )general* secti*n */ resB/a3.c*n/. In aiti*n t* t(e
c*n/igurati*n /ile, re/er t* secti*n '.&.& /*r 1a0s t* m*i/0 c*n/igurati*n settings via t(e
ial)lan *r )erHcall *)erati*ns.
"arameter 7e!tion De+inition Aalues De+ault
ecm general 9rr*r ;*rrecti*n "*e >9;"@ /*r :.,%% /a3 sessi*ns 0es R n* 0es
minrate general "inimum /a3 transmissi*n rate &400 R 4800 R ,&00 R D600 R %&&00 R %4400 &400
ma3rate general "a3imum /a3 transmissi*n rate &400 R 4800 R ,&00 R D600 R %&&00 R %4400 %4400
r3t3a))names general
Use N63+A?OAO'3+A?O a))licati*n names instea */
N6eceive+A?OAO!en+A?O /*r t(e %.4 versi*n */ resB/a3.
0es R n* n*
statusevents general
9na#le re)*rting */ /a3 transmissi*n status events t*
manager sessi*ns 1it( LcallL class )ermissi*ns
0es R n* n*
Digium, n!. "age 2*

*.* resC+axCdigium.!on+
'(e resB/a3Bigium.c*n/ /ile is *)ti*nal an 1ill su))*rt t(e c*n/igurati*n *)ti*n>s@ liste in
t(e ta#le #el*1. I/ t(e resB/a3Bigium.c*n/ is n*t /*un at m*ule l*a time, c*m)ileHtime
e/aults 1ill #e use. '(e resB/a3Bigium m*ule reas t(e )general* secti*n */
resB/a3Bigium.c*n/. In aiti*n t* t(e c*n/igurati*n /ile, re/er t* secti*n '.&.& /*r 1a0s t*
m*i/0 c*n/igurati*n settings via t(e ial)lan *r )erHcall *)erati*ns.
"arameter 7e!tion De+inition Aalues De+ault
ma3ela0 general
"a3imum e3)ecte '.38 ela0 is a measure in
millisec*ns an is use t* etermine t(e e/ault siJe */
'.38 )ac5ets sent t*A/r*m t(e /a3 stac5
EintF 800
6ote& '(e ma3ela0 '.38Ha//ecting )arameter liste in t(e ta#le a#*ve is n*t availa#le
in t(e 7)en !*urce Asteris5 %.4 releases. It is availa#le in t(e 7)en !*urce Asteris5
%.6 >an later@ releases.
*., #om%ati.ilit3 (it$ 7%anD7"
9//*rts 1ere ta5en t* ma5e resB/a3 #ac51ars c*m)ati#le 1it( )revi*us Asteris5 /a3
a))licati*ns #ase *n !)anD!=. !ecti*ns A." an A.' )r*vie in/*rmati*n t(at ma0 (el) a
!)anD!=H#ase /a3 user m*ve t* resB/a3, *r vice versa.
Digium, n!. "age 2,

#$a%ter ,& -rou.les$ooting
'(is c(a)ter )r*vies vari*us met(*s /*r *#taining t(e necessar0 in/*rmati*n t*
tr*u#les(**t m*st )r*#lems relating t* DigiumLs +a3 +*r Asteris5. "ulti)le res*urces are
availa#le t* *#tain m*re in/*rmati*n a#*ut Asteris5 an Digium )r*ucts. '(ese res*urces
are liste *n )age 4&.
,.1 Manager 0vents
'(e /a3 m*ules are ca)a#le */ sening vari*us t0)es */ manager events t* manager
sessi*ns t(at are ca)a#le */ receiving .A// class manager events. '(e manager events
liste #el*1 are sent #0 t(e /a3 m*ules an etaile in t(is secti*n.
+a3 'ransmissi*n ;*m)leti*n 9vents
+a3 !tatus 9vents
'.38 +a3 !tatus 9vents
+a3 D*cument !tatus 9vents
,.1.1 Fax -ransmission #om%letion 0vents
7ne /a3 transmissi*n c*m)leti*n event is al1a0s sent at t(e en */ eac( /a3 transmissi*n,
regarless */ t(e *utc*me */ t(e /a3 attem)t. An e3am)le !en+A? transmissi*n c*m)leti*n
manager event is liste #el*1.
SendFAX "
Channel: @channel.
Exten: @extension.
CallerID: @caller identi!ication.
RemoteStationID: @remote station identi!ication.
LocalStationID: @local station identi!ication.
PagesTransferred: @pages trans!erred.
Resolution: @negotiated resolution.
TransferRate: @negotiated rate.
Digium, n!. "age 2/

FileName:" @!ilename.
6ote& '(e 6eceive+A? event is ientical, e3ce)t /*r t(e event name.
,.1.2 Fax 7tatus 0vents
+a3 status events are sent t* manager sessi*ns 1(en t(e statuse%ents c*n/igurati*n /ile
*)ti*n is ena#le. 8el*1 is an e3am)le !en+A? status message.
SendFAXStatus "
Status: @status.
Channel: @channel.
Exten: @extension.
CallerID: @caller identi!ication.
LocalStationID: @local station identi!ication.
FileName: @!ile.
6ote& '(e 6eceive+A?!tatus event is ientical, e3ce)t /*r t(e event name.
A escri)ti*n */ t(e status messages an message )ur)*se is liste #el*1.
Allo!ating Resour!es K !tatus message sent )ri*r t* t(e creati*n */ t(e /a3 sessi*n.
6o Availa.le Resour!e K !tatus message sent i/ t(e s0stem /aile t* create a /a3
sessi*n. =*ssi#le reas*ns /*r t(is message 1*ul #e$
%. 6e2uest t* create /a3 sessi*n e3cees t(e ma3imum num#er */ license /a3
c(annels.
&. N* /a3 tec(n*l*g0 m*ule registere 1it( resB/a3 (as t(e re2uire ca)a#ilities t*
/ul/ill t(e /a3 sessi*n re2uest.
3. !0stem res*urce limitati*ns )revente t(e all*cati*n */ s0stem res*urces.
6egotiating -.*4 K !tatus message inicating a re2uest t* neg*tiate '.38 (as #een
sent /r*m t(e /a3 a))licati*n t* t(e c(annel river. I/ a c(annel river cann*t su))*rt
'.38, t(is re2uest 1ill #e ign*re an n* event 1ill #e returne t* t(e a))licati*n. -$is
message is not used (it$ t$e '%en 7our!e Asterisk 1., releases.
Digium, n!. "age 26

-.*4 6egotiated K !tatus message inicating a success/ul neg*tiati*n */ '.38 an t(e
creati*n */ a '.38Hca)a#le /a3 sessi*n. -$is message is not used (it$ t$e '%en
7our!e Asterisk 1., releases.
7tarting Fax -ransmission K !tatus message inicating t(at success/ul initiati*n */
t(e /a3 sessi*n. N* m*re LstatusL messages 1ill #e sent /*r t(e remainer */ t(e /a3
transmissi*n, #ut a c*m)leti*n event is al1a0s sent t* manager sessi*ns regarless */
t(e statuse%ents c*n/igurati*n *)ti*n.
,.1.* -.*4 Fax 7tatus 0vents
'.38 /a3 status events are sent t* manager sessi*ns 1(en t(e LL e#ug a))licati*n argument
is s)eci/ie. '.38 +a3 !tatus 9vents are n*t su))*rte 1it( t(e 7)en !*urce Asteris5 %.4
releases. 8el*1 is an e3am)le '.38 /a3 status event.
T!FaxStatus "
Channel: @channel.
Fax Session: @!ax session identi!ication.
#ax Lag: @max lag in ms.
Total Lag: @total lag in ms.
A$erage Lag: @a(erage lag.
Total E$ents: @total 4.38 e(ents.
T! Session Duration: @session duration in sec.
T! Pac%ets Sent: @num pac&ets sent.
T! &ctets Sent: @num octets sent.
A$erage Tx Data Rate: @a(erage rate.
T! Pac%ets Recei$ed: @num pac&ets recei(ed.
T! &ctets Recei$ed: @num octets recei(ed.
A$erage Rx Data Rate: @a(erage recei(ed.
'itter (uffer &$erflo)s: @o(er!lows.
#inimum 'itter S*ace: @min bu!!er space.
+nreco$ered Pac%ets: @unreco(ered pac&ets.
Digium, n!. "age 27

,.1., Fax Do!ument 7tatus 0vents
+a3 *cument status events are sent t* manager sessi*ns 1(en t(e LL e#ug a))licati*n
argument is s)eci/ie. 8el*1 is an e3am)le */ a /a3 *cument status event.
FaxDocumentStatus "
Channel: @channel.
Fax Session: @!ax session identi!ication.
Document Num,er: @doc number.
Processed Status: @status.
Last Error: @last error.
Page Count: @page count.
Start Page: @start page.
Last Page Processed: @last page.
Retransmission Count: @retransmission count.
Local NSF Length: @local 932 length.
Remote NSF Length: @remote 932 length.
Transfer PELS: @trans!er pels.
Transfer Rate: @rate.
Transfer Duration: @duration.
(ad Line Count: @bad lines.
Document Time: @document time.
Local SID: @local 3-7.
Local NSF: @local 932.
Local DIS: @local 7-3.
Remote SID: @remote 3-7.
Remote NSF: @remote 932.
Remote DIS: @remote 7-3.
Digium, n!. "age 24

,.2 Manager A!tions
'(e manager acti*ns liste #el*1 are )r*vie #0 t(e /a3 m*ules an etaile in t(is
secti*n.
+a3LicenseList
+a3License!tatus
,.2.1 Fax9i!ense9ist A!tion
Issuing t(e +a3LicenseList A"I acti*n 1ill is)la0 all +a3 +*r Asteris5 licenses an t(eir
l*aing status. 8el*1 is an e3am)le manager acti*n using +a3LicenseList.
Action: 2ax,icense,ist
Res*onse: 3uccess
#essage: ,icense list will !ollow
E$ent: 2ax,icense
File: 25>-;>58:,;#.lic
-e.: 25>-;>58:,;#
Product: 6;325>
/ost0ID: ex:am:pl:e0:ex:am:pl:e0:ex:am:pl:e0:ex:am:pl:e0:ex:am:pl:e0
Ports: 200
Status: %H
E$ent: 2ax,icense,ist complete
,.2.2 Fax9i!ense7tatus A!tion
Issuing t(e +a3License!tatus A"I acti*n 1ill is)la0 +a3 +*r Asteris5 license utiliJati*n.
8el*1 is an e3am)le manager acti*n using +a3License!tatus.
Action: 2ax,icense3tatus
Res*onse: 3uccess
PortsLicensed: 200
Digium, n!. "age 2)

,.* FA>'"-=error? Aalues
+A?7='>err*r@ )r*vies an inicati*n as t* 1(0 a /a3 sessi*n /aile. A list */ )*ssi#le
+A?7='>err*r@ values is )r*vie #el*1.
0rror Des!ri%tion Module
+IL9B96676 9rr*r reaing 'I++ /ile resB/a3
INI'B96676 9rr*r starting /a3 sessi*n resB/a3
INCALIDBA6:U"9N'! Invali a))licati*n arguments resB/a3
"9"76MB96676 9rr*r all*cating mem*r0 resB/a3
'38BN9:B96676 9rr*r neg*tiating '.38 resB/a3
36DBDI!B69;9IC9D 6eceive a 3r DI! /rame, rem*te en canLt (ear us resB/a3Bigium
36DB+6"B;H9;SB96676 3
r
/rame c(ec5 err*r 1it(*ut g** /rame resB/a3Bigium
36DB'&B'I"97U' 3r time*ut *n 7) Alert resB/a3Bigium
8ADB+IL9B+76"A' +ile 2ueue /*r transmit 1as n*t in 'I++H+ /*rmat resB/a3Bigium
;AN;9L9D !essi*n cancele #0 a))licati*n resB/a3Bigium
;';B+AILU69 7)erati*n st*))e ue t* e3cessive 9;" retransmissi*ns resB/a3Bigium
D;!B+67"BDI!B+AIL9D Cali D;! c*ul n*t #e c*nstructe /r*m DI! *r D'; resB/a3Bigium
D7;B"I!!IN: D*cument 1as missing 1(en transmissi*n 1as attem)te resB/a3Bigium
9;"B+AIL =r*#lem in 9;" )ac5et resB/a3Bigium
9;"B:9'B8U++96B96676 9;" err*r getting transmit #u//er resB/a3Bigium
9;"B"7D9BINCALID Invali 9;" m*e resB/a3Bigium
9N;7DIN:BINCALID Invali enc*ing resB/a3Bigium
9N;7DIN:B"I!"A';H +aile ue t* mismatc( in image enc*ing resB/a3Bigium
+IL9B97+ Une3)ecte en */ /ile 1as enc*untere resB/a3Bigium
+IL9BI7B+AIL IA7 err*r reaingA1riting a *cument resB/a3Bigium
H!B6?B+AIL H! "*em receive starte #ut i n*t c*m)lete resB/a3Bigium
H!B'?B+AIL H! "*em transmit /aile t* c*m)lete resB/a3Bigium
HWB+AIL Uns)eci/ic (ar1are /ailure resB/a3Bigium
HWBINI'B+AIL "*em c*ul n*t #e initialiJe resB/a3Bigium
IN'96NALB+AILU69 Internal /ailure timer e3)ire. '0)icall0, a result */ (ar1are /ailure. resB/a3Bigium
INCLDB;';B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDB;'6B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDBD;! D;! i n*t matc( values in DI! resB/a3Bigium
INCLDBDI! 6eceive DI!AD'; 1as invali resB/a3Bigium
Digium, n!. "age *0

INCLDB976B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDBN!? 6ec*gniJe N!+AN!!AN!; 1as invali resB/a3Bigium
INCLDB="; InvaliAUnrec*gniJe =*st "essage ;*mman resB/a3Bigium
INCLDB="6 Invali =*st "essage 6es)*nse 1as receive resB/a3Bigium
INCLDB==!B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDB6"'BID +aile ue t* missing ID /r*m rem*te resB/a3Bigium
INCLDB6N6B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDB66B69!=7N!9 Invali res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e rem*te evice is *ut */ s0nc. resB/a3Bigium
INCLDB'6AINB69!= :*t invali /rame in res)*nse t* ';+ resB/a3Bigium
L7!!B7+BH!B!MN; N* vali 97L 1as etecte /*r 5 sec*ns sessi*n isc*nnecte resB/a3Bigium
"7D9"B"I!"A';H +aile ue t* mismatc( in availa#le m*ems resB/a3Bigium
"7D9"B6A'9BINCALID Invali m*em rate resB/a3Bigium
N7B;A66I96 N* /a3 signal 1as etect /*r '% sec*ns resB/a3Bigium
N7B;';B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7B;'6B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7BD;NBA+'96B97= !essi*n c*m)lete t(ru 97=H";+, #ut n* D;N resB/a3Bigium
N7BDI!BD'; ;arrier 1as etecte #ut n* DI! *r D'; resB/a3Bigium
N7B976B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7B96676 N* err*r *ccurre resB/a3Bigium
N7B"9"76M +aile 1(en attem)ting t* all*cate mem*r0 resB/a3Bigium
N7B="; N* =*st "essage ;*mman receive resB/a3Bigium
N7B="6 N* =*st "essage 6es)*nse receive resB/a3Bigium
N7B==!B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7B6N6B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7B66B69!=7N!9 N* res)*nse t* s)eci/ic /rame t0)e. In m*st cases, t(e *t(er en isc*nnecte. resB/a3Bigium
N7B'6AINB69!= 6eceive n* res)*nse t* t(e ';+ resB/a3Bigium
7=96A'I7NB"I!"A';H Neit(er '? *r 6? 1as )*ssi#le resB/a3Bigium
7=96A'76BIN'96U=' !essi*n st*))e /*r *)erati*n interru)t resB/a3Bigium
7U'B7+B6A'9! +ailure t* train at all availa#le rates resB/a3Bigium
=A:9B!IT9BINCALID Invali )age siJe resB/a3Bigium
=A:9B!IT9B"I!"A';H +aile ue t* mismatc( in )age siJe resB/a3Bigium
=6IBN7B69!=7N!9 =6IH33 i n*t receive res)*nse a/ter 3 tries resB/a3Bigium
69;76DBL9NBINCALID Invali rec*r lengt( resB/a3Bigium
69"7'9BDI!;7NN9;' 6em*te en isc*nnecte resB/a3Bigium
69!7LU'I7NBINCALID Invali res*luti*n resB/a3Bigium
69!7LU'I7NB"I!"A';H +aile ue t* mismatc( in res*luti*ns resB/a3Bigium
6?B7=9NB+AIL ;*ul n*t *)en *cument /ile /*r receiving resB/a3Bigium
'%B'I"97U' +a3 signals 1(ere )resent, #ut invali resB/a3Bigium
'&B'I"97U' 'ime*ut *n 7) Alert resB/a3Bigium
'5B9?=I69D 6eceiver /aile t* #ec*me rea0 #e/*re '5 resB/a3Bigium
Digium, n!. "age *1

'I7B9A6LMB97+ 'I++ /ile ene earl0, ening )age n*t /*un resB/a3Bigium
'I7B:9N96ALB96676 Uns)eci/ie 'I7 err*r resB/a3Bigium
'I7B=A:9BN7'B+7UND !tarting )age n*t /*un in 'I++ resB/a3Bigium
'6AINB+AIL9D 'rain 1as attem)te at all availa#le s)ees an 1as n*t acce)ta#le resB/a3Bigium
UN9?=9;'9DB;7NDI'I7N Une3)ecte c*niti*n resB/a3Bigium
C&%B6?B+AIL C&% 6eceive starte, #ut i n*t c*m)lete resB/a3Bigium
C&%B'?B+AIL C&% 'ransmissi*n /aile resB/a3Bigium
Digium, n!. "age *2

,., Asterisk #ommand 9ine nter+a!e =#9?
'(e Asteris5 ;LI )r*vies t(e *)erati*ns in t(e list #el*1$
/a3 set e#ug *n
/a3 set e#ug *//
/a3 set g,%%ca) *//
/a3 set g,%%ca) *n
/a3 set t38ca) *//
/a3 set t38ca) *n
/a3 s(*1 ca)a#ilities
/a3 s(*1 (*sti
/a3 s(*1 licenses
/a3 s(*1 sessi*n EiF
/a3 s(*1 sessi*ns
/a3 s(*1 settings
/a3 s(*1 stats
/a3 s(*1 versi*n
,.,.1 +ax set de.ug on
'(is ;LI *)erati*n ena#les /a3 e#ugging *n all sessi*ns create a/ter t(is *)erati*n is use.
!essi*ns t(at are alrea0 active 1(en t(is ;LI *)erati*n 1as e3ecute 1ill n*t (ave
e#ugging ena#le unless t(e LL a))licati*n argument 1as use. +a3 e#ugging results in
t(e e3tra manager events escri#e in secti*n +.&.
'(e resB/a3Bigium m*ule l*gs granular /a3 events 1(en s0stem ver#*sit0 is greater t(an
L4L.
:.,%% +a3 sessi*ns 1ill als* (ave /rame )a0l*as scanne /*r silenceAenerg0 in t(e irecti*n
*/ c(annelHt*Hstac5 an stac5Ht*Hc(annel. '(is *ut)ut (as #een ver0 use/ul /*r t(e etecti*n
*/ aui* unerruns anA*r ga)s */ silence in t(e aui* stream t(at cause /a3es t* /ail ue t*
Digium, n!. "age **

carrier l*ss. =a0l*a scanning results are *nl0 l*gge 1(en ver#*sit0 is greater t(an L5L.
,.,.2 +ax set de.ug o++
'(is ;LI *)erati*n isa#les /a3 e#ugging *n all sessi*ns create a/ter t(is *)erati*n is
e3ecute. '(e *nl0 sessi*ns t(at 1ill (ave e#ugging ena#le a/ter t(is *)erati*n is e3ecute
are /a3 sessi*ns t(at are starte 1it( t(e LL a))licati*n argument.
,.,.* +ax set g711!a% o++
'(is ;LI *)erati*n isa#les t(e creati*n */ aui* ca)ture /iles /*r :.,%% /a3 sessi*ns.
,.,., +ax set g711!a% on
'(is ;LI *)erati*n ena#les t(e creati*n */ aui* ca)ture /iles /*r :.,%% /a3 sessi*ns. 9ac(
sessi*n 1ill #e st*re in a /ile name 1it( t(e c(annelLs uni2ue ID an l*cate in t(e
Lg,%%ca)L su#irect*r0 */ t(e Asteris5 l*g irect*r0 >set via astl*gir in asteris5.c*n/@. '(e /ile
1ill #e a stere* WAC /ile in signe linear >8 SHJ sam)le rate, %6H#it sam)les@ 1it( t(e le/t
c(annel #eing t(e aui* /r*m t(e rem*te en)*int an t(e rig(t c(annel #eing t(e aui* /r*m
Asteris5.
,.,./ +ax set t*4!a% o++
'(is ;LI *)erati*n isa#les t(e creati*n */ )ac5et ca)ture /iles /*r '.38 /a3 sessi*ns.
,.,.6 +ax set t*4!a% on
'(is ;LI *)erati*n ena#les t(e creati*n */ )ac5et ca)ture /iles '.38 /a3 sessi*ns. 9ac(
sessi*n 1ill #e st*re in a /ile name 1it( t(e c(annelLs uni2ue ID an l*cate in t(e Lt38ca)L
su#irect*r0 */ t(e Asteris5 l*g irect*r0 >set via astl*gir in asteris5.c*n/@. '(e )ac5ets in t(e
ca)ture /ile 1ill a))ear t* #e #et1een t1* en)*ints at t(e I= aress %&,.0.0.%, 1it( )ac5ets
/r*m t(e rem*te en)*int sent t* Asteris5 *riginating /r*m )*rt L%L an )ac5ets /r*m Asteris5
*riginating /r*m )*rt L&L.
,.,.7 +ax s$o( !a%a.ilities
'(is ;LI *)erati*n is)la0s t(e N'0)eO an NDescri)ti*nO /*r all registere /a3 tec(n*l*g0
m*ules 1(en t(is *)erati*n is e3ecute.
Digium, n!. "age *,

,.,.4 +ax s$o( $ostid
'(is ;LI *)erati*n is)la0s t(e +a3 +*r Asteris5 H*stHID.
,.,.) +ax s$o( li!enses
'(is ;LI *)erati*n is)la0s t(e +a3 +*r Asteris5 licensing in/*rmati*n.
,.,.10 +ax s$o( session DidE
'(is ;LI *)erati*n is)la0s etaile in/*rmati*n a#*ut a /a3 sessi*n ienti/ie #0 its /a3
sessi*n i.
,.,.11 +ax s$o( sessions
'(is ;LI *)erati*n is)la0s #asic in/*rmati*n a#*ut all t(e current /a3 sessi*ns. '(is #asis
in/*rmati*n inclues t(e c(annel, tec(n*l*g0 t0)e, +a3 ID, /a3 t0)e, *)erati*n m*e, current
state, an /ilename>s@ /*r eac( /a3 sessi*n.
,.,.12 +ax s$o( settings
'(is ;LI *)erati*n is)la0s t(e gl*#al settings an e/aults */ #*t( t(e +a3 c*re an
tec(n*l*g0 m*ules.
,.,.1* +ax s$o( stats
'(is ;LI *)erati*n is)la0s general statistics a#*ut /a3 attem)ts, successes, an /ailures. All
statistics are rec*re /r*m t(e last time t(e +a3 +*r Asteris5 m*ules 1ere l*ae.
'(e /irst secti*n */ *ut)ut /r*m fax show stats re)*rts t(e /*ll*1ing statistics.
#urrent 7essions K t(e num#er */ active /a3 sessi*ns
Re!eive Attem%ts K t(e num#er */ receive attem)ts
-ransmit Attem%ts K t(e num#er */ transmit attem)ts
#om%leted Faxes K t(e num#er */ /a3 sessi*ns t(at 1ere c*m)lete >#*t( success/ul
an /aile sessi*ns@
Failed Faxes K t(e num#er */ /a3es t(at /aile
Digium, n!. "age */

'(e ne3t t1* secti*ns */ *ut)ut /r*m fax show stats re)*rt t(e same set */ statistics /*r :.,%%
/a3es an '.38 /a3es res)ectivel0. '(ese statistics etail a c*unt /*r t(e /*ll*1ing escri#e
metrics.
9i!ensed #$annels K t(e num#er */ c(annels /*r 1(ic( a license is installe *n t(is
s0stem
Max #on!urrent K t(e (ig(est num#er */ c*ncurrent /a3es t(at (ave e3iste since t(e
last time t(e m*ule 1as l*ae
7u!!ess K t(e num#er */ success/ul /a3es
7(it!$ed to -.*4 K t(e num#er */ /a3es t(at (ave s1itc(e t* '.38 m*e /r*m :.,%%
m*e >*nl0 e3ists /*r :.,%% /a3es@
#an!eled K t(e num#er */ /a3es t(at (ave #een cancele >n*t currentl0 use@
6o Fax K t(e num#er */ times t(at n* /a3 1as seen 1(ile attem)ting t* receive a /a3
"artial K t(e num#er */ /a3es t(at trans/erre s*me ata, #ut /aile 1(ile sening *r
receiving
6egotiation Failed K t(e num#er */ times t(at a /a3 trans/er c*ul n*t #e neg*tiate
-rain Failure K t(e num#er */ times t(at a /a3 /aile t* train >usuall0 cause #0 )**r
line c*niti*ns@
"roto!ol 0rror K t(e num#er */ times a /a3 )r*t*c*l err*r *ccurre an n* ata 1as
trans/erre
' "artial K t(e num#er */ times t(at a given 'I++ /ile i n*t c*ntain t(e s)eci/ie
num#er */ )ages, #ut t(e )ages t(at 1ere /*un 1ere sent
' Fail K t(e num#er */ times t(at t(ere 1as a )r*#lem reaing a given 'I++ /ile
,.,.1, +ax s$o( version
'(is ;LI *)erati*n is)la0s t(e versi*n */ t(e /a3 m*ules 1(ic( are l*ae.
Digium, n!. "age *6

,./ FreBuentl3 Asked Fuestions
'(is secti*n )r*vies /re2uentl0 as5e 2uesti*ns an res*luti*ns as ienti/ie #0 Digium
'ec(nical !u))*rt an 9ngineering.
Are multi-%age +axes su%%orted +or send and re!eive<
Mes, multiH)age /a3es are su))*rte /*r sen an receive. A stanars c*m)liant >6+;H&306@
multiH)age 'I++ 1ill #e generate 1(en a /a3 1it( multi)le )ages is receive using
6eceive+A?.
:$i!$ !on+iguration +iles must .e modi+ied<
'(e AetcAasteris5AresB/a3.c*n/ an AetcAasteris5AresB/a3Bigium.c*n/ are *)ti*nal c*n/igurati*n
/iles. '(e0 *nl0 nees t* #e use 1(en t(e c*m)ileHtime e/ault settings nee t* #e c(ange.
'(e AetcAasteris5Ac(anBa(i.c*n/ /ile nees t* #e m*i/ie i/ faxdetect /uncti*nalit0 is
re2uire.
'(e AetcAasteris5Asi).c*n/ /ile s(*ul #e m*i/ie t* ena#le '.38 *r faxdetect /uncti*nalit0. '*
ena#le '.38 su))*rt, unc*mment 0t'1pt_udptl , yes0. '* ena#le faxdetect /uncti*nalit0,
unc*mment 0faxdetect , yes0.
6ote& !I= faxdetect /uncti*nalit0 is availa#le *nl0 in Asteris5 %.6 an later.
'* m*i/0 UD='L settings >use in '.38 neg*tiati*n@, m*i/0 t(e AetcAasteris5Au)tl.c*n/ /ile.
7$ould add a load line +or resC+ax and@or resC+axCdigium to m3
@et!@asterisk@modules.!on+ +ile<
It is n*t re2uire *r rec*mmene t* s)eci/0 a l*a line in t(e AetcAasteris5Am*ules.c*n/ /*r
t(e resB/a3.s* *r resB/a3Bigium.s* /iles. Asteris5 1ill aut*maticall0 l*a t(em using t(e
aut*l*a *)ti*n. '(e aut*l*a *)ti*n is ena#le #0 e/ault.
:$ere !an +ind kno(ledge .ase arti!les +or Fax For Asterisk<
=lease visit t(e +a3 +*r Asteris5 categ*r0 */ t(e Digium Sn*1lege 8ase$
http://kb.digium.com/2.ategory34,"$'
Digium, n!. "age *7

:$3 !anGt send or re!eive -.*4 +axes using t$e resC+ax modules (it$ an '%en 7our!e
Asterisk 1., release<
'(e 7)en !*urce Asteris5 %.4 releases * n*t su))*rt '.38 'erminati*n. I/ 0*u nee '.38
'erminati*n su))*rt 1it( an 7)en !*urce Asteris5 release, 0*u must use an 7)en !*urce
Asteris5 %.6 >*r later@ release.
+ am using an '%en 7our!e Asterisk 1., release, ($i!$ version o+ '%en 7our!e
Asterisk is re!ommended<
Digium rec*mmens using 7)en !*urce Asteris5 %.4.&& *r ne1er. Cersi*ns )ri*r t* %.4.&&
(ave n*t #een teste.
+ am +axing over -DM, ($i!$ version o+ DA8D is re!ommended<
Digium rec*mmens using DAHDI &.%.0.3 *r ne1er. Cersi*ns )ri*r t* &.%.0.3 (ave n*t #een
teste.
:$at are t$e !om%ati.ilit3 di++eren!es .et(een resC+ax and 7%anD7"-.ased modules<
!ee secti*ns A." an A.' /*r m*re in/*rmati*n.
8o( do !reate a -FF +ile<
'(ere are man0 t**ls t* create a 'I++ /ile. 7ne */ t(e m*st c*mm*n is t(e g(*stscri)t utilit0,
availa#le /r*m http://www.ghostscript.com.
Using t(e c*mmanHline g(*stscri)t utilit0, a LetterHsiJe >8.5Q 3 %%Q@ =D+ can #e c*nverte t*
a 'I++ /ile using t(e /*ll*1ing c*mman$
# gs -I -d9%:5J3; -dK54+L -s7;M-+;1ti!!g) -s:5:;63-N;1letter
-s%utput2ile1@dest.ti!!. @src.pd!.
'* create a 'I++ /r*m an A4HsiJe >&%0mm 3 &D,mm@ =D+ /ile, use t(e /*ll*1ing c*mman$
# gs -I -d9%:5J3; -dK54+L -s7;M-+;1ti!!g) -s:5:;63-N;1a)
W(en =D+ /iles are create #0 *cument scanners, t(e0 are s*metimes create 1it( a
largerHt(anHstanar )a)er siJe, e.g. 8.6Q 3 %&Q. In t(ese cases, g(*stscri)t *es n*t aUust
Digium, n!. "age *4

t(e siJe t* a !tanar >Letter *r A4@, even i/ =A=96!IT9 is s)eci/ie. '(is 1ill cause
!en+A? t* /ail 1it( t(e /*ll*1ing err*r$
;66%6A3##06C: res$!ax$digium.c:2##) dgm$!ax$start: 25> handle 0: !ailed to
Iueue document Fdocument nameF
'* )revent t(is, t(e siJe */ t(e 'I++ /ile nees t* #e s)eci/ie in )i3els. '(e /*ll*1ing
c*mman 1ill create 'I++ /iles 1it( a c*rrect 1it( an lengt($
+*r LetterHsiJe )a)er >8.5Q 3 %%Q@$
# gs -I -d9%:5J3; -dK54+L -s7;M-+;1ti!!g) -s:5:;63-N;1letter
-g#=28x2#50 -s%utput2ile1@dest.ti!!. @src.pd!.
+*r A4HsiJe )a)er >&%0mm 3 &D,mm@$
# gs -I -d9%:5J3; -dK54+L -s7;M-+;1ti!!g) -s:5:;63-N;1a) -g#680x2285
6ote& Use */ t(e Hg *)ti*n 1it( =D+ /iles smaller in siJe t(an eit(er Letter *r A4 s(*ul
#e av*ie as its use 1ill enlarge smaller =D+s.
:$3 !anGt send -.*4 +axes<
8e sure t(at 0*u m*i/ie AetcAasteris5Asi).c*n/ an unc*mmente Lt38)tBu)tl V 0esL
#ecause t(is *)ti*n is isa#le #0 e/ault.
:$3 are m3 2.711 +axes getting !an!eled<
80 e/ault, t(e /a3 a))licati*ns set u) :.,%% /a3 sessi*ns. I/ '.38 is neg*tiate uring a
:.,%% /a3 sessi*n, t(e :.,%% /a3 sessi*n 1ill #e cancele an a ne1 '.38 /a3 sessi*n 1ill
ta5e *ver t(e /a3 transmissi*n. '(e *nl0 e3ce)ti*n is 1(en '.38 (as alrea0 #een
success/ull0 neg*tiate #e/*re t(e /a3 a))licati*n is calle #0 Asteris5. In t(is case, a :.,%%
/a3 sessi*n 1ill (ave never #een create an t(e '.38 /a3 sessi*n 1ill *)erate /*r t(e li/e */
t(e /a3 transmissi*n.
:$3 are m3 +axes negotiating -.*4 instead o+ 2.711<
'(ere is n* 1a0 t* /*rce :.,%% 1(en a !I= )eer (as UD='L ena#le an t(e /ar en als*
su))*rts '.38. Asteris5 1ill use '.38 instea */ :.,%% #ecause '.38 is a m*re relia#le /*rm */
c*mmunicati*n. I/ 0*u (ave UD='L ena#le in t(e WgeneralX secti*n */ si).c*n/ an 1ant t*
/*rce :.,%% /*r a s)eci/ic )eer, isa#le UD='L /r*m t(at )eerLs c*nte3t.
Digium, n!. "age *)

:$3 do get H#annot !reate +ax session I session limit ex!eededJ ($en attem%ting
+axes<
M*u (ave e3ceee t(e num#er */ all*1e +a3 c(annels acc*ring t* 0*ur availa#le licenses.
'* )urc(ase aiti*nal c(annel licenses, )lease visit http://www.digium.com.
:$3 do get H'nl3 one Free Fax For Asterisk !$annel is allo(ed. gnoring additional
li!enses.J ($en load resC+axCdigium<
7nl0 *ne +ree +a3 +*r Asteris5 c(annel is all*1e )er s0stem. 7nce a +ree +a3 +*r Asteris5
license is etecte, all su#se2uent +ree +a3 +*r Asteris5 licenses 1ill #e ign*re. All +ree
+a3 +*r Asteris5 licenses are limite t* % c(annel. I/ 0*u nee m*re /a3 c(annels, 0*u must
)urc(ase aiti*nal c(annels /r*m Digium an register t(e )urc(ase +a3 +*r Asteris5 5e0 t*
activate t(e aiti*nal c(annels.
#an t$e a%%C+ax.so and resC+ax.so Asterisk modules .e loaded at t$e same time<
N*. I/ 0*u attem)t t* l*a #*t( */ t(em at t(e same time, Asteris5 1ill re)*rt t(e /*ll*1ing$
O569-9<A>>>>>C: pbx.c:>>>> ast$register$application2: 5lread ha(e an
application F3end25>F
O569-9<A>>>>>C: pbx.c:>>>> ast$register$application2: 5lread ha(e an
application F6ecei(e25>F
'(e rec*mmene s*luti*n /*r t(is )r*#lem is t* eit t(e /etc/asterisk/mdoules.conf /ile t*
e3)licitl0 )revent t(e a))B/a3.s* Asteris5 m*ule /r*m l*aing. An e3am)le is )r*vie #el*1.
noload 1. app$!ax.so
M3 resC+axCdigium.so +ails to load (it$ K0rror loading module GresC+axCdigium.soG&
@usr@li.@asterisk@modules@resC+axCdigium.so& !annot restore segment %rot a+ter relo!&
"ermission deniedK. 8o( do resolve t$is<
Disa#le !9Linu3 using t(e ste)s #el*1.
%. 9it t(e /etc/selinux/config /ile.
&. !et !9LINU?Visa#le.
3. 6e#**t.
Digium, n!. "age ,0

:$at details s$ould su.mit to -e!$ni!al 7u%%ort ($en am $aving +ax %ro.lems<
!u))*rt is *nl0 )r*vie /*r cust*mers */ +a3 +*r Asteris5.
+*r :.,%% /a3 issues, )er/*rm t(e /*ll*1ing ste)s$
%. At t(e Asteris5 ;LI, t0)e N/a3 set e#ug *nO.
&. At t(e Asteris5 ;LI, t0)e Nc*re set ver#*se 6O. Cer#*sit0 can #e 6 *r (ig(er.
3. At t(e Asteris5 ;LI, t0)e N/a3 s(*1 settingsO.
4. At t(e Asteris5 ;LI, t0)e N/a3 s(*1 versi*nO.
5. At a c*mman )r*m)t, t0)e Na(iBm*nit*r Ec(annelF Hr Er3 aui* /ileF Ht Et3 aui*FO.
6. 6eirect a manager sessi*n >1it( call class )ermissi*ns@ t* a /ile.
,. 6e)r*uce t(e issue.
8. !u#mit Asteris5 ;LI *ut)ut, a(iBm*nit*r rec*rings, an manager sessi*n *ut)ut t*
!u))*rt.
+*r '.38 /a3 issues, )er/*rm t(e /*ll*1ing ste)s$
%. At t(e Asteris5 ;LI, t0)e N/a3 set e#ug *nO.
&. At t(e Asteris5 ;LI, t0)e Nc*re set ver#*se 6O. Cer#*sit0 can #e 6 *r (ig(er.
3. At t(e Asteris5 ;LI, t0)e N/a3 s(*1 settingsO.
4. At t(e Asteris5 ;LI, t0)e N/a3 s(*1 versi*nO.
5. 6eirect a manager sessi*n >1it( call class )ermissi*ns@ t* a /ile.
6. 6e)r*uce t(e issue.
,. !u#mit Asteris5 ;LI an manager sessi*n *ut)ut t* !u))*rt.
Digium, n!. "age ,1

:$ere !an !ustomers o+ Fax For Asterisk +ind ans(ers to additional Buestions<
'(ere are several )laces t* in2uire /*r m*re in/*rmati*n a#*ut Asteris5 Digium )r*ucts$
Digium 'ec(nical !u))*rt >Y%.&56.4&8.6%6%@, *r '*ll +ree in t(e U.!. >%.8,,.344.486%@, is
availa#le ,amH8)m ;entral 'ime >:"' H6@, "*na0 H +ria0.
Asteris5 users mailing list >www.asterisk.org, lists.digium.com@
I6; c(annel Lasterisk *n >irc./reen*e.net@
7u.s!ri%tion 7ervi!es "rogram
Digium is eicate t* su))*rting 0*ur Asteris5 s0stem #0 *//ering /ull tec(nical su))*rt
t(r*ug( *ur !u#scri)ti*n !ervices =r*gram. '(r*ug( t(is )r*gram, 0*u can #e at ease
5n*1ing t(at 0*ur #usiness 1ill al1a0s (ave access t* t(e Asteris5 e3)erts. =ricing *n
!u#scri)ti*n !ervices ma0 #e *#taine /r*m 0*ur nearest reseller *r 0*u ma0 call Digium
!ales /*r re/erral t* 0*ur nearest reseller at Y%.&56.4&8.6000 *r eHmail salesZigium.c*m.
Digium, n!. "age ,2

A%%endix A& Dial%lan 0xam%les
A.1 7im%le Fax -ransmit @ Re!eive
'(e /*ll*1ing is a ial)lan e3am)le /*r a sim)le /a3 transmit an receive.
A!ax-rxC
exten 1. recei(eD#D9o%p?**** 25> 6;+;-M; ****E
exten 1. recei(eDnD3et?<,%K5,?25>+%J94E1PA PQ<,%K5,?25>+%J94ER S # CE
exten 1. recei(eDnD3et?25>+%J941PQ<,%K5,?25>+%J94ERE
exten 1. recei(eDnD3et?25>2-,;1!ax-PQ25>+%J94R-rx.ti!E
exten 1. recei(eDnD3et?<,%K5,?,53425>+5,,;69J8E1PQ+5,,;6-7?numERE
exten 1. recei(eDnD3et?<,%K5,?,53425>+5,,;6958;E1PQ+5,,;6-7?nameERE
exten 1. recei(eDnD9o%p?**** 3;44-9< 25>%:4 ****E
exten 1. recei(eDnD3et?25>%:4?ecmE1esE
exten 1. recei(eDnD3et?25>%:4?headerin!oE18T 25>K5+H 6>E
exten 1. recei(eDnD3et?25>%:4?localstationidE1#23)56=8U0E
exten 1. recei(eDnD3et?25>%:4?maxrateE1#))00E
exten 1. recei(eDnD3et?25>%:4?minrateE12)00E
exten 1. recei(eDnD9o%p?25>%:4?ecmE : PQ25>%:4?ecmERE
exten 1. recei(eDnD9o%p?25>%:4?headerin!oE : PQ25>%:4?headerin!oERE
exten 1. recei(eDnD9o%p?25>%:4?localstationidE : PQ25>%:4?localstationidERE
exten 1. recei(eDnD9o%p?25>%:4?maxrateE : PQ25>%:4?maxrateERE
exten 1. recei(eDnD9o%p?25>%:4?minrateE : PQ25>%:4?minrateERE
exten 1. recei(eDnD9o%p?**** 6;+;-M-9< 25> : PQ25>2-,;R ****E
exten 1. recei(eDnD6ecei(e25>?/home/dwane/!axin/PQ25>2-,;RE
V LangupW :rint 25>%:4s
exten 1. hD#D9o%p?25>%:4?ecmE : PQ25>%:4?ecmERE
exten 1. hDnD9o%p?25>%:4?!ilenameE : PQ25>%:4?!ilenameERE
exten 1. hDnD9o%p?25>%:4?headerin!oE : PQ25>%:4?headerin!oERE
exten 1. hDnD9o%p?25>%:4?localstationidE : PQ25>%:4?localstationidERE
exten 1. hDnD9o%p?25>%:4?maxrateE : PQ25>%:4?maxrateERE
exten 1. hDnD9o%p?25>%:4?minrateE : PQ25>%:4?minrateERE
exten 1. hDnD9o%p?25>%:4?pagesE : PQ25>%:4?pagesERE
exten 1. hDnD9o%p?25>%:4?rateE : PQ25>%:4?rateERE
exten 1. hDnD9o%p?25>%:4?remotestationidE : PQ25>%:4?remotestationidERE
exten 1. hDnD9o%p?25>%:4?resolutionE : PQ25>%:4?resolutionERE
Digium, n!. "age ,*

exten 1. hDnD9o%p?25>%:4?statusE : PQ25>%:4?statusERE
exten 1. hDnD9o%p?25>%:4?statusstrE : PQ25>%:4?statusstrERE
exten 1. hDnD9o%p?25>%:4?errorE : PQ25>%:4?errorERE
A!ax-txC
exten 1. sendD#D9o%p?**** 3;97-9< 25> ****E
exten 1. sendDnDOait?6E
exten 1. sendDnD3et?<,%K5,?25>+%J94E1PA PQ<,%K5,?25>+%J94ER S # CE
exten 1. sendDnD3et?25>+%J941PQ<,%K5,?25>+%J94ERE
exten 1. sendDnD3et?25>2-,;1dw-!axout.ti!E
V 3et 25>%:4s
exten 1. sendDnD9o%p?**** 3;44-9< 25>%:4 ****E
exten 1. sendDnD3et?25>%:4?ecmE1esE
exten 1. sendDnD3et?25>%:4?headerin!oE12ax !rom P
Q<,%K5,?,53425>+5,,;6958;ER at PQ<,%K5,?,53425>+5,,;69J8ER was recei(ed.E
exten 1. sendDnD3et?25>%:4?localstationidE1#23)56=8U0E
exten 1. sendDnD3et?25>%:4?maxrateE1#))00E
exten 1. sendDnD3et?25>%:4?minrateE12)00E
V 3end the !ax
exten 1. sendDnD9o%p?**** 3;97-9< 25> : PQ25>2-,;R ****E
exten 1. sendDnD3end25>?/home/dwane/!axout/PQ25>2-,;RDdE
V LangupW :rint 25>%:4s
exten 1. hD#D9o%p?25>%:4?ecmE : PQ25>%:4?ecmERE
exten 1. hDnD9o%p?25>%:4?!ilenameE : PQ25>%:4?!ilenameERE
exten 1. hDnD9o%p?25>%:4?headerin!oE : PQ25>%:4?headerin!oERE
exten 1. hDnD9o%p?25>%:4?localstationidE : PQ25>%:4?localstationidERE
exten 1. hDnD9o%p?25>%:4?maxrateE : PQ25>%:4?maxrateERE
exten 1. hDnD9o%p?25>%:4?minrateE : PQ25>%:4?minrateERE
exten 1. hDnD9o%p?25>%:4?pagesE : PQ25>%:4?pagesERE
exten 1. hDnD9o%p?25>%:4?rateE : PQ25>%:4?rateERE
exten 1. hDnD9o%p?25>%:4?remotestationidE : PQ25>%:4?remotestationidERE
exten 1. hDnD9o%p?25>%:4?resolutionE : PQ25>%:4?resolutionERE
exten 1. hDnD9o%p?25>%:4?errorE : PQ25>%:4?errorERE
Ade!aultC
exten 1. !axD#D9o%p?**** 25> 7;4;+4;7 ****E
exten 1. !axDnD<oto?!ax-rxDrecei(eD#E
A.2 -runk, a%%C+ax, and 7%anD7" 0.0.6
Dial)lan c*m)ati#ilit0 #et1een 7)en !*urce Asteris5 trun5 using resB/a3AresB/a3Bigium an
Digium, n!. "age ,,

a))B/a3A!)anD!=H0.0.6 1as teste using t(e ial)lan #el*1.
n!onsisten!ies .et(een a%%li!ations&
'(e +A?!'A'U!!'6IN: c(annel varia#le is n*t use #0 t(e 7)en !*urce
Asteris5 trun5 a))B/a3 m*ule.
'(e resB/a3AresB/a3Bigium m*ules * n*t currentl0 su))*rt t(e 6eceive+A? LcL
>caller m*e@ *)ti*n an t(e !en+A? LaL >calling m*e@ arguments.
exten 1. #00D#DOait?#E
exten 1. #00DnD5nswer?E
exten 1. #00DnD3et?<,%K5,?25>+%J94E1PA PQ<,%K5,?25>+%J94ER S # CE
exten 1. #00DnD3et?25>+%J941PQ<,%K5,?25>+%J94ERE
exten 1. #00DnD3et?25>2-,;1!ax-PQ25>+%J94R-rx.ti!E
exten 1. #00DnD3et?,%+5,L;57;6-92%16ecei(ing !ax number PQ25>+%J94RE
exten 1. #00DnD3et?,%+5,3454-%9-71PQ25>+%J94RE
exten 1. #00DnD6ecei(e25>?PQ<,%K5,?25>6>7-6ER/PQ25>2-,;RE
exten 1. ###D#DOait?#E
exten 1. ###DnD5nswer?E
exten 1. ###DnD3et?<,%K5,?25>+%J94E1PA PQ<,%K5,?25>+%J94ER S # CE
exten 1. ###DnD3et?25>+%J941PQ<,%K5,?25>+%J94ERE
exten 1. ###DnD3et?,%+5,L;57;6-92%13ending !ax number PQ25>+%J94RE
exten 1. ###DnD3et?,%+5,3454-%9-71PQ25>+%J94RE
exten 1. ###DnD3et?9J8:5<;31PQ6597?#D3ERE
exten 1. ###DnD<oto-!?PAPQ9J8:5<;3R 1 #CXsend#page:E
exten 1. ###DnD<oto-!?PAPQ9J8:5<;3R 1 2CXsend##pages:E
exten 1. ###DnD<oto-!?PAPQ9J8:5<;3R 1 3CXsend20pages:E
exten 1. ###Dn?send20pagesED3et?25>2-,;1PQ<,%K5,?25>20:5<;3ERE
exten 1. ###DnD<oto?senditE
exten 1. ###Dn?send##pagesED3et?25>2-,;1PQ<,%K5,?25>##:5<;3ERE
exten 1. ###DnD<oto?senditE
exten 1. ###Dn?send#pageED3et?25>2-,;1PQ<,%K5,?25>#:5<;ERE
exten 1. ###Dn?senditED3end25>?PQ<,%K5,?25>4>7-6ER/PQ25>2-,;RE
exten 1. hD#D9o%p?2ax3tatus : PQ25>3454J3RE
exten 1. hDnD9o%p?2ax3tatus3tring : PQ25>3454J3346-9<RE
exten 1. hDnD9o%p?2ax;rror : PQ25>;66%6RE
exten 1. hDnD9o%p?6emote3tation-7 : PQ6;8%4;3454-%9-7RE
exten 1. hDnD9o%p?2ax:ages : PQ25>:5<;3RE
exten 1. hDnD9o%p?2axKit6ate : PQ25>K-4654;RE
exten 1. hDnD9o%p?2ax6esolution : PQ25>6;3%,J4-%9RE
Digium, n!. "age ,/

A.* Asterisk 1.,, agx-ast-addons, and 7%anD7" 0.0.,
Dial)lan c*m)ati#ilit0 */ Asteris5 %.4 ial)lans using ag3HastHa*ns 1it( !)anD!= 1as
teste.
n!onsisten!ies .et(een a%%li!ations&
'(e a))Br3/a3 an a))Bt3/a3 m*ules register N63+A?O an N'3+A?O instea */
N6eceive+A?O an N!en+A?O. '* ease t(e c*nversi*n /r*m !)anD!=H#ase /a3
a))licati*ns t* resB/a3 *n %.4 versi*ns */ Asteris5 rxtxappnames,yes can #e
s)eci/ie in AetcAasteris5AresB/a3.c*n/. '(is c*n/igurati*n *)ti*n 1ill register
N63+A?O an N'3+A?O a))licati*n names instea */ N6eceive+A?O an N!en+A?O.
'(e a))Br3/a3 an a))Bt3/a3 m*ules use =HA!99!'A'U! an
=HA!99!'6IN: c(annel varia#les. '(ese c(annel varia#les 1ere ae t* t(e
%.4 versi*n */ resB/a3, an e)recate, t* ease t(e c*nversi*n t* resB/a3. '(e %.4
versi*ns */ resB/a3 1ill set =HA!99!'A'U! an =HA!99!'6IN: t* t(e same
value as t(e +A?!'A'U! an +A?!'A'U!!'6IN: c(annel varia#les. '(e %.4
versi*ns */ resB/a3 1ill create all 4 c(annel varia#les >=HA!99!'A'U!,
=HA!99!'6IN:, +A?!'A'U!, an +A?!'A'U!!'6IN:@ #e/*re t(e /a3
a))licati*ns e3it. '(e rec*mmene ial)lan m*i/icati*n is t* m*ve a1a0 /r*m
c(annel varia#les in /av*r */ t(e +A?7=' ial)lan /uncti*n. '(e e3am)le #el*1
illustrates re)lacement */ t(ese c(annel varia#les.
'(e resB/a3AresB/a3Bigium m*ules * n*t currentl0 su))*rt t(e 63+A? LcL >caller
m*e@ *)ti*n an t(e '3+A? LaL >calling m*e@ arguments.
Digium, n!. "age ,6

'(e /*ll*1ing is a list */ c*m)*nents use /*r t(is c*m)aris*n.
Asteris5 %.4.&&
ag3HastHa*ns
svn U6L$ (tt)s$AAag3HastHa*ns.svn.s*urce/*rge.netAsvnr**tAag3HastHa*ns
revisi*n 40
!)anD!=H0.0.4)re%6
Digium, n!. "age ,7

A%%endix 1& 2lossar3 and A!ron3ms
A67 American 5ational Standards 3nstitute
An *rganiJati*n 1(ic( )r*)*ses an esta#lis(es stanars /*r internati*nal c*mmunicati*ns.
as3n!$ronous
N*t s0nc(r*niJeP n*t time t* an *utsie cl*c5 s*urce. 'ransmissi*n is c*ntr*lle #0 start
#its at t(e #eginning an st*) #its at t(e en */ eac( c(aracter. As0nc(r*n*us
c*mmunicati*ns are */ten /*un in internet access an rem*te *//ice a))licati*ns.
attenuation
'(e issi)ati*n */ a transmitte signal4s )*1er as it travels *ver a 1ire.
.and(idt$
'(e ca)acit0 t* carr0 tra//ic. Hig(er #an1it( inicates t(e a#ilit0 t* trans/er m*re ata in a
given time )eri*.
.it
'(e smallest element */ in/*rmati*n in a igital s0stem. A #it can #e eit(er a Jer* *r a *ne.
.%s bits per second
A measurement */ transmissi*n s)ee acr*ss a ata c*nnecti*n.
.road.and
Digium, n!. "age ,4

8r*a#an transmissi*n s(ares t(e #an1it( */ a )articular meium >c*))er *r /i#er *)tic@
t* integrate multi)le signals. '(e c(annels ta5e u) i//erent /re2uencies *n t(e ca#le,
integrating v*ice, ata, an vie* *ver *ne line.
!$annel
A generic term /*r an iniviual ata stream. !ervice )r*viers can use multi)le3ing
tec(ni2ues t* transmit multi)le c(annels *ver a c*mm*n meium.
#at/
;ateg*r0 */ =er/*rmance /*r 1iring an ca#ling. ;at 5 ca#ling su))*rt a))licati*ns u) t* %00
"HJ.
#at/0
;ateg*r0 */ =er/*rmance /*r 1iring an ca#ling. ;ateg*r0 5 9n(ance 1iring su))*rts signal
rates u) t* %00 "HJ #ut a(eres t* stricter 2ualit0 s)eci/icati*ns.
#90# competiti%e local exchange carrier
A term /*r tele)(*ne c*m)anies esta#lis(e a/ter t(e 'elec*mmunicati*ns Act */ %DD6
eregulate t(e L9;s. ;L9;s c*m)ete 1it( IL9;s t* *//er l*cal service. !ee als* L9; an
IL9;.
#' central office
'(e ;7 (*uses l*cal s1itc(ing e2ui)ment. All l*cal access lines in a )articular ge*gra)(ic
area terminate at t(is /acilit0 >1(ic( is usuall0 *1ne an *)erate #0 an IL9;@.
#"0 customer premises e6uipment
'erminal e2ui)ment 1(ic( is c*nnecte t* t(e telec*mmunicati*ns net1*r5 an 1(ic( resies
1it(in t(e (*me *r *//ice */ t(e cust*mer. '(is inclues tele)(*nes, m*ems, terminals,
r*uters, an televisi*n setHt*) #*3es.
Digium, n!. "age ,)

DA8D 4igium Asterisk 7ardware 4e%ice 3nterface
A tele)(*n0 )r*Uect eicate t* im)lementing a reas*na#le an a//*ra#le c*m)uter
tele)(*n0 )lat/*rm int* t(e 1*rl mar5et)lace. Als*, t(e c*llective name /*r t(e DigiumH
)r*vie rivers /*r Digium tele)(*n0 inter/ace )r*ucts.
D70 4igital Signal8 /e%el (
A v*ice grae c(annel */ 64 S#)s. '(e 1*rl1ie stanar s)ee /*r igitiJing v*ice
c*nversati*n using =;" >=ulse ;*e "*ulati*n@.
D71 4igital Signal8 /e%el &
%.544 "#)s in N*rt( America >'%@ an Ja)an >J%@ Hu) t* &4 v*ice c(annels >D!0s@, &.048
"#)s in 9ur*)e >9%@ H u) t* 3& v*ice c(annels >D!0s@. D!%A'%A9% lines are )art */ t(e =!'N.
D7* 4igital Signal8 /e%el '
'3 in N*rt( America an Ja)an, 93 in 9ur*)e. U) t* 6,& v*ice c(annels >D!0s@. D!3A'3A93
lines are n*t )art */ t(e =!'N
D-MF 4ual !one 9ultiFre6uency
=us(H#utt*n *r t*uc( t*ne ialing.
01
'(e 9ur*)ean e2uivalent */ N*rt( American '%, transmits ata at &.048 "#)s, u) t* 3& v*ice
c(annels >D!0s@.
0*
'(e 9ur*)ean e2uivalent */ N*rt( American '3, transmits ata at 34.368 "#)s, u) t* 5%&
v*ice c(annels >D!0s@. 92uivalent t* %6 9% lines.
Digium, n!. "age /0

2.711
0#M :rror .orrection 9ode
0M :lectromagnetic 3nterference
Un1ante electrical n*ise )resent *n a )*1er line.
0t$ernet
9t(ernet is a /amil0 */ /rameH#ase c*m)uter net1*r5ing tec(n*l*gies /*r l*cal area net1*r5s
>LANs@. It e/ines a num#er */ 1iring an signaling stanars /*r t(e =(0sical La0er */ t(e
7!I net1*r5ing m*el, t(r*ug( means */ net1*r5 access at t(e "eia Access ;*ntr*l >"A;@
A Data Lin5 La0er, an a c*mm*n aressing /*rmat.
+ull du%lex
Data transmissi*n in t1* irecti*ns simultane*usl0.
F>' Foreign :xchange ;ffice
6eceives t(e ringing v*ltage /r*m an +?! evice.
F>7 Foreign :xchange Station
Initiates an sens ringing v*ltage.
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r an alg*rit(m
esigne t* transmit an receive mula1 =;" v*ice an AHla1 at a igital #it rate */ 64 S#)s.
'(is alg*rit(m is use /*r igital tele)(*ne sets *n igital =8?.
Digium, n!. "age /1
2.72*.1

8.*2*
esigne t* transmit an receive aui* *ver tele)(*ne lines at 6.3 S#)s *r 5.3 S#)s.
2.72)a
esigne t* transmit an receive aui* *ver tele)(*ne lines at 8 S#)s.
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r multimeia
c*mmunicati*ns *ver )ac5etH#ase net1*r5s.
$al+ du%lex
Data transmissi*n in *nl0 *ne irecti*n at a time.
A> 3nterAsterisk eXchange
'(e native C*I= )r*t*c*l use #0 Asteris5. It is an I9'+ stanar use t* ena#le C*I=
c*nnecti*ns #et1een Asteris5 servers, an #et1een servers an clients t(at als* use t(e IA?
)r*t*c*l.
91# internet /ow <itrate .odec
A /ree s)eec( c*ec use /*r v*ice *ver I=. It is esigne /*r narr*1 #an s)eec( 1it( a
)a0l*a #itrate */ %3.33 5#)s >/rame lengt( V 30ms@ an %5.& 5#)s >/rame lengt( V &0 ms@.
90# incumbent local exchange carrier
'(e L9;s t(at 1ere t(e *riginal carriers in t(e mar5et )ri*r t* t(e entr0 */ c*m)etiti*n an
t(ere/*re (ave t(e *minant )*siti*n in t(e mar5et.
inter+a!e
Digium, n!. "age /2

A )*int */ c*ntact #et1een t1* s0stems, net1*r5s, *r evices.
7' 3nternational Standards ;rgani=ation
90D lightemitting diode
9inux
A r*#ust, /eatureH)ac5e *)en s*urce *)erating s0stem #ase *n Uni3 t(at remains /reel0
availa#le *n t(e internet. It #*asts e)ena#ilit0 an *//ers a 1ie range */ c*m)ati#ilit0 1it(
(ar1are an s*/t1are. Asteris5 is su))*rte e3clusivel0 *n Linu3.
loo%.a!k
A state in 1(ic( t(e transmit signal is reverse #ac5 as t(e receive signal, t0)icall0 #0 a /ar
en net1*r5 element.
MA# address 9edia Access .ontrol address
A 2uasiHuni2ue ienti/ier assigne t* m*st net1*r5 aa)ters *r net1*r5 inter/ace cars >NI;s@
#0 t(e manu/acturer /*r ienti/icati*n.
M2#" 9edia >ateway .ontrol ?rotocol
multi%lexing
'ransmitting multi)le signals *ver a single line *r c(annel. +D" >/re2uenc0 ivisi*n
multi)le3ing@ an 'D" >time ivisi*n multi)le3ing@ are t(e t1* m*st c*mm*n met(*s. +D"
se)arates signals #0 iviing t(e ata *nt* i//erent carrier /re2uencies, an 'D" se)arates
signals #0 interleaving #its *ne a/ter t(e *t(er.
M5> multiplexer
Digium, n!. "age /*

A evice 1(ic( transmits multi)le signals *ver a single c*mmunicati*ns line *r c(annel. !ee
multi)le3ing.
o%en sour!e
!*/t1are istri#ute as s*urce c*e uner licenses guaranteeing an0#*0 rig(ts t* /reel0 use,
m*i/0, an reistri#ute t(e c*e.
'7 Re+eren!e Model ;pen Systems 3nterconnection -eference 9odel
An a#stract escri)ti*n /*r la0ere c*mmunicati*ns an c*m)uter net1*r5 )r*t*c*l esign.
%a!ket
A /*rmatte unit */ ata carrie #0 a )ac5et m*e c*m)uter net1*r5.
"1> pri%ate branch exchange
A smaller versi*n */ a )(*ne c*m)an04s large central s1itc(ing *//ice. 93am)le$ Asteris5.
"# peripheral component interconnect
A stanar #us use in m*st c*m)uters t* c*nnect )eri)(eral evices.
"DF ?ortable 4ocument Format
A /ile /*rmat create #0 A*#e !0stems Inc*r)*rate /*r *cument e3c(ange. =D+ is use
/*r re)resenting t1*Himensi*nal *cuments in a manner ine)enent */ t(e a))licati*n
s*/t1are, (ar1are, an *)erating s0stem.
"'" point of presence
'(e )(0sical c*nnecti*n )*int #et1een a net1*r5 an a tele)(*ne net1*r5. A =7= is usuall0
a net1*r5 n*e serving as t(e e2uivalent */ a ;7 t* a net1*r5 service )r*vier *r an
intere3c(ange carrier.
Digium, n!. "age /,

"'-7 plain old telephone ser%ice
!tanar )(*ne service *ver t(e )u#lic s1itc(e tele)(*ne net1*r5 >=!'N@. '(is service
)r*vies anal*g #an1it( */ less t(an 4 5HJ.
""" pointtopoint protocol
'0)e */ c*mmunicati*ns lin5 t(at c*nnects a single evice t* an*t(er single evice, suc( as a
rem*te terminal t* a (*st c*m)uter.
"7-6 public switched telephone network
'(e )u#lic s1itc(e tele)(*ne net1*r5 >=!'N@ is t(e net1*r5 */ t(e 1*rlLs )u#lic circuitH
s1itc(e tele)(*ne net1*r5s. 7riginall0 a net1*r5 */ /i3eHline anal*g tele)(*ne s0stems, t(e
=!'N is n*1 alm*st entirel0 igital, an n*1 inclues m*#ile as 1ell as /i3e tele)(*nes.
Fo7 6uality of ser%ice
A measure */ tele)(*ne service, as s)eci/ie #0 t(e =u#lic !ervice ;*mmissi*n.
RM11
A si3H)in Uac5 t0)icall0 use /*r c*nnecting tele)(*nes, m*ems, an /a3 mac(ines in
resiential an #usiness settings t* =8? *r t(e l*cal tele)(*ne ;7.
7" Session 3nitiation ?rotocol
An I9'+ stanar /*r setting u) sessi*ns #et1een *ne *r m*re clients. It is currentl0 t(e
leaing signaling )r*t*c*l /*r C*ice *ver I=, grauall0 re)lacing H.3&3.
sour!e !ode
An0 c*llecti*n */ statements *r eclarati*ns 1ritten in s*me (umanHreaa#le c*m)uter
)r*gramming language.
Digium, n!. "age //

-.*0
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r :r*u) 3 /a3
mac(ines t(at s)eci/ies t(e (ans(a5ing, )r*t*c*ls, an err*r c*rrecti*n. '.4 an '.30 ma5e
u) t(e c*m)lete stanar /*r :r*u) 3 /a3.
-.*4
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ t* )ermit /a3es
t* #e trans)*rte acr*ss I= net1*r5s #et1een e3isting :r*u) 3 /a3 terminals in real time.
-.,
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r :r*u) 3 /a3
mac(ines t(at s)eci/ies t(e )age imensi*ns, res*luti*ns, an c*m)ressi*n sc(eme. '.4 an
'.30 ma5e u) t(e c*m)lete stanar /*r :r*u) 3 /a3.
-1
A eicate igital carrier /acilit0 1(ic( transmits u) t* &4 v*ice c(annels >D!0s@ an
transmits ata at %.544 "#)s. ;*mm*nl0 use t* carr0 tra//ic t* an /r*m )rivate #usiness
net1*r5s an I!=s.
-*
A eicate igital carrier /acilit0 1(ic( c*nsists */ &8 '% lines an transmits ata at 44.,36
"#)s. 92uivalent t* 6,& v*ice c(annels >D!0s@.
-DM time di%ision multiplexer
A evice t(at su))*rts simultane*us transmissi*n */ multi)le ata streams int* a single (ig(H
s)ee ata stream. 'D" se)arates signals #0 interleaving #its *ne a/ter t(e *t(er.
tel!o
Digium, n!. "age /6

A generic name 1(ic( re/ers t* t(e tele)(*ne c*m)anies t(r*ug(*ut t(e 1*rl, incluing
687;s, L9;s, an =''s.
-FF !agged 3mage File Format
A /ile /*rmat /*r st*ring images.
ti% and ring
'(e stanar terminati*n *n t(e t1* c*nuct*rs */ a tele)(*ne circuitP name a/ter t(e
)(0sical a))earance */ t(e c*ntact areas *n t(e Uac5 )lug.
t(isted %air
'1* c*))er 1ires c*mm*nl0 use /*r tele)(*n0 an ata c*mmunicati*ns. '(e 1ires are
1ra))e l**sel0 ar*un eac( *t(er t* minimiJe rai* /re2uenc0 inter/erence *r inter/erence
/r*m *t(er )airs in t(e same #unle.
A %olts
A.17
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ t(at uses ';"
m*ulati*n at %&,000 an %4,400 #)s /*r :r*u) 3 /a3 transmissi*ns. It as ';" t* t(e C.&D
stanar at ,,&00 an D,600 #)s t* all*1 transmissi*n *ver n*isier lines.
A.21
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r
as0nc(r*n*us /ullHu)le3 c*mmunicati*n #et1een t1* anal*g ialHu) m*ems using aui*
/re2uenc0Hs(i/t 5e0ing m*ulati*n >+!S@ at 300 #au t* carr0 igital ata at 300 #itAs. It is a
variant */ t(e *riginal 8ell %03 m*ulati*n /*rmat.
A.27ter
Digium, n!. "age /7

A.2)
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r
s0nc(r*n*us &,400 an 4,800 #)s (al/Hu)le3 m*ems using D=!S m*ulati*n *n ialHu)
lines. It inclues an *)ti*nal ,5 #)s #ac5 c(annel. C.&,ter is use in :r*u) 3 /a3 transmissi*n
1it(*ut t(e #ac5 c(annel.
A rec*mmenati*n #0 t(e 'elec*mmunicati*n !tanariJati*n !ect*r >I'UH'@ /*r /ullHu)le3
m*ems all*1ing s0nc(r*n*us 4,800, ,,&00, an D,600 #)s trans/er m*es >=!S an GA"
m*ulati*ns@. It (as #een aa)te /*r :r*u) 3 /a3 transmissi*n *ver ialHu) lines at D,600
an ,,&00 #)s.
Ao" @oice o%er 3?
'ec(n*l*g0 use /*r transmitting v*ice tra//ic *ver a ata net1*r5 using t(e Internet =r*t*c*l.
Digium, n!. "age /4

A%%endix #& D25M 06D-570R "5R#8A70 A6D
9#0670 A2R00M06-
Mul3 200)
M"'R-A6- - "90A70 R0AD #AR0F599N
1. '(is Digium 9nHUser =urc(ase an License Agreement >t(e QAgreementQ@ is a legal
agreement #et1een Digium an its A//iliates >c*llectivel0 re/erre t* as QDigiumQ@ an t(e
licensee, )urc(aser an en user res)ectivel0 >(ereina/ter, N0*uO, NM*uO *r N0*urO@ */ t(e
Digium istri#uti*n meia, s*/t1are an relate *cumentati*n >t(e Q!*/t1areQ@, Digium
services >N!ervicesO@, an an0 Digium c*m)uter electr*nics >NHar1areO@, entitlements
grante )ursuant t* a !u#scri)ti*n Agreement, an relate manuals >c*llectivel0 t(e
Q=r*uctsQ@. A//iliates means an entit0 1(ic( is >a@ irectl0 *r inirectl0 c*ntr*lling DigiumP *r
>#@ 1(ic( is irectl0 *r inirectl0 *1ne *r c*ntr*lle #0 Digium. 80 *1nl*aing *r installing
t(e !*/t1are *r installing t(e Har1are, 0*u agree t* an acce)t t(e terms an c*niti*ns */
t(is Agreement. I/ 0*u * n*t acce)t, *r are n*t aut(*riJe t* acce)t t(e terms an c*niti*ns
*/ t(is Agreement, t(en 0*u s(*ul n*t install t(e !*/t1are *r Har1are an s(*ul rem*ve
an0 installe !*/t1are an Har1are /r*m 0*ur c*m)uter.
2. 2RA6- 'F 9#0670. !u#Uect t* t(e terms an c*niti*ns */ t(is Agreement, Digium
grants 0*u a n*nHe3clusive, n*nHsu#licensea#le, n*nHtrans/era#le license t* use t(e !*/t1are
/*r internal #usiness )ur)*ses an n*t /*r resale, su# license, leasing, *r >e3ce)t /*r t(*se
=r*ucts e3clue in !ecti*n &.% */ t(is Agreement@ )r*viing (*ste services t* t(irH)arties.
N!*/t1areO s(all inclue an0 u)graes, u)ates, #ug /i3es *r m*i/ie versi*ns >NU)graesO@
*r #ac5u) c*)ies */ t(e !*/t1are su))lie t* 0*u #0 Digium *r an aut(*riJe reseller,
)r*vie 0*u (*l a vali license t* t(e *riginal !*/t1are an (ave )ai an0 a))lica#le /ee /*r
U)graes. N*t1it(staning t(e /*reg*ing, 0*u ac5n*1lege t(at certain c*m)*nents */ t(e
!*/t1are ma0 #e c*vere #0 s*Hcalle N*)en s*urceO s*/t1are licenses >N7)en !*urce
;*m)*nentsO@. Digium 1ill )r*vie a list */ 7)en !*urce ;*m)*nents /*r a )articular versi*n
*/ t(e !*/t1are u)*n 0*ur re2uest. '* t(e e3tent re2uire #0 t(e licenses c*vering 7)en
!*urce ;*m)*nents, t(e terms */ suc( licenses 1ill a))l0 in lieu */ t(e terms */ t(is
Agreement, an Digium (ere#0 re)resents t(at *nl0 7)en !*urce ;*m)*nents 1it( licenses
t(at inten t* grant )ermissi*ns n* less #r*a t(an t(e license grante in t(is !ecti*n & are
inclue in t(e !*/t1are. '* t(e e3tent 1(ic( t(e licenses a))lica#le t* 7)en !*urce
;*m)*nents )r*(i#it an0 */ t(e restricti*ns in t(is Agreement 1it( res)ect t* suc( 7)en
!*urce ;*m)*nent, suc( restricti*ns 1ill n*t a))l0 . '(e =r*uct !50)e /*r Asteris5 c*ntains
t(ir )art0 s*/t1are t(at is license /*r use #0 !50)e !*/t1are !.a.r.l uner t(e terms */ t(e
!50)e 8usiness 9n User license at (tt)$AA111.s50)e.c*mAg*A#usiness.eula /*r use 1it(
!50)e c*mmunicati*ns )r*ucts t(at are )r*vie #0 !50)e ;*mmunicati*ns !.a.r.l uner
Digium, n!. "age /)

t(e terms */ t(e !50)e 8usiness 'erms */ !ervice at
(tt)$AA111.s50)e.c*mAg*A#usiness.terms. '(e !50)e s*/t1are is license, an t(e !50)e
)r*ucts are )r*vie, t* en users /*r t(eir *1n c*mmunicati*n )ur)*ses *nl0 an an0 *t(er
use is strictl0 )r*(i#ite.
2.1 "R'D5#-7 0>#95D0D FR'M 8'7-0D 70RA#07 R07-R#-'6
'(e /*ll*1ing =r*ucts are e3clue /r*m t(e (*ste services restricti*n */ !ecti*n & */ t(is
Agreement. +*r )ur)*ses */ clari/icati*n, M*u are /ree t* use t(e =r*ucts in t(is !ecti*n &.%
t* )r*vie (*ste services t* t(ir )arties.
:.,&D /*r Asteris5
+A? /*r Asteris5
H=9; /*r Asteris5
*. R070RAA-'6 'F R28-7. 93ce)t /*r t(e limite license rig(ts e3)ressl0 grante in t(is
Agreement, Digium reserves all rig(ts in an t* t(e !*/t1are an an0 m*i/icati*ns t(eret*,
incluing title, *1ners(i), traemar5, c*)0rig(t, )atent, trae secret an an0 *t(er rig(ts an
interests. M*u 1ill *1n *nl0 t(e Har1are >e3clusive */ !*/t1are em#ee in t(e Har1are@
an t(e )(0sical meia *n 1(ic( t(e !*/t1are an ass*ciate *cumentati*n are re)r*uce
an istri#ute. I/ 0*u all*1 an e3isting !ervices *r !u#scri)ti*n Agreement )lan t* la)se, 0*u
ma0 #e re2uire t* )a0 retr*activel0 annual /ees /*r all =r*ucts /r*m t(e ate */ t(e la)se in
*rer t* reinstate suc( !ervices. =r*ucts t(at are )r*vie *r s*l as em* *r evaluati*n
units, *r are mar5e 1it( t(e legen N+*r 9valuati*n 7nl0O *r a similar n*tati*n, are n*t
aut(*riJe /*r c*mmercial #usiness use in )r*ucti*n *r e)l*0ment, #ut are mae availa#le
*nl0 /*r em*nstrati*n *r evaluati*n )ur)*ses, an ma0 n*t #e res*l *r trans/erre t* an0
t(ir )art0 1it(*ut )ri*r 1ritten )ermissi*n /r*m Digium.
,. 0M0R206#N #A997. '(e =r*uct !50)e +*r Asteris5 is e3clue /r*m t(is !ecti*n 4.
!50)e +*r Asteris5 *es n*t su))*rt an0 emergenc0 calls an M*u ac5n*1lege t(at i/ M*u
are using !50)e +*r Asteris5 it is M*ur res)*nsi#ilit0 t* )urc(ase, se)aratel0 /r*m t(e !50)e
s*/t1are an !50)e =r*ucts, traiti*nal 1ireless *r /i3e line tele)(*ne services t(at *//er
access t* emergenc0 services, as m*re e3)licitl0 re/erre t* in t(e !50)e 8usiness 9n User
License Agreement an t(e !50)e 8usiness 'erms */ !ervice. M*u unerstan an
ac5n*1lege t(at t(e =r*ucts ma0 #e use t* im)lement, su))lement, *r re)lace tele)(*ne
s0stems an telec*mmunicati*ns services, an t(at in s*me cases, certain g*vernment
regulati*ns ma0 a))l0 t* t(eir im)lementati*n *r useP an c*m)liance 1it( suc( regulati*ns is
0*ur s*le res)*nsi#ilit0. M*u unerstan an ac5n*1lege t(at users */ t(e s0stem *n 1(ic(
0*u install t(e =r*ucts ma0 attem)t t* use t(at s0stem t* )lace emergenc0 calls. M*u
ac5n*1lege an agree t(at$ t(e =r*ucts must #e )r*)erl0 c*n/igure /*r 0*ur s0stem *r
a))licati*nP t(at t(e nature */ t(e =r*ucts an an0 net1*r5s t(e0 ma0 *)erate u)*n all*1
man0 )*ssi#le c*n/igurati*nsP t(at suc( c*n/igurati*n ma0 #e #e0*n t(e sc*)e */ t(e
*cumentati*n su))lie 1it( t(e =r*uctsP an t(at s)ecialiJe e3)erience an training ma0
Digium, n!. "age 60

#e re2uire t* )r*)erl0 c*n/igure t(e =r*ucts. M*u ac5n*1lege an agree t(at it is 0*ur
s*le res)*nsi#ilit0 t* ensure t(at t(e =r*ucts an ass*ciate net1*r5s an s0stems are
im)lemente an c*n/igure suc( t(at emergenc0 calls are )r*)erl0 (anle, an t(at an0
s0stem *r a))licati*n #ase *n t(e =r*ucts c*m)lies 1it( all a))lica#le la1s an
regulati*ns. M*u ac5n*1lege an agree t(at tele)(*ne an telec*mmunicati*ns s0stems
can #e c*m)le3 an must #e installe, im)lemente, an c*n/igure #0 t(e a))r*)riate
tec(nicall0 2uali/ie )ers*nnel, an t(at 0*u *r 0*ur aut(*riJe agents (ave t(e 2uali/icati*ns
necessar0 t* )r*)erl0 im)lement an c*n/igure t(e =r*ucts t* (anle emergenc0 calls, i/
a))lica#le. M*u /urt(er ac5n*1lege an agree t(at it is 0*ur s*le an *ng*ing res)*nsi#ilit0
t* ensure t(e )r*)er *)erati*n */ an0 emergenc0 calling s0stem #ase *n t(e =r*ucts,
incluing, #ut n*t limite t*$ initiall0 an regularl0 testing t(e *)erati*n */ t(e =r*ucts,
incluing testing t(e *)erati*n 1it( emergenc0 servicesP n*ti/0ing an training all users */ an0
s0stem *n 1(ic( t(e =r*ucts are installe (*1 t* use t(e s0stem /*r emergenc0 callsP an
n*ti/0ing suc( users */ an0 an all limitati*ns */ 0*ur c*n/igurati*n an im)lementati*ns */ t(e
=r*ucts an an0 net1*r5 *r s0stem t(e =r*ucts are use *n *r 1it(. 80 using t(e =r*ucts
uner t(is Agreement, 0*u e3)licitl0 release Digium /r*m an0 1arrant0, ut0, lia#ilit0, *r
*#ligati*n t* train 0*u *r an0 users */ 0*ur s0stem regaring t(e )r*)er c*n/igurati*n,
*)erati*n, *r use */ t(e =r*ucts *r an0 s0stem *r net1*r5 t(e0 are use in c*nUuncti*n 1it(
*n 1(ic( it is installeP t* ensure t(at 0*ur c*n/igurati*n, im)lementati*n, *r use */ t(e
=r*ucts )r*vies /*r t(e )r*)er (anling *r r*uting */ emergenc0 callsP *r t* ensure t(at 0*ur
use */ t(e =r*ucts is in c*m)liance 1it( an0 a))lica#le la1s an regulati*ns.
/. 9M-A-'6 'F 9A19-N.
'* t(e ma3imum e3tent )ermitte #0 la1, Digium is n*t lia#le uner an0 c*ntract, negligence,
strict lia#ilit0 *r *t(er legal *r e2uita#le t(e*r0 /*r an0 l*ss */ use */ t(e =r*ucts,
inc*nvenience *r inirect amages */ an0 c(aracter, incluing #ut n*t limite t* amages /*r
c*)0rig(t *r )atent in/ringement, 1(et(er s)ecial, inciental *r c*nse2uential >incluing, #ut
n*t limite t*, l*ss */ revenue *r )r*/it, 1*r5 st*))age, c*m)uter /ailure *r mal/uncti*n, /ailure
*/ c*nnecte e2ui)ment *r )r*grams, l*ss */ in/*rmati*n *r ata *r l*ss */ g**1ill@ resulting
/r*m t(e use */ t(e =r*ucts, relating t* 1arrant0 service, *r arising *ut */ an0 #reac( */ t(is
Agreement, even i/ Digium (as #een avise */ t(e )*ssi#ilit0 */ suc( amages. '(e s*le
reme0 /*r a #reac( */ t(e /*reg*ing limite 1arrant0 is re)air, re)lacement *r re/un */ t(e
e/ective *r n*nHc*n/*rming =r*uct>s@. '(e ma3imum lia#ilit0 */ Digium uner t(is
Agreement is limite t* t(e )urc(ase )rice */ t(e =r*uct>s@ 1(ic( is t(e su#Uect */ t(e
is)ute. +*r )ur)*ses */ clari/icati*n, t* t(e ma3imum e3tent all*1e #0 a))lica#le la1
Digium is n*t lia#le in an0 am*unt /*r 93clue =r*uct>s@ as t(*se =r*uct>s@ are )r*vie
at n* c(arge. '(e /*reg*ing e3)ress 1ritten 1arranties an remeies are e3clusive an in lieu
*/ an0 *t(er 1arranties *r remeies, e3)ress, im)lie *r statut*r0.
6. :ARRA6-N.
'(e terms uner 1(ic( DigiumLs =r*ucts are 1arrante are e/ine in t(e Digium !tanar
Warrant0 =*lic0, availa#le *n 111.igium.c*m, t(e terms */ 1(ic( are inclue (erein an
inc*r)*rate #0 t(is re/erence.
Digium, n!. "age 61

6.1 :ARRA6-N 0>#957'67.
+*r )ur)*ses */ clari/icati*n, certain Digium =r*ucts an =r*uct /amilies are n*t c*vere #0
Digium4s !tanar Warrant0 =*lic0 >N93clue =r*uctsO@. +76 'H9 9?;LUD9D
=67DU;'!, '7 'H9 "A?I"U" 9?'9N' ALL7W9D 8M A==LI;A8L9 LAW, N9I'H96
DI:IU", N76 I'! 'HI6DH=A6'M LI;9N!76! 76 !U==LI96!, N76 I'! DI69;'76!,
7++I;96!, 9"=L7M99!, 76 A++ILIA'9! "AS9 ANM 69=69!9N'A'I7N! 76
WA66AN'I9! 7+ ANM SIND '7 ANM 9ND U!96, 9I'H96 9?=69!! 76 I"=LI9D, WI'H
69!=9;' '7 'H9 =67DU;'!, IN;LUDIN:, 8U' N7' LI"I'9D '7 WA66AN'I9! 76
69=69!9N'A'I7N! 7+ "96;HAN'I8ILI'M, +I'N9!! +76 A =A6'I;ULA6 =U6=7!9,
76 N7NHIN+6IN:9"9N', 9?;9=' '7 'H9 9?'9N' 7'H96WI!9 !=9;I+I;ALLM
A:699D IN W6I'IN: 8M !U;H =96!7N 76 9N'I'M. '7 'H9 "A?I"U" 9?'9N'
ALL7W9D 8M A==LI;A8L9 LAW, IN N7 9C9N' !HALL DI:IU", I'! 'HI6D =A6'M
LI;9N!76! 76 !U==LI96!, N76 I'! DI69;'76!, 7++I;96!, 9"=L7M99!,
A++ILLIA'9! 76 LI;9N!76! 89 LIA8L9 '7 M7U +76 ANM DA"A:9! 7+ ANM SIND,
IN;LUDIN: IN;ID9N'AL, ;7N!9GU9N'IAL, 76 9;7N7"I; DA"A:9 76 INJU6M '7
=67=96'M, L7!' =67+I'! 76 L7!' 69C9NU9!, W9H'H96 8A!9D 7N ;7N'6A;',
'76' >IN;LUDIN: N9:LI:9N;9@ 76 7'H96 'H976M AND 69:A6DL9!! 7+
WH9'H96 !U;H =96!7N 76 9N'I'M !HALL 89 ADCI!9D 76 HAC9 69A!7N '7
SN7W 7+ 'H9 =7!!I8LI'M 7+ !U;H DA"A:9!, 9?9=' '7 'H9 9?'9N'
7'H96WI!9 A:699D IN W6I'IN: 8M !U;H =96!7N 76 9N'I'M. '(e 93clue
=r*ucts are e/ine in t(e /*ll*1 su#secti*ns. All terms an c*niti*ns */ t(is Agreement,
a))l0 t* t(e 93clue =r*ucts as etaile in t(is Agreement.
6.1.1 "R'D5#-7 0>#95D0D FR'M D25MO7 7-A6DARD :ARRA6-N "'9#N
'(e /*ll*1ing 93clue =r*ucts are n*t c*vere #0 Digium4s !tanar Warrant0 =*lic0 an
Digium e3)ressl0 isclaims an0 lia#ilit0 arising /r*m use */ suc( 93clue =r*ucts )ursuant
t* !ecti*n 6.%. $
Asteris5 Des5t*) Assistant >ADA@
+A? /*r Asteris5
:.,&D /*r Asteris5
H=9; /*r Asteris5
7. "R'"R0-ARN :'RP7. '(e =r*uct>s@ c*ntain traemar5s, trae secrets anA*r
c*)0rig(te materials */ Digium *r its su))liers.
7.1 M*u agree n*t t* reverse engineer, ec*m)ile, *r isassem#le t(e !*/t1are, n*r e/eat,
#0)ass, rem*ve *r *t(er1ise inter/ere 1it( an0 licensing mec(anism 1(ic( ma0 #e )r*vie
in *r 1it( t(e !*/t1are, e3ce)t t* t(e e3tent suc( restricti*n is e3)ressl0 )r*(i#ite #0
Digium, n!. "age 62

a))lica#le la1. M*u s(all n*t iscl*se *r ma5e availa#le suc( trae secrets *r c*)0rig(te
material >incluing an0 in/*rmati*n )ertaining t* an0 licensing mec(anism 1(ic( ma0 #e
)r*vie in *r 1it( t(e !*/t1are@ in an0 /*rm t* an0 t(ir )art0 n*r rem*ve an0 traemar5
n*tices, c*)0rig(t n*tices, *r licensing terms /r*m t(e !*/t1are *r an0 c*m)*nents t(erein.
7.2 M*u 1ill n*t >e3ce)t 1it( regar t* /air use *r n*minative use@ 1it(*ut Digium 1ritten
c*nsent, use t(e name, traemar5s, trae names *r l*g*s */ Digium, *r t(e name */ an0
)r*uct *r service */ Digium, in an0 manner. I/ Digium grants 0*u a rig(t t* use t(e
a/*rementi*ne, 0*u 1ill * s* *nl0 in strict c*m)liance 1it( Digium traemar5 )*licies.
4. -0RM6A-'6. '(is Agreement s(all terminate u)*n eit(er estructi*n */ t(e =r*ucts *r
return */ t(e =r*ucts #0 0*u t* Digium. In t(e event */ a #reac( */ t(e sc*)e */ use
)ermitte #0 t(e grant in !ecti*n &, *r i/ 0*u * n*t c*m)l0 1it( *t(er materials terms an
c*niti*ns */ t(is Agreement, Digium s(all (ave t(e rig(t t* immeiatel0 terminate t(is
Agreement, in 1(ic( case 0*u must )r*m)tl0 estr*0 *r return all =r*ucts t* Digium.
N*t1it(staning t(e /*reg*ing, t(e )r*visi*ns */ !ecti*ns 5, 6, ,, 8, D, %0, %%, %& an %3 s(all
survive terminati*n */ t(is Agreement.
). 0>"'R- R07-R#-'6. M*u ac5n*1lege t(at t(e !*/t1are, 1it( t(e )*ssi#le e3ce)ti*n
*/ certain t(irH)art0 c*m)*nents, is */ Unite !tates *rigin. '(e e3)*rt an reHe3)*rt */ t(e
!*/t1are is c*ntr*lle #0 t(e Unite !tates 93)*rt Aministrati*n 6egulati*ns an suc(
!*/t1are ma0 n*t #e e3)*rte *r reHe3)*rte t* ;u#a, Iran, Ira2, Li#0a, N*rt( S*rea, !uan,
!0ria *r an0 *t(er c*untr0 t* 1(ic( t(e Unite !tates em#arg*es g**s. In aiti*n, t(e
!*/t1are ma0 n*t #e istri#ute t* )ers*ns *n t(e 'a#le */ Denial 7rers, t(e 9ntit0 List, *r
t(e List */ !)eciall0 Designate Nati*nals. 80 *1nl*aing *r using a Digium !*/t1are
=r*uct, 0*u are certi/0ing t(at 0*u are n*t a nati*nal */ ;u#a, Iran, Ira2, Li#0a, N*rt( S*rea,
!uan, !0ria *r an0 *t(er c*untr0 t* 1(ic( t(e Unite !tates em#arg*es g**s an t(at 0*u
are n*t a )ers*n *n t(e 'a#le */ Denial 7rers, t(e 9ntit0 List *r t(e List */ !)eciall0
Designate Nati*nals.
10. -RA67F0R A6D A7726M06-. '(is Agreement an t(e rig(ts an *#ligati*ns uner it
are n*t assigna#le #0 0*u 1it(*ut t(e )ri*r 1ritten a))r*val */ Digium, v*luntaril0 *r #0
*)erati*n */ la1. An0 attem)t #0 0*u t* assign t(is Agreement 1it(*ut suc( a))r*val s(all #e
v*i. '(is Agreement s(all inure t* t(e #ene/it */ t(e success*rs an assigns */ Digium.
N*t1it(staning t(e /*reg*ing, 0*u ma0 m*ve t(e !*/t1are t* i//erent internal c*m)uters t*
t(e e3tent c*nsistent 1it( t(e sc*)e */ license 0*u (ave )urc(ase t* t(e !*/t1are.
11. 5.7. 2'A0R6M06- 570R7. '(e !*/t1are an *cumentati*n 2uali/0 as Nc*mmercial
itemsO as e/ine at 48 ;.+.6. &.%0% an 48 ;.+.6. %&.&%&. All :*vernment users ac2uire t(e
!*/t1are an *cumentati*n 1it( *nl0 t(*se rig(ts (erein t(at a))l0 t* n*nHg*vernmental
cust*mers */ Digium.
12. 2'A0R662 9A: A6D M5R7D#-'6 A6D D7"5-0 R07'95-'6. '(is
Agreement is t* #e c*nstrue in acc*rance 1it( an g*verne #0 la1s */ t(e !tate */
Ala#ama, e3cluing its c*n/lict */ la1 )r*visi*ns. Digium an 0*u agree t* su#mit t* t(e
Digium, n!. "age 6*

)ers*nal an e3clusive Uurisicti*n */, an agree t(at venue is )r*)er in, t(e Ala#ama !tate *r
+eeral ;*urts l*cate in t(e ;*unt0 */ "ais*n, Ala#ama, /*r an0 suc( legal acti*n *r
)r*ceeing. Digium an 0*u (ere#0 e3)ressl0 1aive an0 rig(t t* a trial #0 Uur0 an c*nsent t*
a #enc( trial in t(e event */ a is)ute. Digium an 0*u agree t* attem)t t* res*lve an0
is)ute #0 irect c*mmunicati*n #et1een re)resentatives */ eac( )art0 1(* are aut(*riJe t*
/inall0 res*lve t(e is)ute. '(e )arties agree t* attem)t t* res*lve t(e is)ute 1it(in /*urteen
>%4@ a0s */ n*tice */ t(e is)ute (aving #een )r*vie t* t(e )art0 n*t inv*5ing t(is clause
an agree n*t t* res*rt t* legal acti*n, *t(er t(an inUuncti*ns, uring t(e /*urteen a0 is)ute
res*luti*n )eri*. '(e Unite Nati*ns ;*nventi*n *n Internati*nal !ale */ :**s, t(e
a))licati*n */ 1(ic( is e3)ressl0 e3clue, *es n*t g*vern t(is Agreement.
1*. 06-R0 A2R00M06-. '(is Agreement c*nstitutes t(e entire unerstaning #et1een t(e
)arties relating t* t(e su#Uect matter (ere*/ an su)ersee all )ri*r 1ritings, neg*tiati*ns *r
unerstanings 1it( res)ect t(eret*. '(e )r*visi*ns */ t(is Agreement s(all ta5e )receence
*ver an0 c*n/licting terms in an0 su#se2uent )urc(ase *rer, *cumentati*n *r c*llateral.
'(e )arties agree t(at t(is Agreement ma0 #e e3ecute electr*nicall0 an t(at electr*nic
c*)ies */ t(is Agreement s(all #e #ining u)*n t(e )arties. I/ an0 )r*visi*n */ t(is 9ULA is
(el t* #e v*i, invali, unen/*rcea#le *r illegal, t(e *t(er )r*visi*ns s(all c*ntinue in /ull
/*rce an e//ect.
4igium :A?/A "((#(B"1
Digium, n!. "age 6,

Fax For Asterisk Manual

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Fax For Asterisk Manual

Caricato da

Copyright:

Formati disponibili

Fax For Asterisk

Potrebbero piacerti anche