- Spelling checked
[sip-router] / doc / serfaq / serfaq.sgml
1 <!-- $Id$ -->
2 <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
3
4 <!-- Include general SER documentation entities -->
5 <!ENTITY % serentities SYSTEM "../ser_entities.sgml">
6
7 <!ENTITY % licensing SYSTEM "licensing.sgml">
8 <!ENTITY % serweb SYSTEM "serweb.sgml">
9
10 %serentities;
11
12 ]>
13
14 <book>
15     <bookinfo>
16         <title>&ser; Frequently Asked Questions</title>
17         <authorgroup>
18             <editor>
19                 <firstname>Jan</firstname>
20                 <surname>Janak</surname>
21                 <email>jan@iptel.org</email>
22             </editor>
23         </authorgroup>
24         <copyright>
25             <year>2003</year>
26             <holder>&fhg;</holder>
27         </copyright>
28         <abstract>
29             <para>
30                 A compilation of questions and answers from <email>serhelp@iptel.org</email>,
31                 <email>serusers@iptel.org</email>, and <email>serdev@iptel.org</email> mailing
32                 lists.
33             </para>
34         </abstract>
35     </bookinfo>
36     <toc></toc>
37     
38     <chapter>
39         <title>General</title>
40         <qandaset>
41             <qandaentry>
42                 <question>
43                     <simpara>
44                         Is it possible to use &ser; as a &sip; user agent (both of User Agent Client
45                         (&uac;) and User Agent Server (&uas;)?
46                     </simpara>
47                 </question>
48                 <answer>
49                     <simpara>
50                         Not easily. &ser; has built-in some functions that allow to use it as user
51                         agent, but our primary goal is to develop a server so this is without
52                         guarantee and can even disappear in future versions.
53                     </simpara>
54                 </answer>
55             </qandaentry>
56             <qandaentry>
57                 <question>
58                     <simpara>
59                         Can &ser; work well together with some of the location server (e. g.LDAP or DNS) ?
60                     </simpara>
61                 </question>
62                 <answer>
63                     <simpara>
64                         &ser;'s built-in location server uses in-<acronym>RAM</acronym> database for
65                         high performance and optionally MySQL for persistence. More database
66                         protocols may be supplied on contractual basis. As far as I know,
67                         <acronym>DNS</acronym> is not used in the industry for user location.
68                     </simpara>
69                 </answer>
70             </qandaentry>
71             <qandaentry>
72                 <question>
73                     <simpara>
74                         What is a proxy server ?
75                     </simpara>
76                 </question>
77                 <answer>
78                     <simpara>
79                         A proxy server is an entity that routes &sip; messages. See &sip
80                         introduction which is part of the distribution.
81                     </simpara>
82                 </answer>
83             </qandaentry>
84             <qandaentry>
85                 <question>
86                     What is the difference between proxy server and back to back user agent (B2BUA) ?
87                 </question>
88                 <answer>
89                     <simpara>
90                         The main difference is that proxy servers are transaction-stateful, while
91                         B2BUAs are call stateful. That means proxy servers keep state only during
92                         &sip; transactions (that is at the beginning and and of a call) and do not
93                         keep any state during the whole call.
94                     </simpara>
95                     <simpara>
96                         A B2BUA acts merely as connection of two or more user agents which are
97                         connected through some means. B2BUAs keep some state (usually some structures
98                         in the memory) during the whole call.
99                     </simpara>
100                     <para>
101                         This property gives B2BUA some interesting features that proxies don't
102                         have. For example B2BUA can tear down and existing call--proxies can't do
103                         that. On the other hand B2BUAs can easily become a bottleneck in terms of
104                         scalability.
105                     </para>
106                 </answer>
107             </qandaentry>
108             <qandaentry>
109                 <question>
110                     <simpara>
111                         So is &ser; proxy or B2BUA ? Can it terminate an existing call ?
112                     </simpara>
113                 </question>
114                 <answer>
115                     <simpara>
116                         &ser; is a proxy. I can't terminate existing call.
117                     </simpara>
118                 </answer>
119             </qandaentry>
120             <qandaentry>
121                 <question>
122                     <simpara>
123                         I'd like to know if &ser; supports <acronym>CPL</acronym> and
124                         servlets. Where can I find any documentation about this, or any link ?
125                     </simpara>
126                     </question>
127                     <answer>
128                     <simpara>
129                         Yes, <acronym>CPL</acronym> is supported through cpl module, the module
130                         needs an external <acronym>CPL</acronym> interpreter written in Java. A C
131                         version is under development. There is no support for Java servlets. The
132                         documentation can be found at <ulink
133                         url="http://iptel.org/ser/doc">http://iptel.org/ser/doc</ulink>.
134                     </simpara>
135                 </answer>
136             </qandaentry>
137             <qandaentry>
138                 <question>
139                     <simpara>
140                         I wanted to know whether &lt;PUT_YOUR_FAVOURITE_METHOD_HERE&gt; is supported
141                         by &ser;.
142                     </simpara>
143                 </question>
144                 <answer>
145                     <simpara>
146                         Proxy server are indifferent of non-INVITEs methods. &lt;METHOD&gt; works as
147                         good as BYE, INFO, and FOOBAR.
148                     </simpara>
149                 </answer>
150             </qandaentry>
151             <qandaentry>
152                 <question>
153                     <simpara>
154                         I was wondering if &ser; has been tested and is supported on FreeBSD ?
155                     </simpara>
156                 </question>
157                 <answer>
158                     <simpara>
159                         Yes.
160                     </simpara>
161                 </answer>
162             </qandaentry>
163             <qandaentry>
164                 <question>
165                     <simpara>
166                         Does &ser; support <acronym>TCP</acronym> ?
167                     </simpara>
168                 </question>
169                 <answer>
170                     <simpara>
171                         Yes.
172                     </simpara>
173                 </answer>
174             </qandaentry>
175             <qandaentry>
176                 <question>
177                     <simpara>
178                         I think I found a bug that should be fixed, what information should I send
179                         and where should I send it?
180                     </simpara>
181                 </question>
182                 <answer>
183                     <simpara>
184                         Please send us as much info as possible. We would like see the following:
185                     </simpara>
186                     <itemizedlist>
187                         <listitem>
188                             <simpara>&ser; version (ser -V).</simpara>
189                         </listitem>
190                     </itemizedlist>
191                     <itemizedlist>
192                         <listitem>
193                             <simpara>Configuration file.</simpara>
194                         </listitem>
195                     </itemizedlist>
196                     <itemizedlist>
197                         <listitem>
198                             <simpara>&sip; message dumps.</simpara>
199                         </listitem>
200                     </itemizedlist>
201                     <itemizedlist>
202                         <listitem>
203                             <simpara>Coredump (if any, if not please generate it).</simpara>
204                         </listitem>
205                     </itemizedlist>
206                     <itemizedlist>
207                         <listitem>
208                             <simpara>Anything else you think might help us.</simpara>
209                         </listitem>
210                     </itemizedlist>
211                     <itemizedlist>
212                         <listitem>
213                             <simpara>The whole compiled source tree.</simpara>
214                         </listitem>
215                     </itemizedlist>
216                     <simpara>
217                         Please send it to <email>serhelp@iptel.org</email>.
218                     </simpara>
219                 </answer>
220             </qandaentry>
221             <qandaentry>
222                 <question>
223                     <simpara>
224                         How does &ser; scale ?
225                     </simpara>
226                     <simpara>
227                         &ser; is able to handle thousands calls per second on a regular
228                         <acronym>PC</acronym>.
229                     </simpara>
230                 </question>
231             </qandaentry>
232             <qandaentry>
233                 <question>
234                     <simpara>
235                         I read <quote>Throughput thousands of calls per second
236                             (<acronym>CPS</acronym>) on a dual-<acronym>CPU</acronym>
237                             <acronym>PC</acronym></quote> on your webpage. How fast is it really ?
238                     </simpara>
239                 </question>
240                 <answer>
241                     <simpara>
242                         Last time we have  checked ~4900cps on a dual Athlon MP2000.
243                     </simpara>
244                     <simpara>
245                         This was ser 0.8.9 running statefully (stateless is should be much faster),
246                         with 4 processes and 256 Mb shared mem.  It was compiled with: STATS:Off,
247                         USE_IPV6, NO_DEBUG, SHM_MEM, SHM_MMAP, PKG_MALLOC, F_MALLOC,
248                         FAST_LOCK-ADAPTIVE_WAIT ADAPTIVE_WAIT_LOOPS=1024, MAX_RECV_BUFFER_SIZE
249                         262144, MAX_LISTEN 16, MAX_URI_SIZE 1024, BUF_SIZE 3040
250                     </simpara>
251                 </answer>
252             </qandaentry>
253             <qandaentry>
254                 <question>
255                     <simpara>
256                         Do you think that &ser; is suitable for a commercial environment in your opinion ?
257                     </simpara>
258                 </question>
259                 <answer>
260                     <simpara>
261                         Sure.
262                     </simpara>
263                 </answer>
264             </qandaentry>
265             <qandaentry>
266                 <question>
267                     <simpara>
268                         Do you have any recommendations on additional open source or developer
269                         community resources to round out my platform?
270                     </simpara>
271                 </question>
272                 <answer>
273                     <simpara>
274                         I'm a &ser; believer and think that other servers simply don't compare :) If
275                         you wish more detailed propaganda, check our website and if that is not
276                         enough I will send you some more.
277                     </simpara>
278                 </answer>
279             </qandaentry>
280             <qandaentry>
281                 <question>
282                     <simpara>
283                         Do you have any thoughts on how it compares in deployability and features to
284                         the Vovida stuff or other options ? Also, are there any issues I should be
285                         thinking of that would make a commercial venture with &ser; difficult
286                         (licensing, scaling, etc..)
287                     </simpara>
288                 </question>
289                 <answer>
290                     <simpara>
291                         &ser; is licensed under &gnu; &gpl;. I would be surprised if any &sip;
292                         server available today would scale a bit better--we spent lot of work on
293                         performance, achieved thousands of <acronym>CPS</acronym> on a
294                         <acronym>PC</acronym>--I guess it will take lot of time until your demand
295                         hits this capacity.
296                     </simpara>
297                 </answer>
298             </qandaentry>
299             <qandaentry>
300                 <question>
301                     <simpara>
302                         Does &ser; have the capability to automatically send an INVITE from one
303                         number to another?
304                     </simpara>
305                 </question>
306                 <answer>
307                     <simpara>
308                         Yes if the phones support REFER. There is an application called
309                         Click-To-Dial which can connect two phones.
310                     </simpara>
311                 </answer>
312             </qandaentry>
313             <qandaentry>
314                 <question>
315                     <simpara>
316                         Is it necessary to have a <acronym>DNS SVR</acronym> Resource Record, as
317                         mentioned in the ser-Howto guide for connecting to &ser; ?
318                     </simpara>
319                 </question>
320                 <answer>
321                     <simpara>
322                         No. It's nice to have it, but you can work around it setting a normal A
323                         record for your domain. The <acronym>SRV</acronym> lookup will fall back to
324                         normal A lookup.
325                     </simpara>
326                 </answer>
327             </qandaentry>
328             <qandaentry>
329                 <question>
330                     <simpara>
331                         What would you charge to help get us started?
332                     </simpara>
333                 </question>
334                 <answer>
335                     <simpara>
336                         See <ulink url="http://iptel.org/support">http://iptel.org/support</ulink>.
337                     </simpara>
338                 </answer>
339             </qandaentry>
340             <qandaentry>
341                 <question>
342                     <simpara>
343                         Are you going to provide integration support from &sip; to H.323 and vice
344                         versa ?
345                     </simpara>
346                 </question>
347                 <answer>
348                     <simpara>
349                         No, we are not going to provide the integration.
350                     </simpara>
351                 </answer>
352             </qandaentry>
353             <qandaentry>
354                 <question>
355                     <simpara>
356                         I've gone thru the &ser; Admin's Guide and the module documentation
357                         (sip_router/modules/). Is there additional documentation on how to use the
358                         modules?
359                     </simpara>
360                 </question>
361                 <answer>
362                     <simpara>
363                         Each module has a doc subdirectory which contains complete documentation of
364                         the module in docbook format. <acronym>PS</acronym>, <acronym>PDF</acronym>
365                         and <acronym>HTML</acronym> renderings can be obtained through our web page,
366                         see <ulink url="http://iptel.org/ser/doc">http://iptel.org/ser/doc</ulink>.
367                     </simpara>
368                 </answer>
369             </qandaentry>
370             <qandaentry>
371                 <question>
372                     <simpara>
373                         What functions would I use in my ser.cfg to log <quote>missed calls</quote>?
374                     </simpara>
375                 </question>
376                 <answer>
377                     <simpara>
378                         FIXME.
379                     </simpara>
380                 </answer>
381             </qandaentry>
382             <qandaentry>
383                 <question>
384                     <simpara>
385                         Are there some additional requirements for using the acc.so module?  Radius?
386                         I want to be able to view dialed calls from serweb.
387                     </simpara>
388                 </question>
389                 <answer>
390                     <simpara>
391                         FIXME.
392                     </simpara>
393                 </answer>
394             </qandaentry>
395             <qandaentry>
396                 <question>
397                     <simpara>
398                         Do you have any example configs that use nathelper?
399                     </simpara>
400                 </question>
401                 <answer>
402                     <simpara>
403                         FIXME.
404                     </simpara>
405                 </answer>
406             </qandaentry>
407             <qandaentry>
408                 <question>
409                     <simpara>
410                         Who are the people behind &ser; ?
411                     </simpara>
412                 </question>
413                 <answer>
414                     <simpara>
415                         FIXME.
416                     </simpara>
417                 </answer>
418             </qandaentry>
419             <qandaentry>
420                 <question>
421                     <simpara>
422                         How successful has nathelper been with <acronym>NAT</acronym>/firewall transversal?
423                     </simpara>
424                 </question>
425                 <answer>
426                     <simpara>
427                         I only know that users reported success with nathelper and ATAs.
428                     </simpara>
429                 </answer>
430             </qandaentry>
431             <qandaentry>
432                 <question>
433                     <simpara>
434                         Does ser support <acronym>LDAP</acronym> ?
435                     </simpara>
436                 </question>
437                 <answer>
438                     <simpara>
439                         FIXME.
440                     </simpara>
441                 </answer>
442             </qandaentry>
443             <qandaentry>
444                 <question>
445                     <simpara>
446                         Is it possible to get access to iptel's working copy of ser.cfg?
447                     </simpara>
448                 </question>
449                 <answer>
450                     <simpara>
451                         We no longer disclose our operational policy to the public audience. The
452                         configuration file is only available to our customers under <acronym>NDA</acronym>.
453                     </simpara>
454                 </answer>
455             </qandaentry>
456             <qandaentry>
457                 <question>
458                     <simpara>
459                         Can you send me detail for me to sign up for the commercial program. I would
460                         also like detail on your levels of support you offer (ie...paid support)?
461                     </simpara>
462                 </question>
463                 <answer>
464                     <simpara>
465                         See <ulink
466                             url="http://iptel.org/support/">http://iptel.org/support/</ulink>. Don't
467                             hesitate to approach us if you have any further questions.
468                     </simpara>
469                 </answer>
470             </qandaentry>
471             <qandaentry>
472                 <question>
473                     <simpara>
474                         I need a method to determine if a called &uri; has an account on the system.
475                         I found a function in the groups module,
476                         <function>is_user_in</function>. but haven't yet figured out how to use it.
477                     </simpara>
478                 </question>
479                 <answer>
480                     <simpara>
481                         The uri module's <function>does_uri_exist</function> is what you are seeking.
482                     </simpara>
483                 </answer>
484             </qandaentry>
485             <qandaentry>
486                 <question>
487                     <simpara>
488                         We have a question regarding usrloc: where are the active sessions
489                         being stored? We were not able to find any entries in MySQL.
490                     </simpara>
491                 </question>
492                 <answer>
493                     <simpara>
494                         &ser; has no notion of active session. &ser; is a transaction-stateful proxy,
495                         that means it knows about transactions (INVITE transaction, BYE
496                         transaction), but it keeps no state if there is no transaction active.
497                     </simpara>
498                     <simpara>
499                         That means, it keeps state when an INVITE comes and until a final response
500                         to the INVITE is sent. The same for BYE.
501                     </simpara>
502                 </answer>
503             </qandaentry>
504             <qandaentry>
505                 <question>
506                     <simpara>
507                         Has the timeout for re-registering at the &ua; to be the same as in the tm
508                         module mentioned in <filename>ser.cfg</filename> ?
509                     </simpara>
510                 </question>
511                 <answer>
512                     <simpara>
513                         No.
514                     </simpara>
515                 </answer>
516             </qandaentry>
517             <qandaentry>
518                 <question>
519                     <simpara>
520                         How do we deal with aliases? If for example uid=mic is authenticated, he is
521                         available with sip address sip:mic@comnect.at. If I would want to be
522                         addressable with michael.dosser@comnect.at how is this accomplished with ser
523                         ?
524                     </simpara>
525                 </question>
526                 <answer>
527                     <simpara>
528                         Aliases are tied to user location. It uses a special table which has the
529                         same structure as user location table and includes an entry for each
530                         alias. You do not have to do something special for that. You have to create
531                         this table and then you can use serctl to add aliases.
532                     </simpara>
533                 </answer>
534             </qandaentry>
535             <qandaentry>
536                 <question>
537                     <simpara>
538                         I would like to know if &ser; supports <acronym>IPv6</acronym>. If not, do
539                         you have any plans for it ? When ?
540                     </simpara>
541                 </question>
542                 <answer>
543                     <simpara>
544                         Yes, &ser; supports <acronym>IPv6</acronym>.
545                     </simpara>
546                 </answer>
547             </qandaentry>
548             <qandaentry>
549                 <question>
550                     <simpara>
551                         Is there any way to change the default log file to a special SER.log file ?
552                     </simpara>
553                 </question>
554                 <answer>
555                     <simpara>
556                         Try logging to stderr and redirecting it to a file:
557                     </simpara>
558                     <screen format="linespecific">
559 ser -E     2>/tmp/ser.log
560 </screen>
561                     <simpara>
562                         (by default ser logs to syslog)
563                     </simpara>
564                 </answer>
565             </qandaentry>
566             <qandaentry>
567                 <question>
568                     <simpara>
569                         Does anybody know anything about the P-Hint Header Field added from &ser;?
570                     </simpara>
571                 </question>
572                 <answer>
573                     <simpara>
574                         <ulink url="http://www.iptel.org/ser/doc/seruser-html/c638.html#AEN729">
575                             http://www.iptel.org/ser/doc/seruser-html/c638.html#AEN729
576                         </ulink>
577                     </simpara>
578                 </answer>
579             </qandaentry>
580             <qandaentry>
581                 <question>
582                     <simpara>
583                         When using the Jabber Gateway, some users get the following error from time to
584                         time:
585                     </simpara>
586                     <simpara>
587                         ERROR: Connection to Jabber server lost. You have to login to Jabber server
588                         again (join again the conferences that you were participating, too).
589                     </simpara>
590                     <simpara>
591                         sip_to_jabber_gateway says:
592                     </simpara>
593                     <simpara>
594                         INFO: Your are now offline in Jabber network. Thank you for using &sip;-Jabber
595                         gateway.
596                     </simpara>
597                     <simpara>
598                         Do you know the reason why these messages appear and if it is possible to
599                         avoid them?
600                     </simpara>
601                 </question>
602                 <answer>
603                     <simpara>
604                         that usually occurs because Jabber server crashes or, for some unknown
605                         reasons, the <acronym>TCP</acronym> connection with jabber server is
606                         down. The second message is to inform the users that they are no more
607                         connected to Jabber network.
608                     </simpara>
609                     <simpara>
610                         There is no way to disable sending these messages. I may introduce a new
611                         parameter to enable/disable them. But I am not sure it is a good idea (users
612                         must be informed about the changes of the status).
613                     </simpara>
614                 </answer>
615             </qandaentry>
616             <qandaentry>
617                 <question>
618                     <simpara>
619                         I would like know if &ser; support also the transmission protocol
620                         <acronym>TCP</acronym>, or <acronym>TLS</acronym>.
621                     </simpara>
622                 </question>
623                 <answer>
624                     <simpara>
625                         Yes, &ser; supports <acronym>TCP</acronym>. <acronym>TLS</acronym> is work
626                         in progress.
627                     </simpara>
628                 </answer>
629             </qandaentry>
630             <qandaentry>
631                 <question>
632                     <simpara>
633                         I'm trying to rewrite the to domain, as in:
634                     </simpara>
635                     <simpara>
636                         To: &lt;sip:19723236598@augustvoice.net&gt; ;user=phone.
637                     </simpara>
638                     <simpara>
639                         I can't find any rewrite* function to rewrite the
640                         to domain.
641                     </simpara>
642                 </question>
643                 <answer>
644                     <simpara>
645                         The proxy is not supposed to touch To or From &uri;s. Only Request-&uri; can
646                         be changed.
647                     </simpara>
648                 </answer>
649             </qandaentry>
650             <qandaentry>
651                 <question>
652                     <simpara>
653                         When the messenger sends a message for the jabber gateway the following
654                         error occurs:
655                     </simpara>
656                     <simpara>
657                         <quote>ERROR: Your message was not sent. You do not have permissions to use the
658                             gateway.</quote>
659                     </simpara>
660                     <simpara>
661                         What could be the problem here?
662                     </simpara>
663                 </question>
664                 <answer>
665                     <simpara>
666                         You have to create the database for SIMPLE2Jabber gateway and after that you
667                         have to associate &sip; users with Jabber IDs.
668                     </simpara>
669                     <simpara>
670                         <ulink
671                             url="http://www.iptel.org/ser/doc/jabgw/xjab-manual.html#5._Admins_guide">
672                             http://www.iptel.org/ser/doc/jabgw/xjab-manual.html#5._Admins_guide
673                         </ulink>
674                     </simpara>
675                 </answer>
676             </qandaentry>
677             <qandaentry>
678                 <question>
679                     <simpara>
680                         Authentication doesn't work!!!  Where am I wrong?
681                     </simpara>
682                 </question>
683                 <answer>
684                     <simpara>
685                         Windows Messenger needs same string both realm and SIP_DOMAIN, and it wants
686                         to reach this address oh your network.
687                     </simpara>
688                 </answer>
689             </qandaentry>
690             <qandaentry>
691                 <question>
692                     <simpara>
693                         I was wondering whether there is a ser module for
694                         <acronym>SIP-CGI</acronym>. Or whether there are attempts at creating one?
695                     </simpara>
696                 </question>
697                 <answer>
698                     <simpara>
699                         There is no <acronym>SIP-CGI</acronym> module for &ser;. The most similar,
700                         though much simpler, functionality is provided by the exec module.
701                     </simpara>
702                 </answer>
703             </qandaentry>
704             <qandaentry>
705                 <question>
706                     <simpara>
707                         How could I integrate &sip; and H323 together?
708                     </simpara>
709                 </question>
710                 <answer>
711                     <simpara>
712                         You will need a &sip; to H.323 gateway. &ser; is a &sip; proxy only, it
713                         cannot act as H.323 gateway.
714                     </simpara>
715                 </answer>
716             </qandaentry>
717             <qandaentry>
718                 <question>
719                     <simpara>
720                         How can I contribute code ?
721                     </simpara>
722                 </question>
723                 <answer>
724                     <simpara>
725                         FIXME.
726                     </simpara>
727                 </answer>
728             </qandaentry>
729             <qandaentry>
730                 <question>
731                     <simpara>
732                         What, if anything, should the &ser; server do with a OPTIONS method?
733                     </simpara>
734                 </question>
735                 <answer>
736                     <simpara>
737                         FIXME.
738                     </simpara>
739                 </answer>
740             </qandaentry>
741             <qandaentry>
742                 <question>
743                     <simpara>
744                         What should I do to see the detailed debugs?
745                     </simpara>
746                 </question>
747                 <answer>
748                     <simpara>
749                         Set debug=9 in your config script.
750                     </simpara>
751                 </answer>
752             </qandaentry>
753             <qandaentry>
754                 <question>
755                     <simpara>
756                         Is it possible for &ser; to forward a call to another phone if the recipient
757                         does not answer?
758                     </simpara>
759                 </question>
760                 <answer>
761                     <simpara>
762                         This could be achieved with sequential forking (by trying contacts in
763                         decreasing q order), but sequential forking is not yet supported in &ser;.
764                     </simpara>
765                 </answer>
766             </qandaentry>
767             <qandaentry>
768                 <question>
769                     <simpara>
770                         Is it possible to configure &ser; so that it only has the latest
771                         registration?
772                     </simpara>
773                 </question>
774                 <answer>
775                     <simpara>
776                         FIXME.
777                     </simpara>
778                 </answer>
779             </qandaentry>
780             <qandaentry>
781                 <question>
782                     <simpara>
783                         mkdir: cannot create directory `/usr/local/etc/ser': Permission denied
784                         make: *** [/usr/local/etc/ser] Error 1
785                     </simpara>
786                     <simpara>
787                         what may be the error ?
788                     </simpara>
789                 </question>
790                 <answer>
791                     <simpara>
792                         You have no write permissions to the directory, try it again as root.
793                     </simpara>
794                 </answer>
795             </qandaentry>
796             <qandaentry>
797                 <question>
798                     <simpara>
799                         Can a proxy terminate a call ?
800                     </simpara>
801                 </question>
802                 <answer>
803                     <simpara>
804                         No, proxy cannot do that because it is transaction stateful only.
805                     </simpara>
806                 </answer>
807             </qandaentry>
808             <qandaentry>
809                 <question>
810                     <simpara>
811                         i want to know what accounting support is available using MySql. what
812                         settings need to be done? are any records generated and placed in the
813                         database? how do i access these records?
814                     </simpara>
815                 </question>
816                 <answer>
817                     <simpara>
818                         FIXME.
819                     </simpara>
820                 </answer>
821             </qandaentry>
822             <qandaentry>
823                 <question>
824                     <simpara>
825                         It seems that &ser; supports only strict routing. Please tell me if it
826                         supports loose routing. if yes, do i have to enable it somehow?
827                     </simpara>
828                 </question>
829                 <answer>
830                     <simpara>
831                         Yes, it does support loose routing as of 0.8.11, you don't have to enable it.
832                     </simpara>
833                 </answer>
834             </qandaentry>
835             <qandaentry>
836                 <question>
837                     <simpara>
838                         I need to know if currently generated call records can be put into MySql
839                         database. if yes, is there any tool available to view these records?
840                     </simpara>
841                 </question>
842                 <answer>
843                     <simpara>
844                         Serweb can do it.
845                     </simpara>
846                 </answer>
847             </qandaentry>
848             <qandaentry>
849                 <question>
850                     <simpara>
851                         If I want to use &ser; commercially do I need to purchase any license for
852                         the same, as long as I'm not going to charge the customer for the &sip;
853                         service but only for the termination of calls.
854                     </simpara>
855                 </question>
856                 <answer>
857                     <simpara>
858                         &ser; is distributed under the &gpl; so you don't need to purchase any
859                         license, you can use it freely.
860                     </simpara>
861                 </answer>
862             </qandaentry>
863             <qandaentry>
864                 <question>
865                     <simpara>
866                         Is there a support for accounting ?
867                     </simpara>
868                 </question>
869                 <answer>
870                     <simpara>
871                         Yes, see acc module.
872                     </simpara>
873                 </answer>
874             </qandaentry>
875             <qandaentry>
876                 <question>
877                     <simpara>
878                         What tool can I use to capture &sip; traffic ?
879                     </simpara>
880                 </question>
881                 <answer>
882                     <simpara>
883                         <ulink url="http://ngrep.sourceforge.net">ngrep</ulink>, <ulink
884                             url="http://www.ethereal.com">ethereal</ulink>, <ulink
885                             url="http:/www.tcpdump.org">tcpdump</ulink>.
886                     </simpara>
887                 </answer>
888             </qandaentry>
889             <qandaentry>
890                 <question>
891                     <simpara>
892                         Is there ENUM support in &ser; ?
893                     </simpara>
894                 </question>
895                 <answer>
896                     <simpara>
897                         Yes, see enum module.
898                     </simpara>
899                 </answer>
900             </qandaentry>
901             <qandaentry>
902                 <question>
903                     <simpara>
904                         Do you have any experience (or know) where I can get some info on setting up
905                         an ENUM testbed with <acronym>DNS</acronym> and Linux?
906                     </simpara>
907                 </question>
908                 <answer>
909                     <simpara>
910                         if by testbed you mean running your own e164.arpa root, then you simply
911                         make your dns server a root for e164.arpa domain by adding line
912                     </simpara>
913                     <programlisting format="linespecific">
914 primary         e164.arpa               e164.arpa.db
915 </programlisting>
916                     <simpara>
917                         into your named.boot file and then by populating file e164.arpa.db with
918                         your enum entries.  Below is an example.
919                     </simpara>
920                     <programlisting format="linespecific">
921 $ORIGIN .
922 $TTL 0  ; 0 seconds
923 e164.arpa               IN SOA  foo.fi. hostmaster.foo.fi. (
924                                 200204681  ; serial
925                                 28800      ; refresh (8 hours)
926                                 7200       ; retry (2 hours)
927                                 604800     ; expire (1 week)
928                                 86400      ; minimum (1 day)
929                         )
930                         NS      foo.fi.
931 $ORIGIN e164.arpa.
932 $ORIGIN 8.5.3.e164.arpa.
933 $ORIGIN 9.3.8.1.5.6.2.8.5.3.e164.arpa.
934 3.1   NAPTR   1 1 <quote>u</quote> <quote>E2U+sip</quote> <quote>!(^.*$)!sip:abc@bar.fi!i</quote> .
935 </programlisting>
936                 </answer>
937             </qandaentry>
938             <qandaentry>
939                 <question>
940                     <simpara>
941                         Will &ser; support <acronym>STUN</acronym> in the future?
942                     </simpara>
943                 </question>
944                 <answer>
945                     <simpara>
946                         <acronym>STUN</acronym> is a protocol operated separately from &ser;
947                     </simpara>
948                 </answer>
949             </qandaentry>
950             <qandaentry>
951                 <question>
952                     <simpara>
953                         Is there any way to show active calls (dialed number, duration, originating
954                         <acronym>IP</acronym>...) with &ser;?
955                     </simpara>
956                 </question>
957                 <answer>
958                     <simpara>
959                         No, ser is not call stateful.
960                     </simpara>
961                 </answer>
962             </qandaentry>
963             <qandaentry>
964                 <question>
965                     <simpara>
966                         If I'm working with &rfc2543; compliant phones (such as
967                         <acronym>ATA</acronym>) may I use loose routing?
968                     </simpara>
969                 </question>
970                 <answer>
971                     <simpara>
972                         Yes, loose routing is backwards compatible.
973                     </simpara>
974                 </answer>
975             </qandaentry>
976             <qandaentry>
977                 <question>
978                     <simpara>
979                         How can I configure radiator for digest authentication?
980                     </simpara>
981                 </question>
982                 <answer>
983                     <simpara>
984                         In case of radiator, you don't need to do anything special in the
985                         configuration.  Just install the latest radiator and then make sure your
986                         config can handle the service-types you have configured ser to use. For
987                         example, you can have
988                     </simpara>
989                     <programlisting format="linespecific">
990 &lt;Handler Service-Type=SIP&gt;
991 ...
992 &lt;/AuthBy&gt;
993 </programlisting>
994                     <simpara>
995                         Or whatever your strategy is.
996                     </simpara>
997                 </answer>
998             </qandaentry>
999             <qandaentry>
1000                 <question>
1001                     <simpara>
1002                         How can I configure radiator for digest authentication?
1003                     </simpara>
1004                 </question>
1005                 <answer>
1006                     <simpara>
1007                         see freeradius-0.8.1/doc/rlm_digest
1008                     </simpara>
1009                 </answer>
1010             </qandaentry>
1011             <qandaentry>
1012                 <question>
1013                     <simpara>
1014                         Trying to create alias, I am getting the following message:
1015                     </simpara>
1016                     <simpara>
1017                         <quote>400 Table 'aliases' Not Found</quote>
1018                     </simpara>
1019                 </question>
1020                 <answer>
1021                     <simpara>
1022                         You must have lookup(<quote>aliases</quote>) somewhere in your script.
1023                     </simpara>
1024                 </answer>
1025             </qandaentry>
1026
1027             <qandaentry>
1028                 <question>
1029                     <simpara>
1030                         Also how much shared memory does &ser; allocate by default?
1031                     </simpara>
1032                 </question>
1033                 <answer>
1034                     <simpara>
1035                         32 Mb.
1036                     </simpara>
1037                 </answer>
1038             </qandaentry>
1039             <qandaentry>
1040                 <question>
1041                     <simpara>
1042                         How can I identify what ser doesn't like about the config file?
1043                     </simpara>
1044                 </question>
1045                 <answer>
1046                     <programlisting format="linespecific">
1047 0(612) parse error (81,1-10): syntax error
1048 0(612) parse error (91,1-6):
1049                     ^^^^^^
1050 </programlisting>
1051                     <simpara>
1052                         These are the line number and the characters. So look in line 81 and 91 of
1053                         your config file for errors.
1054                     </simpara>
1055                 </answer>
1056             </qandaentry>
1057             <qandaentry>
1058                 <question>
1059                     <programlisting format="linespecific">
1060 Warning: 392 216.87.144.203:5060 "Noisy feedback tells:  pid=19604
1061 req_src_ip=216.87.144.205 req_src_port=5065 in_uri=sip:addaline.com
1062 out_uri=sip:addaline.com via_cnt==1".
1063 </programlisting>
1064                     <simpara>
1065                         I want to get rid of these?
1066                     </simpara>
1067                 </question>
1068                 <answer>
1069                     <simpara>
1070                         Use sip_warning=no
1071                     </simpara>
1072                 </answer>
1073             </qandaentry>
1074             <qandaentry>
1075                 <question>
1076                     <simpara>
1077                         Is &ser; a gatekeeper ?
1078                     </simpara>
1079                 </question>
1080                 <answer>
1081                     <simpara>
1082                         No, &ser; is a &sip; proxy.
1083                     </simpara>
1084                 </answer>
1085             </qandaentry>
1086             <qandaentry>
1087                 <question>
1088                     <simpara>
1089                         Is there an example of the session timer with &ser; somewhere?
1090                     </simpara>
1091                 </question>
1092                 <answer>
1093                     <simpara>
1094                         That's a theoretical &sip; option today, &ser; is not supporting
1095                         session-timer.  We gave it a try more than one year ago and gave up due to
1096                         interop problems.  The specification was developing at that time so quickly
1097                         that there was not any UA which would work with another one correctly.
1098                     </simpara>
1099                     <simpara>
1100                         Once the interoperability gets better, it could be worth implementing. It is
1101                         in general a nice mechanism for avoiding session state silo in network,
1102                         which is good for scalability.
1103                     </simpara>
1104                 </answer>
1105             </qandaentry>
1106             <qandaentry>
1107                 <question>
1108                     <simpara>
1109                         Could someone point me where I can read about this www_authorize()
1110                     </simpara>
1111                 </question>
1112                 <answer>
1113                     <simpara>
1114                         The documentation is in sip_router/modules/auth_db/doc
1115                     </simpara>
1116                     <simpara>
1117                         The function tries to verify user's credentials. It returns 1 if they are
1118                         correct and -1 if not.
1119                     </simpara>
1120                 </answer>
1121             </qandaentry>
1122             <qandaentry>
1123                 <question>
1124                     <simpara>
1125                         I'm new to &ser; and would like to set up a test lab with a couple different
1126                         ip phones / adapters to learn from. Could someone recommend a few devices
1127                         that we could use for that purpose?
1128                     </simpara>
1129                 </question>
1130                 <answer>
1131                     <simpara>
1132                         Hardphones: Grandstream, Cisco, ATA, Mitel, Pingtel, Snom
1133                     </simpara>
1134                     <simpara>
1135                         Softphones: kphone, Xten, Windows Messenger, Hotsip client.
1136                     </simpara>
1137                 </answer>
1138             </qandaentry>
1139             <qandaentry>
1140                 <question>
1141                     <simpara>
1142                         how can i configure my ser for multiple domains?
1143                         For example andrea@foo.bar and andrea@foo2.bar on the same server?
1144                     </simpara>
1145                 </question>
1146                 <answer>
1147                     <simpara>
1148                         If you are using 0.8.10, it is a manual process--copy and paste
1149                         <acronym>SQL</acronym> tables, have a table set for each served domain, and
1150                         refer to the table names from your scripts. E.g.,
1151                     </simpara>
1152                     <simpara>
1153                         if (uri=~"domain1.com") { lookup("domain1"); ...
1154                     </simpara>
1155                     <simpara>
1156                         With 0.8.11 you can automate the process quite a lot. Authorization
1157                         functions with realm set to empty value take domain name from &sip;
1158                         requests. User location database keeps track of domains as well. The
1159                         <quote>domain</quote> modules allows you to keep track of maintained domains
1160                         in a way which does not take changing scripts.
1161                     </simpara>
1162                     <simpara>
1163                         It is possible there are some magic options in domain/usrloc/auth_db/
1164                         registrar/auth modules you need to turn on to enable multidomain
1165                         operation--I don't remember these by heart, hopefuly some people
1166                         on the mailing list do.
1167                     </simpara>
1168                 </answer>
1169             </qandaentry>
1170             <qandaentry>
1171                 <question>
1172                     <simpara>
1173                         I am testing &ser; version 0.8.11pre29 with two <acronym>MSN</acronym>
1174                         Messenger(v4.6) clients. I tried to send the following MESSAGE through &ser;
1175                         with record-route header added by &ser;. However, the receiving
1176                         <acronym>MSN</acronym> client responded with a 400 Bad Request for that
1177                         message.
1178                     </simpara>
1179                 </question>
1180                 <answer>
1181                     <simpara>
1182                         It's <acronym>MSN</acronym> Messenger's bug--lr parameter is not
1183                         recognized as specified in &rfc3261;. Use
1184                     </simpara>
1185                     <simpara>
1186                         modparam(<quote>rr</quote>, <quote>enable_full_lr</quote>, 1)
1187                     </simpara>
1188                     <simpara>
1189                         in ser config file to make it working.
1190                     </simpara>
1191                 </answer>
1192             </qandaentry>
1193             <qandaentry>
1194                 <question>
1195                     <simpara>
1196                         I have got an H.323 Mediatrix <acronym>FXO</acronym> gateway. It is not &sip;
1197                         based. May I use it with &ser; ?
1198                     </simpara>
1199                 </question>
1200                 <answer>
1201                     <simpara>
1202                         No.
1203                     </simpara>
1204                 </answer>
1205             </qandaentry>
1206             <qandaentry>
1207                 <question>
1208                     <simpara>
1209                         It is possible to process the voicemail request on the same instance I use to
1210                         forward/register users ?
1211                     </simpara>
1212                 </question>
1213                 <answer>
1214                     <simpara>
1215                         Yes.
1216                     </simpara>
1217                 </answer>
1218             </qandaentry>
1219             <qandaentry>
1220                 <question>
1221                     <simpara>
1222                         How can I checkout the sources from the <acronym>CVS</acronym> ?
1223                     </simpara>
1224                 </question>
1225                 <answer>
1226                     <simpara>
1227                         FIXME.
1228                     </simpara>
1229                 </answer>
1230             </qandaentry>
1231             <qandaentry>
1232                 <question>
1233                     <simpara>
1234                         Are there any binary packages available ?
1235                     </simpara>
1236                 </question>
1237                 <answer>
1238                     <simpara>
1239                         FIXME.
1240                     </simpara>
1241                 </answer>
1242             </qandaentry>
1243             <qandaentry>
1244                 <question>
1245                     <simpara>
1246                         What is symmetric signaling ?
1247                     </simpara>
1248                 </question>
1249                 <answer>
1250                     <simpara>
1251                         FIXME.
1252                     </simpara>
1253                 </answer>
1254             </qandaentry>
1255             <qandaentry>
1256                 <question>
1257                     <simpara>
1258                         What is &sip;, <acronym>SIMPLE</acronym>, &sdp;, Proxy, Registrar, Redirect server ?
1259                     </simpara>
1260                 </question>
1261                 <answer>
1262                     <simpara>
1263                         FIXME.
1264                     </simpara>
1265                 </answer>
1266             </qandaentry>
1267             <qandaentry>
1268                 <question>
1269                     <simpara>
1270                         &ser; starts normally with the default <filename>ser.cfg</filename>. When I
1271                         uncommented the line load module
1272                         <quote>/usr/local/lib/ser/modules/mysql.so</quote> to load mysql.so,
1273                         everything seems normally. But actually, ser stops abnormally.
1274                     </simpara>
1275                 </question>
1276                 <answer>
1277                     <simpara>
1278                         mysql module is excluded from compilation/installation by default
1279                         (dependencies issue). You can compile it separately with: make modules
1280                         modules=modules/mysql. Also, you can add it in the list of the default
1281                         compiled modules with: make all include_modules=<quote>mysql</quote>.  Then
1282                         use: make install include_modules=<quote>mysql</quote>. To install only the
1283                         modules: make install-modules include_modules=<quote>mysql</quote> or only
1284                         the mysql module: make install-modules modules=modules/mysql.
1285                     </simpara>
1286                 </answer>
1287             </qandaentry>
1288
1289             <qandaentry>
1290                 <question>
1291                     <simpara>
1292                         Is ser compatible with MySQL 4.x ?
1293                 </simpara>
1294                 </question>
1295                 <answer>
1296                     <simpara>
1297                         Yes.
1298                     </simpara>
1299                 </answer>
1300             </qandaentry>
1301
1302         </qandaset>
1303     </chapter>
1304 </book>