[Pkg-voip-commits] r6641 - /asterisk/trunk/debian/README.Debian

Wed Jan 7 22:29:24 UTC 2009

Author: tzafrir-guest
Date: Wed Jan  7 22:29:24 2009
New Revision: 6641

URL: http://svn.debian.org/wsvn/pkg-voip/?sc=1&rev=6641
Log:
Document the lines needed to be added to modules.conf to prevent 
crash at start-up when not using the default modules.conf .

Modified:
    asterisk/trunk/debian/README.Debian

Modified: asterisk/trunk/debian/README.Debian
URL: http://svn.debian.org/wsvn/pkg-voip/asterisk/trunk/debian/README.Debian?rev=6641&op=diff
==============================================================================

--- asterisk/trunk/debian/README.Debian (original)
+++ asterisk/trunk/debian/README.Debian Wed Jan  7 22:29:24 2009
@@ -2,6 +2,8 @@
 and probably one of the feature-richest open-source PBXes out there. To get you
 a brief impression where to start tweaking, we've included this doc. (Thanks to
 Tzafrir Cohen for a proposal of this)
+
+
 
 File Locations
 ==============
@@ -43,6 +45,7 @@
 group-owned voicemail files. To change this value, set the value if 'UMASK'
 in /etc/default/asterisk .
 
+
 Getting started with config and more features
 =============================================
 Of course the default config is far from a plug'n'play for every environment.
@@ -58,8 +61,41 @@
 	http://www.asteriskdocs.org/ (Asterisk Handbook)
 
 
+Duplicate Modules
+=================
+The Asterisk package includes two versions of the directory app module 
+and three versions of the voicemail app module:
+
+  app_directory.so        directory using voicemail.conf
+  app_directory_odbc.so   directory using ODBC database configuration
+
+  app_voicemail.so        voicemail stored under /var/spool/asterisk/voicemail
+  app_voicemail_imap.so   voicemail stored on an IMAP server
+  app_voicemail_odbc.so   voicemail stored in a database
+
+With most configurations (as with the default configuraiton) Asterisk 
+will try to autoload all modules in the modules directory. However 
+only one directory module and one voicemail module can be loaded. If 
+Asterisk tries to load the second one it will fail, and Asterisk will 
+fail to load.
+
+For that reason, the default modules.conf has:
+
+  [modules]
+  ; ...
+  noload => app_directory_odbc.so
+  noload => app_voicemail_imap.so
+  noload => app_voicemail_odbc.so
+
+However there's naturally no guarantee that you use that defualt 
+configuration. Thus if you write your own custom configuration, make 
+sure you either don't use autoload, or use the above lines or similar 
+lines in the section '[modules]' in /etc/asterisk/modules.conf to 
+prevent duplicate modules from being loaded.
+
+
 Open Files Limit
-===============
+================
 Asterisk uses one file-handle (and sometimes more) per call. Hence if you 
 have many simultaneous calls, you often bump into the per-process limit 
 of 1024 file handles, and get the error: "Too man open files".
@@ -67,6 +103,40 @@
 To enlarge that limit, set: MAXFILES in /etc/default/zaptel.
 
 
+Crashes At Startup
+==================
+While this should not happen if you use the packages (well, except the 
+above issue) it could still happen when mixing a source installation
+and an installation from packages.
+
+As mentioned above, you can debug the startup sequence using:
+
+  /etc/init.d/asterisk debug
+
+Which is essentially in the lines of:
+
+  asterisk -U asterisk -vvc
+
+Often reducing the number of 'v'-s makes the actual error more aparant, as
+Asterisk is very verbose:
+
+  asterisk -U asterisk -c
+
+If Asterisk started successfully you get to the prompt '*CLI>' . To stop
+Asterisk from there, press ctrl-c or run 'stop now' from the command 
+prompt.
+
+The effect of a module that has failed to load may be confusing, as you
+may only see the message about loading the module right before it.
+In this case strace could be a valueble tool:
+
+  strace asterisk -U asterisk -cvv
+
+Or, to trace the daemon:
+
+  strace -f asterisk -U asterisk -Fvv
+
+
 Enjoy your PBX!
 
 Kilian Krause (for the pkg-voip team)


