<html>
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1255">
<meta name=Generator content="Microsoft Word 10 (filtered)">
<title>SIP proxy How to</title>
<style>
<!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:"Arial Unicode MS";
panose-1:2 11 6 4 2 2 2 2 2 4;}
@font-face
{font-family:"Lucida Console";
panose-1:2 11 6 9 4 5 4 2 2 4;}
@font-face
{font-family:Miriam;}
@font-face
{font-family:"\@Arial Unicode MS";
panose-1:2 11 6 4 2 2 2 2 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
h1
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
page-break-after:avoid;
font-size:16.0pt;
font-family:Arial;}
h2
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
text-align:right;
page-break-after:avoid;
direction:rtl;
unicode-bidi:embed;
font-size:14.0pt;
font-family:Arial;
font-style:italic;}
h3
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
page-break-after:avoid;
font-size:13.0pt;
font-family:Arial;}
h4
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.75in;
margin-bottom:.0001pt;
page-break-after:avoid;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex1, li.MsoIndex1, div.MsoIndex1
{margin-top:0in;
margin-right:10.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex2, li.MsoIndex2, div.MsoIndex2
{margin-top:0in;
margin-right:20.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex3, li.MsoIndex3, div.MsoIndex3
{margin-top:0in;
margin-right:30.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex4, li.MsoIndex4, div.MsoIndex4
{margin-top:0in;
margin-right:40.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex5, li.MsoIndex5, div.MsoIndex5
{margin-top:0in;
margin-right:50.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex6, li.MsoIndex6, div.MsoIndex6
{margin-top:0in;
margin-right:60.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex7, li.MsoIndex7, div.MsoIndex7
{margin-top:0in;
margin-right:70.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex8, li.MsoIndex8, div.MsoIndex8
{margin-top:0in;
margin-right:80.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoIndex9, li.MsoIndex9, div.MsoIndex9
{margin-top:0in;
margin-right:1.25in;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
text-indent:-10.0pt;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoToc1, li.MsoToc1, div.MsoToc1
{margin-top:.25in;
margin-right:0in;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:left;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;
text-transform:uppercase;
font-weight:bold;}
p.MsoToc2, li.MsoToc2, div.MsoToc2
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:left;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";
font-weight:bold;}
p.MsoToc3, li.MsoToc3, div.MsoToc3
{margin-top:0in;
margin-right:9.95pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:left;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc4, li.MsoToc4, div.MsoToc4
{margin-top:0in;
margin-right:20.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc5, li.MsoToc5, div.MsoToc5
{margin-top:0in;
margin-right:30.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc6, li.MsoToc6, div.MsoToc6
{margin-top:0in;
margin-right:40.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc7, li.MsoToc7, div.MsoToc7
{margin-top:0in;
margin-right:50.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc8, li.MsoToc8, div.MsoToc8
{margin-top:0in;
margin-right:60.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoToc9, li.MsoToc9, div.MsoToc9
{margin-top:0in;
margin-right:70.0pt;
margin-bottom:0in;
margin-left:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:"Times New Roman";}
p.MsoIndexHeading, li.MsoIndexHeading, div.MsoIndexHeading
{margin:0in;
margin-bottom:.0001pt;
text-align:right;
direction:rtl;
unicode-bidi:embed;
font-size:10.0pt;
font-family:Arial;}
p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.75in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:Arial;}
p.MsoBodyTextIndent2, li.MsoBodyTextIndent2, div.MsoBodyTextIndent2
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
text-indent:-.25in;
font-size:10.0pt;
font-family:Arial;}
p.MsoBodyTextIndent3, li.MsoBodyTextIndent3, div.MsoBodyTextIndent3
{margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:Arial;}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;}
pre
{margin:0in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Arial Unicode MS";}
/* Page Definitions */
@page Section1
{size:595.3pt 841.9pt;
margin:1.0in 31.3pt 1.0in 48.0pt;}
div.Section1
{page:Section1;}
/* List Definitions */
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1 dir=RTL>
<p class=MsoToc3 align=left dir=LTR style='margin-top:0in;margin-right:0in;
margin-bottom:0in;margin-left:9.95pt;margin-bottom:.0001pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span class=MsoHyperlink><b><span
style='text-transform:uppercase'><span style='text-decoration:none'> </span></span></b></span></p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-align:justify;text-indent:-.25in'><a name="_Toc37572433"></a><a
name="_Toc37572276"></a><a name="_Toc37572099"></a><a name="_Toc37572059"></a><a
name="_Toc37571820"></a><a name="_Toc37571547"></a><a name="_Toc37571489">1.<span
style='font:7.0pt "Times New Roman"'> </span>Introduction</a></h1>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572434"></a><a
name="_Toc37572277"></a><a name="_Toc37572100"></a><a name="_Toc37572060"></a><a
name="_Toc37571821"></a><a name="_Toc37571548"></a><a name="_Toc37571490"><span
style='font-style:normal'>1.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Revision</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:
Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span>Version 0.1 12/02/2002 <a href="mailto:dan_austin@fitawi.com?subject=SER%20Howto"><span
style='color:windowtext;text-decoration:none'>Dan Austin</span></a></p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:
Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span>Version 0.2 12/03/2002 <a href="mailto:dan_austin@fitawi.com?subject=SER%20Howto"><span
style='color:windowtext;text-decoration:none'>Dan Austin</span></a></p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:
Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span>Version 1.0 12/06/2002 <a href="mailto:dan_austin@fitawi.com?subject=SER%20Howto"><span
style='color:windowtext;text-decoration:none'>Dan Austin</span></a></p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:
Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span>Version 1.1 12/16/2002 <a href="mailto:dan_austin@fitawi.com?subject=SER%20Howto"><span
style='color:windowtext;text-decoration:none'>Dan Austin</span></a></p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:
Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span>Version 2.0 10/04/2003 NSI Ltd.</p>
<p class=MsoNormal dir=LTR style='margin-left:1.0in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'><b>This document is a result of a merge of two documents </b><b><a
href="http://www.fitawi.com/ser-Howto.html">http://www.fitawi.com/ser-Howto.html</a>
and</b></p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'><b><a
href="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/*checkout*/ser/sip_router/INSTALL?rev=ser_0_8_10&content-type=text/plain">http://cvs.berlios.de/cgi-bin/viewcvs.cgi/*checkout*/ser/sip_router/INSTALL?rev=ser_0_8_10&content-type=text/plain</a>
with some add-ons, made by NSI team</b> <b>(<span style='color:red'>see text in
bold within topics</span>)</b></p>
<p class=MsoNormal dir=LTR style='margin-left:1.0in;text-align:left;text-indent:
-.25in;direction:ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572435"></a><a
name="_Toc37572278"></a><a name="_Toc37572101"></a><a name="_Toc37572061"></a><a
name="_Toc37571822"></a><a name="_Toc37571549"></a><a name="_Toc37571491"><span
style='font-style:normal'>1.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Why SER</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.75in;text-align:left;direction:
ltr;unicode-bidi:embed'>SER is an open-source project that aims to make
available a fully functional and scalable Session Initiated Protocol
server. Call processing is described with a concise scripting language
that offers the flexibility of regular expressions and the ability to interface
with 3<sup>rd</sup> party applications for the purposes of call accounting and
authorization.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572436"></a><a
name="_Toc37572279"></a><a name="_Toc37572102"></a><a name="_Toc37572062"></a><a
name="_Toc37571823"></a><a name="_Toc37571550"></a><a name="_Toc37571492"><span
style='font-style:normal'>1.3.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Where to get SER</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;text-indent:
.25in;direction:ltr;unicode-bidi:embed'>SER is available for download from <a
href="ftp://ftp.berlios.de/pub/ser">ftp://ftp.berlios.de/pub/ser</a></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;text-indent:
.25in;direction:ltr;unicode-bidi:embed'>The newest release may be found in the
folder /latest</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572437"></a><a
name="_Toc37572280"></a><a name="_Toc37572103"></a><a name="_Toc37572063"></a><a
name="_Toc37571824"></a><a name="_Toc37571551"></a><a name="_Toc37571493">2.<span
style='font:7.0pt "Times New Roman"'> </span>Installation</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572438"></a><a
name="_Toc37572281"></a><a name="_Toc37572104"></a><a name="_Toc37572064"></a><a
name="_Toc37571825"></a><a name="_Toc37571552"></a><a name="_Toc37571494"><span
style='font-style:normal'>2.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Installation Notes</span></a></h2>
<pre dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;
margin-left:.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>Supported architectures: Linux/i386, Linux/armv4l, FreeBSD/i386, OpenBSD/i386</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>Solaris/sparc64 </span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>(For other architectures the Makefiles might need to be edited)</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>There are various configuration options defined in the Make file.</span></pre><pre
dir=LTR><span style='font-family:Arial'> </span></pre>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572439"></a><a
name="_Toc37572282"></a><a name="_Toc37572105"></a><a name="_Toc37572065"></a><a
name="_Toc37571826"></a><a name="_Toc37571553"></a><a name="_Toc37571495"><span
style='font-style:normal'>2.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Requirements</span></a></h2>
<pre dir=LTR><span style='font-family:Arial'> </span></pre><pre dir=LTR
style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:.75in;
margin-bottom:.0001pt'><span style='font-family:Arial'>- gcc or icc : gcc >= 2.9x; 3.[12] recommended (it will work with older version</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'> but it might require some options tweaking for best performance)</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- bison or yacc (</span><span
style='font-family:Arial'>Berkley</span><span style='font-family:Arial'> yacc)</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- flex</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- GNU make (on Linux this is the standard "make", on FreeBSD and Solaris is</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'> called "gmake")</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- sed and tr (used in the make files)</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- GNU tar ("gtar" on Solaris) and gzip if you want "make tar" to work</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'>- GNU install or BSD install (on Solaris "ginstall") if you want "make</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><span style='font-family:Arial'> install", "make bin", "make sunpkg" to work</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><b><span style='font-size:11.0pt;font-family:Arial'>-</span></b><span
style='font-size:11.0pt;font-family:Arial'> “<b>mysql” if you need MySQL support</b></span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><b><span style='font-size:11.0pt;font-family:Arial'>- “Apache (httpd)” if you want serweb support</span></b></pre><pre
dir=LTR style='margin-top:0in;margin-right:.75in;margin-bottom:0in;margin-left:
.75in;margin-bottom:.0001pt'><b><span style='font-size:11.0pt;font-family:Arial'>- “PHP, MySQL-PHP” for serweb support</span></b><b><span
style='font-family:Arial'> </span></b></pre><pre dir=LTR style='margin-top:
0in;margin-right:.75in;margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt'><span
style='font-family:Arial'>- libmysqlclient & libz (zlib) if you want mysql support (the mysql module)</span></pre>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>- libexpat if you want the jabber gateway support (the jabber module)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Installing SER on a RedHat Linux distribution for
example, is a simple matter of unzipping the downloaded file and using your
favorite package manager.</p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572440"></a><a
name="_Toc37572283"></a><a name="_Toc37572106"></a><a name="_Toc37572066"></a><a
name="_Toc37571827"></a><a name="_Toc37571554"></a><a name="_Toc37571496"><span
style='font-style:normal'>2.3.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Install the package</span></a></h2>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Example /root>rpm –i ser-08.10-2.i386.rpm</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Packages for other popular distributions are available,
and can be installed using the appropriate package manager for that
distribution.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>On many platforms you can start the service with
/etc/init.d/ser start. RedHat systems will use /etc/rc.d/init.d/ser
start.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>You now have a functioning SIP server, but what can you
do with it? At this point not very much. With an SIP client, such
as Microsoft MSN Messenger 4.6, you can register with the server, send Instant
Messages to other logged on clients of the same server, and even have voice
conversations with them. </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>That sounds pretty good, but maybe you’d like to add a
little more security, or make you server accessible to others.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572442"></a><a
name="_Toc37572285"></a><a name="_Toc37572108"></a><a name="_Toc37572068"></a><a
name="_Toc37571829"></a><a name="_Toc37571556"></a><a name="_Toc37571498"><span
style='font-style:normal'>2.4.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Serctl Utility</span></a></h2>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'> </p>
<pre dir=LTR style='margin-top:0in;margin-right:30.0pt;margin-bottom:0in;
margin-left:30.0pt;margin-bottom:.0001pt;text-indent:-12.0pt'> <span
style='font-family:Arial'>To do so, first set the environment variable SIP_DOMAIN to your domain name, e.g., in Bourne shell, call “ export SIP_DOMAIN="foo.bar" “</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.25in;margin-bottom:0in;margin-left:
.25in;margin-bottom:.0001pt'><b><span style='font-size:11.0pt;font-family:Arial'> If you wont the system to created this variable automatically, you need to add the line </span></b></pre><pre
dir=LTR style='margin-top:0in;margin-right:.25in;margin-bottom:0in;margin-left:
.25in;margin-bottom:.0001pt'><b><span style='font-size:11.0pt;font-family:Arial'> “export SIP_DOMAIN="foo.bar” “ in the end of file “/etc/profile”.</span></b></pre><pre
dir=LTR style='margin-top:0in;margin-right:.5in;margin-bottom:0in;margin-left:
.5in;margin-bottom:.0001pt'><span style='font-family:Arial'>If you are using other than 'localhost' mysql server for maintaining subscriber database, change the variable 'SQL_HOST' to the proper host name in the serctl script.</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.5in;margin-bottom:0in;margin-left:
.5in;margin-bottom:.0001pt'><span style='font-family:Arial'>Run the serctl utility /usr/sbin/serctl monitor.</span></pre><pre
dir=LTR style='margin-top:0in;margin-right:.25in;margin-bottom:0in;margin-left:
.25in;margin-bottom:.0001pt'><span style='font-family:Arial'> /usr/local/sbin/serctl monitor (if you installed from a tar.gz or Solaris package).</span></pre>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572443"></a><a
name="_Toc37572286"></a><a name="_Toc37572109"></a><a name="_Toc37572069"></a><a
name="_Toc37571830"></a><a name="_Toc37571557"></a><a name="_Toc37571499"><span
style='font-style:normal'>2.5.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>DNS SVR Resource Records</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>It is important that your SIP clients can connect to
your server for purposes of registration and call control. You might even
want to have a redundant server to handle calls if your primary server is
unavailable.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>These requirements can be meet by using DNS SVR
Resource Records, available in BIND 8.X and up releases.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The format for a SVR RR is this:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
_service._protocol SVR Priority
Weight Port hostname</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>In this case we want to establish an entry for our
primary SIP server, gateway.mydomain.com, that will listen on UDP port
5060. The entry will look like this:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
_sip._udp
SRV 0 0 5060
gateway.mydomain.com</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Placement of the new resource record is
important. Here is a sample zone file:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>; zone
'mydomain.com' last serial 1998071308</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>$ORIGIN com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mydomain
86400
IN SOA
gateway.mydomain.com. postmaster.mydomain.com. (</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
1998111908 ; Serial</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
36000 ; Refresh</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
900 ; Retry</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
36000 ; Expire</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
28800 ); Minimum</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
IN
NS
gateway.mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
IN
NS
ns3.backupdomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
IN
MX
1 gateway.mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
IN
A
192.168.0.1</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;If we place
the SRV record above the next line it fails to load</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>$ORIGIN
fitawi.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>_sip._udp
SRV 0 0 5060 gateway.mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>gateway
IN
A
192.168.0.1</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>www
IN
CNAME
gateway.mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>After reloading your zone file you can verify that the
entry is working by using dig.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
dig –t SRV _sip._udp.mydomain.com</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The results should look something like this:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;
<<>> DiG 9.1.0 <<>> -t SRV _sip._udp.mydomain.com</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; global
options: printcmd</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; Got answer:</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;;
->>HEADER<<- opcode: QUERY, status: NOERROR, id: 32654</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; flags: qr
aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 2, ADDITIONAL: 1</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; QUESTION
SECTION:</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;_sip._udp.mydomain.com.
IN SRV</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; ANSWER
SECTION:</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>_sip._udp.mydomain.com.
86400 IN SRV 0 0 5060 gateway.mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; AUTHORITY
SECTION:</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mydomain.com.
86400
IN NS
ns3.elsewhere.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mydomain..com
86400 IN
NS gateway. mydomain.com.</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;;
ADDITIONAL SECTION:</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>gateway.
mydomain.com. 86400
IN A
192.168.0.150</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; Query
time: 6 msec</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; SERVER:
192.168.0.150#53(192.168.0.150)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>;; WHEN: Tue
Dec 3 08:34:17 2002</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>;; MSG SIZE rcvd: 132</p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572444"></a><a
name="_Toc37572287"></a><a name="_Toc37572110"></a><a name="_Toc37572070"></a><a
name="_Toc37571831"></a><a name="_Toc37571558"></a><a name="_Toc37571500"><span
style='font-style:normal'>2.6.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Adding a database for client
information</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>By leveraging a MySQL database, we can provide support
for user credentials, and keeping track of where the clients are logged on
during server restarts.</p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572445"></a><a
name="_Toc37572288"></a><a name="_Toc37572111"></a><a name="_Toc37572071"></a><a
name="_Toc37571832"></a><a name="_Toc37571559"></a><a name="_Toc37571501"><span
style='font-style:normal'>2.7.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>MySQL setup</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>To install support for a MySQL database you will need
to download the package ser-mysql, which is available from the same download location
that you retrieved SER. This package has scripts to create the required
database and establish permissions for the accounts needed. A recent
release of MySQL is recommended. Earlier versions may have problems with
the syntax required to set permissions on the database.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> If you do not already have a copy of MySQL
installed, download it from your <a href="http://www.mysql.com/">http://www.mysql.com</a></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> Once you have MySQL installed and started,
execute /usr/sbin/ser_mysql.sh.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> You can verify that the database has been
created, and correct permissions assigned by using the mysql management tool
and these steps:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Mysql>
select * from user;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
Host
| User | Password |
Select_priv | Insert_priv | Update_priv | Delete_priv | Create_priv | Drop_priv
| Reload_priv | Shutdown_priv | Process_priv | File_priv | Grant_priv |
References_priv | Index_priv | Alter_priv |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
%
| ser | 4e633cf914a735a0 |
N |
N |
N |
N |
N | N
| N |
N |
N |
N |
N |
N
| N
| N |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
localhost |
ser | 4e633cf914a735a0 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
Y
| Y |
Y |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
%
| serro | 7cb73a267cb7bd5f |
N |
N |
N |
N |
N |
N | N
| N |
N |
N |
N |
N
| N |
N |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
localhost | serro |
7cb73a267cb7bd5f |
Y |
N |
N |
N |
N |
N |
N |
N |
N |
N |
N | N
| N |
N |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The above results show that the two user, ser and
serro, have been created and granted the permissions needed to access the
database. Note that in the above example the permissions have been
modified to deny access to these accounts from any system(%) other than local
host.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
connect ser;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Connection
id: 294</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Current
database: ser</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
show tables;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>+-----------------+</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
Tables_in_ser |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>+-----------------+</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>| acc
|</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
active_sessions |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
aliases |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
config |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
event |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
grp | </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
location |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
missed_calls |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
pending |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
phonebook |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
reserved |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
silo |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>| subscriber
|</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
version |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>+-----------------+</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>14 rows in
set (0.00 sec)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
select * from subscriber;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
phplib_id
| USER_ID | PASSWORD | FIRST_NAME | LAST_NAME |
PHONE | EMAIL_ADDRESS
| DATETIME_CREATED | DATETIME_MODIFIED |
confirmation
| flag | SendNotification | Greeting
| HA1
| REALM |
ha1b
| perms | allow_find |
timezone |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
4cefa7a4d3c8c2dbf6328520bd873a19 | admin | heslo |
first | admin |
557-8469 |
admin@iptel.org | 2002-12-02 19:20:41 |
2002-12-02 20:29:46 | 80e0f273b2067d40277b49ff842bb9e3 | o
|
| |
c79a8f8f08596baa84bb02c88884426d | iptel.org | f322c94b8b2fbe557d43ab3ac9e05b3a
| admin | 1 |
America/Los_Angeles |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>This last query shows that you have one user account
defined and it has administrator privileges.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>We’ll need to add another account to be the
administrator for your realm, which we will do after the next section.</p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572446"></a><a
name="_Toc37572289"></a><a name="_Toc37572112"></a><a name="_Toc37572072"></a><a
name="_Toc37571833"></a><a name="_Toc37571560"></a><a name="_Toc37571502">3.<span
style='font:7.0pt "Times New Roman"'> </span>Configuration</a></h1>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572447"></a><a
name="_Toc37572290"></a><a name="_Toc37572113"></a><a name="_Toc37572073"></a><a
name="_Toc37571834"></a><a name="_Toc37571561"></a><a name="_Toc37571503"><span
style='font-style:normal'>3.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Modify SER configuration</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Now that we have a working MySQL database, we need to
modify the configuration file for ser, located on a RedHat, installed in
/etc/ser<b>/</b><b><span style='font-size:11.0pt'>ser.cfg</span></b><span
style='font-size:11.0pt'>.</span> The following changes need to be made:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>To enable support for the new MySQL database we need to
load the appropriate module. That is accomplished by uncomment this line:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>loadmodule "//usr/lib/ser/modules/mysql.so</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Next we need to set SER to use the database and write
changes instead of just caching them in memory. This is done by means of
commenting this line:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> modparam ("usrloc",
"db_mode", 0)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>And uncomment this line:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> modparam ("usrloc",
"db_mode", 2)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Note on db_modes:</p>
<p class=MsoNormal dir=LTR style='margin-left:1.0in;text-align:left;text-indent:
-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:Symbol'>·</span><span
style='font-size:7.0pt'> </span>Mode
0</p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
direction:ltr;unicode-bidi:embed'>Disables writes to the database.
Contact information will not be preserved if the server is restarted.</p>
<p class=MsoNormal dir=LTR style='margin-left:1.0in;text-align:left;text-indent:
-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:Symbol'>·</span><span
style='font-size:7.0pt'> </span>Mode
1</p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
direction:ltr;unicode-bidi:embed'>Writes all changes to the database
immediately. Contact information is saved to the database immediately.
This can slow the response to clients as they connect.</p>
<p class=MsoNormal dir=LTR style='margin-left:1.0in;text-align:left;text-indent:
-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:Symbol'>·</span><span
style='font-size:7.0pt'> </span>Mode
2</p>
<p class=MsoNormal dir=LTR style='margin-left:1.25in;text-align:left;
direction:ltr;unicode-bidi:embed'>Periodically writes contact information to
the database based in the in memory cache.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>We have the option of storing passwords in our database
in plain text. This allows for password recovery and makes the initial
setup and testing easier. To enable this feature uncomment these lines:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> modparam ("auth",
"calculate_ha1", yes)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> modparam ("auth",
"password_column", "password")</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>These lines work together. The first tells SER to
generate a hash based on username, password and realm. The second tells
SER where to look for the plain-text password in the database.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Lastly we need to update the routing section to
recognize our realm.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Change (uri==”myself”) to (uri=~”mydomain.com”)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Uncomment these lines and change all instances of
iptel.org to mydomain.com</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
if (!www_authorize("mydomain.com", "subscriber")) {</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
www_challenge("mydomain.com", "0");</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
break;</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
};</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>We’re now ready to restart ser. On RedHat use
/etc/rc.d/init.d/ser restart</p>
<h3 dir=LTR> </h3>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572448"></a><a
name="_Toc37572291"></a><a name="_Toc37572114"></a><a name="_Toc37572074"></a><a
name="_Toc37571835"></a><a name="_Toc37571562"></a><a name="_Toc37571504"><span
style='font-style:normal'>3.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Adding an admin for your realm</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Now that we have a working database and ser is
configured to use it, we need to add some users and at least one of them should
have administrator privileges. The administrator role becomes important
if you want to use a web management tool such as serweb.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Basic account manipulation can be performed with the
serctl script, located in /usr/local/sbin.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>To add a user use these commands</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>serctl add JoeUser qwerty <a
href="mailto:joe@mydomain.com">joe@mydomain.com</a></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>The system notify for
“Type MySQL Password”, the default password is “<u>heslo”</u> </span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>To make JoeUser an administrator, we need to logon to
MySQL and modify the database.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
connect ser;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
update subscriber set perms=”admin” where USER_ID=”JoeUser”;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Query OK, 1
row affected (0.00 sec)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Rows
matched: 1 Changed: 1 Warnings: 0</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>mysql>
select * from subscriber;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>|
4cefa7a4d3c8c2dbf6328520bd873a19 | JoeUser | qwerty
| | | | joe@mydomain.com | 2002-12-02
19:20:41 | 2002-12-02 20:29:46 | 80e0f273b2067d40277b49ff842bb9e3 |
o
|
| |
c79a8f8f08596baa84bb02c88884426d | mydomain.com |
f322c94b8b2fbe557d43ab3ac9e05b3a | admin |
1 | America/Los_Angeles |</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The third from last field shows that Joe has been
assigned admin privileges.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>At this point Joe can logon to our server, but since he
is the only user, there is not much he can do. We can now add additional
users using the serctl script, or now is a good time to look at installing
serweb, which will allow users to subscribe to our service.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572449"></a><a
name="_Toc37572292"></a><a name="_Toc37572115"></a><a name="_Toc37572075"></a><a
name="_Toc37571836"></a><a name="_Toc37571563"></a><a name="_Toc37571505"><span
style='font-style:normal'>3.3.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>More on serctl</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The script serctl can be used to manage users, access
control lists, in memory contacts, and to monitor server health.
Executing serctl with no arguments will produce this output:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>usage: </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
* subscribers *</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
add <username> <password> <email> .. add a new subscriber (*)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
passwd <username> <passwd> ......... change user's password (*)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
rm <username> ...................... delete a user (*)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
mail <username> .................... send an email to a user</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
alias show [<alias>] ............... show aliases</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
alias rm <alias> ................... remove an alias</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
alias add <alias> <uri> ............ add an aliases </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
* access control lists *</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
acl show [<username>] .............. show user membership</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
acl grant <username> <group> ....... grant user membership (*)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
acl revoke <username> [<group>] .... grant user membership(s) (*)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
* usrloc *</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
ul show [<username>]................ show in-RAM online users</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
ul rm <username> ................... delete user's UsrLoc entries</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
ul add <username> <uri> ............ introduce a permanent UrLoc
entry</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
showdb [<username>] ................ show online users flushed in DB</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
* server health *</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
monitor ............................ show internal status</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
ps ................................. show runnig processes </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> serctl
fifo ............................... send raw commands to FIFO</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> Commands labeled with (*) will prompt for
a MySQL password.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> If the variable PW is set, the password
will not be prompted.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> ACL privileges are: local ld
int voicemail free-pstn</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572450"></a><a
name="_Toc37572293"></a><a name="_Toc37572116"></a><a name="_Toc37572076"></a><a
name="_Toc37571837"></a><a name="_Toc37571564"></a><a name="_Toc37571506"><span
style='font-style:normal'>3.4.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Adding and deleting users with
serctl</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>User account management is performed with these
commands:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>serctl add</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>serctl password</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>serctl rm</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The contents of the in memory cache can be managed with
the ul argument. Care must be taken to with these commands. For
example:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>serctl ul rm joe </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Will remove the current contact information about Joe
from memory</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Whereas serctl rm joe will delete joe’s account.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572451"></a><a
name="_Toc37572294"></a><a name="_Toc37572117"></a><a name="_Toc37572077"></a><a
name="_Toc37571838"></a><a name="_Toc37571565"></a><a name="_Toc37571507"><span
style='font-style:normal'>3.5.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Examining in memory cache with
serctl</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The command “serctl ul show” will list any currently
registered clients. The output will look like this:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>===Domain
list===</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>---Domain---</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>name :
'location'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>size : 512</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>table:
0x402ee6d0</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>d_ll {</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
n : 2</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
first: 0x402f1a74</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
last : 0x402f089c</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>}</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>lock : 0</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>...Record(0x402f1a74)...</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>domain:
'location'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>aor
: 'test'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>~~~Contact(0x402f708c)~~~</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>domain :
'location'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>aor
: 'test'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Contact: 'sip:test@192.168.0.100:5060'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Expires:
2501</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>q
: 0.00</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Call-ID:
'000a8a93-d4660017-4571a6cd-658ac1bf@192.168.0.100'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>CSeq
: 101</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>State
: CS_SYNC</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>next
: (nil)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>prev
: (nil)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>~~~/Contact~~~~</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>.../Record...</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>...Record(0x402f089c)...</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>domain:
'location'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>aor
: 'joe'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>~~~Contact(0x402f0924)~~~</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>domain :
'location'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>aor
: 'joe'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Contact:
'sip:192.168.0.101:14354'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Expires: 432</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>q
: 0.00</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>Call-ID:
'e8d93059-e46e-4fd9-958b-ccb36a1cf245@192.168.0.101'</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>CSeq
: 11</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>State
: CS_SYNC</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>next
: (nil)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>prev
: (nil)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>~~~/Contact~~~~</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>.../Record...</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>---/Domain---</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>===/Domain
list===</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572452"></a><a
name="_Toc37572295"></a><a name="_Toc37572118"></a><a name="_Toc37572078"></a><a
name="_Toc37571839"></a><a name="_Toc37571566"></a><a name="_Toc37571508"><span
style='font-style:normal'>3.6.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Examining server status</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Two commands can be used to check the health of the
server. The first command serctl ps returns a list of all SER related
processes, the ip address and the port they are listening on. For
example:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>[root@gateway /root]# serctl ps</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>0 31029
attendant</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>1 31033
receiver child=0 sock=0 @ 127.0.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>2 31034
receiver child=1 sock=0 @ 127.0.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>3 31035
receiver child=2 sock=0 @ 127.0.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>4 31036
receiver child=3 sock=0 @ 127.0.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>5 31037
receiver child=0 sock=1 @ 192.168.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>6 31038
receiver child=1 sock=1 @ 192.168.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>7 31039
receiver child=2 sock=1 @ 192.168.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>8 31040
receiver child=3 sock=1 @ 192.168.0.1::5060</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>9 31049
fifo server</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>10 31072
timer</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The second command, serctl monitor, shows the server
version, uptime, pending and completed transactions, and the number of major
category responses the server has sent. Another example:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>[cycle #: 1; if constant make sure server lives and
fifo is on]</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Server: Sip EXpress router (0.8.10 (i386/linux)</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Now: Wed Dec 4 10:13:02 2002</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Up Since: Mon Dec 2 21:21:11 2002</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Up time: 132711 [sec]</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Transaction Statistics</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Current: 0 (2 waiting) Total: 46 (0
local) </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Replied localy: 37 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Completion status 6xx: 0, 5xx: 0, 4xx: 23, 3xx: 0,2xx:
22 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Stateless Server Statistics</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>200: 101 202: 0 2xx: 0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>300: 0 301: 0 302: 0 3xx:
0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>400: 0 401: 0 403: 0 404: 132 407: 0 408: 0 483: 1 4xx:
0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>500: 0 5xx: 0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>6xx: 0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>xxx: 0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>failures: 0 </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>UsrLoc Stats</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Domain Registered Expired</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>'location' 2 2</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572453"></a><a
name="_Toc37572296"></a><a name="_Toc37572119"></a><a name="_Toc37572079"></a><a
name="_Toc37571840"></a><a name="_Toc37571567"></a><a name="_Toc37571509">4.<span
style='font:7.0pt "Times New Roman"'> </span>Installing SERweb</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The SERweb package can be downloaded from <a
href="ftp://ftp.berlios.de/ser/latest/serweb">ftp://ftp.berlios.de/ser/latest/serweb</a></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The pages associated with SERweb provide a starting
point to customize your SIP user account management tools.</p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572454"></a><a
name="_Toc37572297"></a><a name="_Toc37572120"></a><a name="_Toc37572080"></a><a
name="_Toc37571841"></a><a name="_Toc37571568"></a><a name="_Toc37571510"><span
style='font-style:normal'>4.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>PHP configuration</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.75in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>Go to PHP
configuration file in /etc/php.ini and change “register_globals = “Off” to “On</span>”</b></p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572455"></a><a
name="_Toc37572298"></a><a name="_Toc37572121"></a><a name="_Toc37572081"></a><a
name="_Toc37571842"></a><a name="_Toc37571569"></a><a name="_Toc37571511"><span
style='font-style:normal'>4.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Installing SERweb default
configuration</span></a></h2>
<p class=MsoBodyTextIndent dir=LTR>If you are installing this package on a
server that does not host any other web pages, you can simply extract the files
to the document directory of your web server. This presumes that you have
a working Web Server. </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572456"></a><a
name="_Toc37572299"></a><a name="_Toc37572122"></a><a name="_Toc37572082"></a><a
name="_Toc37571843"></a><a name="_Toc37571570"></a><a name="_Toc37571512"><span
style='font-style:normal'>4.3.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Installing SERweb custom file
locations</span></a></h2>
<p class=MsoBodyTextIndent2 dir=LTR style='text-indent:0in'>In case your server
performs multiple functions, and you want to just add the SERweb tools to an
existing web site, we will need to make changes to a number of the php files.
The following examples are from an Apache 2.0 on RedHat.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoBodyTextIndent dir=LTR style='margin-top:0in;margin-right:.5in;
margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt'>Unzip the files into
a temporary directory, such as /root/serweb. The directory will contain
these files:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>-rw-rw-r-- 1
827
2020 18561 Sep 25 16:31 COPYING</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>drwxr-xr-x 2 827
2020 1024 Nov 27 16:43 CVS</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>-rw-rw-r-- 1
827
2020 529 Sep 25 16:29
README</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>drwxr-xr-x 7
827
2020 1024 Nov 27 22:24 html</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>drwxr-xr-x 3
827
2020 2048 Sep 26 10:26 phplib</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h4 dir=LTR style='margin-top:0in;margin-right:.5in;margin-bottom:0in;
margin-left:.5in;margin-bottom:.0001pt'><span style='font-size:11.0pt'>On the Linux
RedHat Version 8 root directory on web server is /var/www/html/</span></h4>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Move the html directory to the root of your web server:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b>mv html </b><b><span style='font-size:11.0pt'>/var/www/html/htdocs/serweb
</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Move the phplib directory to your web server
application directory:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b>mv phplib </b><b><span style='font-size:11.0pt'>/var/www/html/phplib</span></b></p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'><b><s><span style='font-size:11.0pt;color:red'><span style='text-decoration:
none'> </span></span></s></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>Following files must
be updated with this “new” path to the libraries:</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt;font-family:"Times New Roman"'> </span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>./admin/prepend.php</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>./user_interface/prepend.php</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>./user_interface/reg/prepend.php</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>For these files the variable:
$_PHPLIB["libdir"] = "../../phplib/"; becomes
$_PHPLIB["libdir"] = "../../../phplib/"; </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>In the ./admin directory <b><span style='font-size:
11.0pt'>edit</span></b> the files acl.php, index.php, and users.php will need
their path to the forms library updated. For this example, add ../ to the
existing line</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>:require "../../../phplib/oohforms.inc";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>In the ./user_interface directory the following files
need the same change:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>accounting.php
find_user.php
index.php missed_calls.php</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>my_account.php
phonebook.php
send_im.php</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>notification_subscription.php</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Next these files in ./user_interface/reg need the same
change, with an additional ../:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Finish.php
get_pass.php
index.php</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The last changes occur in the config.php file to
provide the location for graphic files, style sheets and time zone
information. Update the following variables:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>$this->root_path="/serweb/";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->fifo_server = “/tmp/ser_fifo”;</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->zonetab_file =
"/usr/share/zoneinfo/zone.tab";
</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>//TZ zone descriptions file, usually:
/usr/share/zoneinfo/zone.tab</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><b><span style='font-size:11.0pt'>Find two variables: “</span></b><span
dir=RTL></span><b><span lang=HE dir=RTL style='font-size:11.0pt'><span dir=RTL></span>
$</span></b><b><span style='font-size:11.0pt'>this->mail_forgot_pass=”,”</span></b><span
dir=RTL></span><b><span lang=HE dir=RTL style='font-size:11.0pt'><span dir=RTL></span>
$</span></b><b><span style='font-size:11.0pt'>this->mail_register=” and
change line <span style='color:blue'><a
href="http://oook/~iptel/user_interface/reg/confirmation.php?nr=#confirm#\n\n">http://oook/~iptel/user_interface/reg/confirmation.php?nr=#confirm#\n\n</a></span></span></b></p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'><b><span style='font-size:11.0pt'> with line</span></b></p>
<p class=MsoBodyTextIndent3 dir=LTR><b><span style='font-size:11.0pt;
color:blue'><a
href="http://%22.$_server%5b'http_host'%5d.%22/htdocs/serweb/user_interface/reg/confirmation.php?nr=#confirm#\n\n">http://".$_SERVER['HTTP_HOST']."/htdocs/serweb/user_interface/reg/confirmation.php?nr=#confirm#\n\n</a></span></b></p>
<p class=MsoBodyTextIndent3 dir=LTR><b><span style='color:blue'> </span></b></p>
<p class=MsoBodyTextIndent3 dir=LTR><b><span style='font-size:11.0pt'>This will
insure sending a registration feedback mail to SIP server using its IP address</span></b></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;text-indent:
-.25in;direction:ltr;unicode-bidi:embed'><span style='font-family:"Times New Roman"'> </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572457"></a><a
name="_Toc37572300"></a><a name="_Toc37572123"></a><a name="_Toc37572083"></a><a
name="_Toc37571844"></a><a name="_Toc37571571"></a><a name="_Toc37571513"><span
style='font-style:normal'>4.4.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Modifying SERweb configuration
general</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>We need to update
/usr/local/apache/htdocs/serweb/config.php to represent our realm. The
following variables need to be changed to our domain:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->realm="mydomain.com";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->domainname=" mydomain.com";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->web_contact="sip:JoeUser@ mydomain.com";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>//address of pseudo sender</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->default_domain=" mydomain.com";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>
$this->mail_header_from="Registration@ mydomain.com";</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Additionally we will want to modify the section for
Terms and Conditions, either replacing it with appropriate language for our
services, or at least replacing iptel.org with our domain information.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572458"></a><a
name="_Toc37572301"></a><a name="_Toc37572124"></a><a name="_Toc37572084"></a><a
name="_Toc37571845"></a><a name="_Toc37571572"></a><a name="_Toc37571514">5.<span
style='font:7.0pt "Times New Roman"'> </span>Issues and Limitation</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Since one of the design goals behind SIP is to
decentralize the intelligence in communications handling, a basic tenant is
that SIP clients need to be able to communicate directly with each other.
The problem is that many clients find themselves either behind a firewall or in
a NAT fronted address space. When a client registers with the SIP server,
it tells the server what it is using for an IP address, and that address may
not be accessible to the public.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572459"></a><a
name="_Toc37572302"></a><a name="_Toc37572125"></a><a name="_Toc37572085"></a><a
name="_Toc37571846"></a><a name="_Toc37571573"></a><a name="_Toc37571515"><span
style='font-style:normal'>5.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>More on NAT</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>There are a couple of ways that we can overcome the
problem that NAT introduces. Some SIP client providers are building in
options into their products that allow the user to identify the IP address that
their phone will appear as to the public. This is a nice simple approach,
but presumes that the person installing the client knows what that IP address
is, and that it doesn’t change. Cisco has built this feature into their
79XX series SIP phones.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>A second solution that is working its way through the
standards process is called ‘Simple Traversal of UDP through NAT’, or
STUN. A STUN equipped client is configured to send a who-am-I packet to a
known server on the public network. That server will respond with the IP
address that the client appears to be communicating from, and the client can
then use that address to register with the SIP server. Phones that
leverage STUN include: Snom 100, kphone, and sipc .</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572460"></a><a
name="_Toc37572303"></a><a name="_Toc37572126"></a><a name="_Toc37572086"></a><a
name="_Toc37571847"></a><a name="_Toc37571574"></a><a name="_Toc37571516">5.2.<span
style='font:7.0pt "Times New Roman"'>
</span><span style='font-style:normal'>Firewalls</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>SIP clients also present an interesting challenge to
configuring a firewall. During registration the SIP client will be
assigned a UDP port in the range of 16384 to 32768. Our firewall
administrators will not happily open up all of those ports to all of the
internal systems, on the chance that a SIP connection may be needed. </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>This is where the concept of a Firewall Control
Protocol, or FCP, comes into play. The design idea is that when a SIP
client registers, a FCP agent, or server if you prefer, will dynamically insert
a new rule into the firewall policy to permit that client to participate in SIP
conversations.</p>
<h1 dir=LTR> </h1>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572461"></a><a
name="_Toc37572304"></a><a name="_Toc37572127"></a><a name="_Toc37572087"></a><a
name="_Toc37571848"></a><a name="_Toc37571575"></a><a name="_Toc37571517">6.<span
style='font:7.0pt "Times New Roman"'> </span>Diagnostics and tools</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Detailed information about the communications between
clients and the SIP server is needed to isolate problems. Two tools that
can be used to gather such information are sipsak and ngrep.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572462"></a><a
name="_Toc37572305"></a><a name="_Toc37572128"></a><a name="_Toc37572088"></a><a
name="_Toc37571849"></a><a name="_Toc37571576"></a><a name="_Toc37571518">6.1.<span
style='font:7.0pt "Times New Roman"'>
</span><span style='font-style:normal'>NGrep</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Ngrep is a capable of listening in on network traffic
and filtering it in much the same way as grep can locate patterns in
files. To monitor the communications between a client, joe, and the
server the following command would be run on the server:</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;text-indent:
.5in;direction:ltr;unicode-bidi:embed'>ngrep -n 5060 –d eth0 joe</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Since SIP communications are ASCII based, all events
such as REGISTER, INVITE, SUBSCRIBE, etc. are captured. The output of
ngrep can identify problems with SIP addresses, or client identity.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Ngrep should be part of most modern distributions, or
can be downloaded from <a href="http://sourceforge.net/projects/ngrep/">http://sourceforge.net/projects/ngrep/</a></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572463"></a><a
name="_Toc37572306"></a><a name="_Toc37572129"></a><a name="_Toc37572089"></a><a
name="_Toc37571850"></a><a name="_Toc37571577"></a><a name="_Toc37571519">6.2.<span
style='font:7.0pt "Times New Roman"'>
</span><span style='font-style:normal'>Sipsak</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Sipsak can be used to determine if your server is
responding to requests, and provide information on how your server would route
SIP connections. Sipsak and basic documentation on its use can be
downloaded from <a href="http://sipsak.berlios.de/">http://sipsak.berlios.de</a>
</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572464"></a><a
name="_Toc37572307"></a><a name="_Toc37572130"></a><a name="_Toc37572090"></a><a
name="_Toc37571851"></a><a name="_Toc37571578"></a><a name="_Toc37571520">7.<span
style='font:7.0pt "Times New Roman"'> </span>Client Configuration</a></h1>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572465"></a><a
name="_Toc37572308"></a><a name="_Toc37572131"></a><a name="_Toc37572091"></a><a
name="_Toc37571852"></a><a name="_Toc37571579"></a><a name="_Toc37571521"><span
style='font-style:normal'>7.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Microsoft Messenger 4.6</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Microsoft Messenger 4.6 can be configured as a SIP client
by selecting Tools\Options\Accounts and selecting Communications Service for
the account sign in. Clear the check boxes for .NET Passport and Exchange
Account. Check the Communications Service account and enter your SIP
account name. Click on Advanced and select Configure settings.
Enter the IP address of your server, or hostname and choose UDP.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572466"></a><a
name="_Toc37572309"></a><a name="_Toc37572132"></a><a name="_Toc37572092"></a><a
name="_Toc37571853"></a><a name="_Toc37571580"></a><a name="_Toc37571522"><span
style='font-style:normal'>7.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Cisco 79XX phones</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Cisco has complete documentation on how to convert a
79XX series phone to use SIP. The basic steps are:</p>
<h3 dir=LTR style='margin-top:12.0pt;margin-right:.85in;margin-bottom:3.0pt;
margin-left:.85in;text-indent:-.35in'><a name="_Toc37572467"></a><a
name="_Toc37572310"></a><a name="_Toc37572133"></a><a name="_Toc37572093"></a><a
name="_Toc37571854"></a><a name="_Toc37571581"></a><a name="_Toc37571523"><span
style='font-size:10.0pt;font-family:"Times New Roman";font-weight:normal'>7.2.1.<span
style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-size:10.0pt;font-weight:normal'>Configure a
DHCP service that provides:</span></a></h3>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>a.<span style='font-size:
7.0pt'> </span>IP address</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>b.<span style='font-size:
7.0pt'> </span>Subnet mask</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>c.<span style='font-size:
7.0pt'> </span>Default gateway</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>d.<span style='font-size:
7.0pt'> </span>DNS server addresses</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>e.<span style='font-size:
7.0pt'> </span>TFTP server address</p>
<h3 dir=LTR style='margin-top:12.0pt;margin-right:.85in;margin-bottom:3.0pt;
margin-left:.85in;text-indent:-.35in'><a name="_Toc37572468"></a><a
name="_Toc37572311"></a><a name="_Toc37572134"></a><a name="_Toc37572094"></a><a
name="_Toc37571855"></a><a name="_Toc37571582"></a><a name="_Toc37571524"><span
style='font-size:10.0pt;font-weight:normal'>7.2.2.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-size:10.0pt;font-weight:normal'>On the TFTP
server load these files:</span></a></h3>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>a.<span style='font-size:
7.0pt'> </span>OS79XX – Identifies which
firmware the phone should load with no extension. Example: P0S3-04-1-00</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>b.<span style='font-size:
7.0pt'> </span>P0S3-04-1-00.bin – The firmware
image</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>c.<span style='font-size:
7.0pt'> </span>SIPDefault.cnf
- Site wide configuration options</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>d.<span style='font-size:
7.0pt'> </span>SIPmacaddress.cnf – Phone specific
settings, including logon name and password. Example: SIP000A8A93D466.cnf</p>
<p class=MsoNormal dir=LTR style='margin-left:1.75in;text-align:left;
text-indent:-.25in;direction:ltr;unicode-bidi:embed'>e.<span style='font-size:
7.0pt'> </span>RINGLIST.DAT, ringer1.pcm,
ringer2.pcm – ring tones</p>
<p class=MsoNormal dir=LTR style='margin-left:1.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Each time the phone is powered on it will tftp download
OS79XX and determine if it needs a firmware update. If no update is
needed the next step is to download SIPDefault.cnf, SIPmacaddress.cnf, and optionally
a dialplan, ringlist and ring tones.</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> Calls can be placed to other registered SIP
clients, or to a PSTN number provided there is PSTN gateway identified in the
SER configuration file.</p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572469"></a><a
name="_Toc37572312"></a><a name="_Toc37572135"></a><a name="_Toc37572095"></a><a
name="_Toc37571856"></a><a name="_Toc37571583"></a><a name="_Toc37571525">8.<span
style='font:7.0pt "Times New Roman"'> </span>PSTN connectivity</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>Passing calls that originate from a SIP client to the
PSTN is a simple matter of permitting SER to relay the session to an
established PSTN gateway. Calls that start out on the PSTN and need to be
directed to a SIP client requires that the PSTN gateway be aware of where to
direct the call.</p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572470"></a><a
name="_Toc37572313"></a><a name="_Toc37572136"></a><a name="_Toc37572096"></a><a
name="_Toc37571857"></a><a name="_Toc37571584"></a><a name="_Toc37571526"><span
style='font-style:normal'>8.1.<span style='font:7.0pt "Times New Roman"'>
</span></span><span style='font-style:normal'>Cisco Dial-peer</span></a></h2>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'>The Cisco gateway needs to have a PSTN
interface, such as FXO ports or a VXB-2TE1+ card, and depending on the model of
Cisco device an upgraded IOS revision. The dial-peer itself is simple:</p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>dial-peer
voice 999
voip
</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> destination-pattern
555999. ** Associate the number range
555-9990 to 9999 with our SIP server</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> session
protocol sipv2
** Set this dial-peer to use SIP instead of Cisco protocols</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> session
target sip-server ** Send the
call to our SIP server. See SIP-UA below</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> codec
g711ulaw
** Set the default codec to 711-Ulaw (common codec between clients)</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>!</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>sip-ua</span></p>
<p class=MsoNormal dir=LTR style='margin-left:48.0pt;text-align:left;
direction:ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> sip-server
ipv4:192.168.0.1 ** IP address of our SIP
server</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<h2 dir=LTR style='margin-left:.55in;text-align:left;text-indent:-.3in;
direction:ltr;unicode-bidi:embed'><a name="_Toc37572471"></a><a
name="_Toc37572314"></a><a name="_Toc37572137"></a><a name="_Toc37572097"></a><a
name="_Toc37571858"></a><a name="_Toc37571585"></a><a name="_Toc37571527">8.2.<span
style='font:7.0pt "Times New Roman"'>
</span><span style='font-style:normal'>Relaying</span> PSTN in ser.cfg</a></h2>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>The
following is an extremely simple sample of how to relay a call from a SIP
client to the PSTN</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'># attempt
handoff to PSTN</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
if (uri=~"^sip:9[0-9]*@mydomain.com") { ## This assumes
that the caller is </span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
log("Forwarding to PSTN\n"); ##
registered in our realm</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
t_relay_to(
"192.168.0.2", "5060"); ## Our Cisco router</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
break;</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'>
};</span></p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'><span style='font-family:"Lucida Console"'> </span></p>
<h1 dir=LTR style='margin-top:12.0pt;margin-right:.25in;margin-bottom:3.0pt;
margin-left:.25in;text-indent:-.25in'><a name="_Toc37572472"></a><a
name="_Toc37572315"></a><a name="_Toc37572138"></a><a name="_Toc37572098"></a><a
name="_Toc37571859"></a><a name="_Toc37571586"></a><a name="_Toc37571528">9.<span
style='font:7.0pt "Times New Roman"'> </span>SIP Status Codes</a></h1>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'>The following are the SIP status codes as of RFC3312</p>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<div align=left dir=ltr>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:41.4pt;border-collapse:collapse'>
<tr>
<td width=480 colspan=2 valign=top style='width:5.0in;border:solid windowtext 1.0pt;
border-bottom:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'><b>1XX -200 Informational</b></p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>100</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Trying</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>180</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Ringing</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>181</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Call Is Being Forwarded</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>182</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Queued</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>183</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Session Progress</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>200</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>OK</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>202</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>OK</p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<div align=left dir=ltr>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:41.4pt;border-collapse:collapse'>
<tr>
<td width=480 colspan=2 valign=top style='width:5.0in;border:solid windowtext 1.0pt;
border-bottom:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'><b>3XX Redirection</b></p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>300</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Multiple Choices</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>301</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Moved Permanently</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>303</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>See Other</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>305</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Use Proxy</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>380</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Alternative Service</p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<div align=left dir=ltr>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:41.4pt;border-collapse:collapse'>
<tr>
<td width=480 colspan=2 valign=top style='width:5.0in;border:solid windowtext 1.0pt;
border-bottom:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'><b>4XX Client-Error</b></p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>400</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Bad Request</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>401</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Unauthorized</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>402</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Payment Required</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>403</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Forbidden</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>404</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Not Found</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>405</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Method Not Allowed</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>406</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Not Acceptable</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>407</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Proxy Authentication Required</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>408</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Request Timeout</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>409</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Conflict</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>410</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Gone</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>411</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Length Required</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>413</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Request Entity Too Large</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>414</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Request-URI Too Large</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>415</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Unsupported Media Type</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>420</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Bad Extension</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>480</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Temporarily not available</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>481</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Call Leg/Transaction does not exist</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>482</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Loop Detected</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>483</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Too Many Hops</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>484</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Address Incomplete</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>485</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Ambiguous</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>486</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Busy Here</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>487</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Request Terminated</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>488</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Not Acceptable Here</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>489</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Bad Event</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>491</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Request Pending</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>493</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Undecipherable</p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<div align=left dir=ltr>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:41.4pt;border-collapse:collapse'>
<tr>
<td width=480 colspan=2 valign=top style='width:5.0in;border:solid windowtext 1.0pt;
border-bottom:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'><b>5XX Server-Error</b></p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>500</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Internal Server Error</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>501</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Not Implemented</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>502</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Bad Gateway</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>503</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Service Unavailable</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>504</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Gateway Time-out</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>505</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>SIP Version not supported</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>513</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Message Too Large</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>580</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Precondition Failure</p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<div align=left dir=ltr>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:41.4pt;border-collapse:collapse'>
<tr>
<td width=480 colspan=2 valign=top style='width:5.0in;border:solid black 1.0pt;
border-bottom:none;padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'><b>6XX Global-Failure</b></p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>600</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid black 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Busy Everywhere</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>603</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid black 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Decline</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>604</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid black 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Does Note Exist Anywhere</p>
</td>
</tr>
<tr>
<td width=132 valign=top style='width:99.0pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal align=center dir=LTR style='text-align:center;direction:
ltr;unicode-bidi:embed'>606</p>
</td>
<td width=348 valign=top style='width:261.0pt;border-top:none;border-left:
none;border-bottom:solid black 1.0pt;border-right:solid black 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'>Not Acceptable</p>
</td>
</tr>
</table>
</div>
<p class=MsoNormal dir=LTR style='margin-left:.5in;text-align:left;direction:
ltr;unicode-bidi:embed'> </p>
<p class=MsoNormal dir=LTR style='text-align:left;direction:ltr;unicode-bidi:
embed'><span lang=HE dir=RTL> </span></p>
</div>
</body>
</html>