[Asterisk-Users] Outline For Asterisk Book - Please Review & Comment

Steven Critchfield critch at basesys.com
Fri Nov 21 13:46:43 MST 2003


How about this whole discussion getting a mailing list of it's own. I do
want to contribute, and would join a new mailing list for this, but
would like to take it out of the -users list to cut down on volume and
get to answering questions easier.

On Fri, 2003-11-21 at 11:34, Steven Sokol wrote:
> Asterisk Users
> 
> In an attempt to help Asterisk move forward, a number of us have decided
> to create a book.  It would initially be released as an "ebook" that
> could be sent to newbies to help them up the rather steep learning
> curve.  Ultimately I would like to see it published and sold in
> bookstores (preferably by O'Reilly & Co.).
> 
> Below is the outline for the book.  We REALLY need as much input as we
> can get.  I would like to completely flesh-out the outline, then I would
> like to start accepting submissions from the user community for each of
> the sections/chapters/topics covered in the outline.
> 
> I have to stress here that I AM NOT AN ASTERISK GURU.  I need help from
> the real gurus (especially: Steven Critchfield, John Todd, Tilghman
> Lesher, Olle Johansson, and where possible/necessary Mark and Martin).
> 
> If this works, it will help Asterisk achieve the same kind of global
> success as Apache, Samba, and other Linux staples.  If you want to chat,
> I am lurking in the #asterisk-doc channel on Freenode IRC.  I'm
> 'ssokol'.  Others on this project (so far) are Jared Smith and Leif
> Madson.
> 
> A "living" copy of this outline can be found at:
> http://www.sokol-associates.com/outline.htm .  I will try to update it
> daily with your suggestions.  It will also be the basis for the project
> outline (completion %, assignments, etc.).
> 
> Thanks,
> 
> Steve Sokol
> Sokol & Associates, LLC
> 
> [Outline Guide]
> The following outline describes the layout for the book.
> 
> 1. <- Section
> 	a. <- Chapter
> 		1) <- Sub-Chapter
> 			i.  <- Topic Heading
> 			*.  <- Sidebar Heading
> 			1}  <- Graphic or Chart
> 			1>  <- Table
> 
> [Outline]			
> 1.  Introduction to Asterisk
> 	a.  Introductory letter from Mark Spencer
> 		1)  Whatever Mark has to say...
> 		2)  Digium Reference Information
> 			i.  Web Site
> 			ii. Phone Number
> 	b.  The Business Case For Asterisk
> 		[Somebody From The Business Side Writes This]
> 	c.  General concept of asterisk
> 		1) Asterisk: Swiss Army Knife of Telephony
> 		2) PBX, IVR, ACD
> 		3) What To Expect
> 			i.   Asterisk Is Not A Turnkey System
> 			ii.  Don't Like It?  Change It Yourself.
> 			iii. Opensource, GPL and LGPL Licensing
> 	d.  Asterisk architecture
> 		1)  The Big Picture
> 		2)  Channels
> 		3)  Codec Conversions
> 		4)  Etc.
> 	e.  Key components
> 		1) Asterisk software
> 			i.   Asterisk (Main PBX & Channels)
> 			ii.  Zaptel (Drivers for Zaptel Hardware)
> 			iii. Libpri (ISDN PRI Drivers for Zaptel)
> 		2) Zaptel Hardware
> 			i.   Overview
> 			ii.  X100P - Single Port FXO Line Interface
> 			iii. S100U - Single Port FXS USB Interface
> 			iv.  TDM400P - 4 Port FXS Analog Interface
> 			v.   T100P - Single Span T1/E1 Interface
> 			vi.  TE410P - Quad-Span T1/E1 Interface
> 		3) Channels
> 			i.   Zaptel Devices/Channels
> 			ii.  The IAX Protocol
> 			iii. SIP
> 			iv.  MGCP
> 			v.   Skinny
> 			vi.  H323
> 		4) Applications
> 			i.   Dial and Other Basics
> 			ii.  Voicemail
> 			iii. Dial-Plan Scripting
> 		5) Extensibility
> 			i.   AGI
> 			ii.  Custom Applications
> 	f.  Add-On/Optional Components
> 		1) Software
> 			i.   Gnophone
> 			ii.  VoIP Soft Phones
> 			iii. DIAX
> 			iv.  Gastman
> 			v.   Open H.323
> 		2) Hardware
> 			i.   VoIP Hard-Phones
> 			ii.  VoIP Gateways
> 			ii.  Channel Banks
> 
> 2.  Installing Asterisk
> 	*.  Asterisk Quickstart
> 		1)  Install PC Hardware
> 		2)  Download Asterisk Software
> 		3)  Build Asterisk
> 		4)  Install Asterisk
> 		5)  Configure Autostart
> 		
> 	a.  Requirements
> 		*)  Picking A Solid System
> 		1)  PC Hardware Requirements
> 			i.   SOHO/Residential System
> 			ii.  Small Business System
> 			iii. Medium Business/Small Call-Center System
> 			iv.  Enterprise System
> 			v.   VoIP Carrier System
> 		2) Linux Requirements
> 			*.   Linux Installation Is Not Covered
> 			i.   Tested Distributions
> 			ii.  Minimum Kernel Version
> 			iii. Required Packages 
> 			*.   Other Operating Systems
> 				- Free BSD
> 				- Mac OS-X
> 				- BeOS?
> 				- Win32/Win64?
> 	b.  Hardware Installation
> 		1)  IRQ Sharing Issues
> 		2)  Digium Wildcard Cards
> 		3)  LineJack and PhoneJack Cards
> 		4)  Other Cards (ISDN, VoiceTronix, Etc.)
> 	c.  Downloading Asterisk from CVS
> 		1)  What is CVS?
> 		2)  The Asterisk "Versioning" Issues
> 		3)  Your Initial Download
> 		4)  Updates
> 		*.  Adding Custom Patches (patch/diff)
> 	d.  Compiling Asterisk
> 		*)  Why Do I Have To Compile The Code?
> 		1)  Using 'make'
> 		2)  Compiling The Software
> 			i.   Zaptel
> 			ii.  Libpri
> 			iii. Asterisk
> 		3)  Making The Samples/Demo
> 		4)  Making Code Documentation (Doxygen)
> 			i.   Why build code documentation?
> 			ii.  What Is Doxygen?
> 			iii. Code Doc Layout
> 		5)  Common Build Errors/Warnings
> 			i.   Via C3 Is NOT An i686
> 			ii.  Building on Little-Endian Systems
> 			iii. Etc.
> 	e.  Loading drivers (zaptel/ztdummy)
> 		*)  Read Ahead (Section 3, Chapter C1) For Zaptel Setup
> 		1)  Linux Kernel Loadable Modules
> 		2)  Using modprobe
> 		3)  Adding zaptel modules to your startup file
> 		*)  RedHat Is Weird
> 	f.  Starting Asterisk
> 		1)  Manual Starting and the CLI
> 		2)  Starting using safe_asterisk
> 		3)  Accessing the CLI when Asterisk Is Running
> 		4)  Logging/Tracing and Verbose
> 	g.  Configuring Autostart w/ safe_asterisk
> 		1)  Linux Runlevels (the init sequence)
> 		2)  Modifying The Startup Manually
> 		*)  RedHat Is Still Weird
> 
> 3.  Basic Asterisk Configuration
> 	*.  Overview Of Asterisk Configuration
> 		1) System Layout
> 		2) Configuration Files
> 		3) Command Line Interface
> 	a.  File Layout (The Asterisk Directory Structure)
> 		1) /etc/asterisk
> 		2) /var/lib/asterisk
> 		3) /var/spool/asterisk
> 		4) Etc...
> 	b.  .conf files
> 		1) What Is A .conf File?
> 		2) Common File Structures
> 		3) Reloading Asterisk Configuration
> 	c.  Configuring Phones & Channels
> 		1)  The zapata.conf File
> 			[All About zaptel/tormenta configuration]
> 		2)  The IAX.conf File
> 			i.  ?? - Anbyody Know This Well?
> 		3)  The sip.conf File
> 			i.   The General Section
> 			ii.  Supported Codecs/Codec Order
> 			iii. Registration of "peers"
> 			iv.  SIP Device Entries
> 			v.   Unsupported codecs/G729.a/b
> 			vi.  Common SIP Devices
> 				a)  Cisco 79XX Phones
> 				b)  Cisco ATA-186 Adapter
> 				c)  Grandstream Phones
> 				d)  SNOM Phones
> 				e)  Xten X-Lite/X-Pro
> 				f)  SoftJoy SJ-Phone
> 			*.   Asterisk and 'Reinvite'
> 		3)  The oh323.conf File
> 			i.  ?? - Anybody Know This Well?
> 		4)  The skinny.conf File
> 			i.  ?? - Anybody Know This Well?
> 		5)  CAPI/ISDN?
> 			i.  ?? - Anybody Know This Well?
> 	d.  Configuring Applications
> 		1)  Music On Hold: The moh.conf File
> 			a) Don't Forget The Timing (Part A)
> 		2)  Voicemail: The voicemail.conf File
> 			a) Basic SMTP Configuration
> 		3)  Meet-Me:  The meetme.conf File
> 			a) Don't Forget The Timing (Part B)
> 	e.  Configuring Your Dialplan
> 		*)  The Dialplan: Center Of The System
> 		1)  Everything Is An Extension
> 		2)  Basics Of Pattern Matching
> 		3)  Keeping It All In Context
> 		*)  Security, Toll-Fraud and Asterisk
> 		4)  Creating Outbound Calling "Extensions"
> 		5)  Creating User (Station/Channel) Extensions
> 		6)  Creating Application Extensions
> 	f.  Sample Configurations
> 		[LOTS OF SAMPLES HERE]
> 		
> 4.  Common Issues
> 	a.  Music On Hold/MP3 Playback
> 		1) Proper Version of MPG123
> 		2) Zaptel Timer or Ztdummy
> 	b.  DTMF Over SIP
> 		1)  Inband Only Works On G.711 MuLaw/ALaw
> 		2)  SIP-INFO
> 		3)  RFC___?
> 		4)  The "Flash"
> 	c.  Internationalization of Asterisk
> 		1)  Tones and Ringback
> 		2)  Call Supervision
> 	d.  SIP and NAT
> 	e.  Optional/Added Codecs
> 		1) G.729
> 		2) G.723
> 	f.  Message Waiting Indication
> 	g.  SIP Service Provider Issues
> 		1) Free World Dialup (FWD)
> 		2) Iconnect
> 		3) Sipphone
> 		4) NuFone
> 	h.  Common Hardware Device Issues
> 		1) Grandstream BT100 Series
> 		2) Cisco ATA-186
> 		3) Cisco 79XX Series Phones
> 		4) SNOM VoIP Phones
> 		5) Carrier Access Channel Banks
> 	*.  How to politely use the Asterisk-Users List
> 	*.  How to politely use the Asterisk IRC channel
> 
> 5.  Advanced Asterisk Configuration
> 	a.  Agents and the Asterisk ACD
> 	b.  Text-To-Speech: Festival
> 	c.  CLASS Features (John Todd?)
> 	d.  Fax (Software Fax)
> 	e.  Sphinx Speech Recognition (ASR)
> 		
> 6.  Scripting And AGI Extensions to Asterisk
> 	a.  What Is AGI?
> 	b.  What Languages Can I Use
> 	c.  
> 	AGI In: c, perl, php, etc.
> 7.  Creating Asterisk Applications In C
> 
> 8.  Appendicies	
> 	a. Sources Of Additional Information
> 		1) Digium Site/Asterisk Site
> 		2) The Asterisk WiKi
> 		3) The Asterisk-User and Asterisk-Dev Lists
> 		4) The #Asterisk IRC Channel
> 	b. Glossary of Asterisk & Telecom Terms
> 		[Large Glossary Of Asterisk & Telecom Terms]
> 	c. Applications Reference
> 		[Detailed Explanation Of All "Standard" Applications]
> 	d. CLI Commands Reference
> 		[Detailed Explanation Of All CLI Commands]
> 	e. Manager Commands Reference
> 		[Detailed Explanation Of All Manager Commands/Events]
> 	f. The Asterisk C API Reference
> 		[Some Detail On The ast_ functions]
> 
> 
> _______________________________________________
> Asterisk-Users mailing list
> Asterisk-Users at lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users
-- 
Steven Critchfield  <critch at basesys.com>




More information about the asterisk-users mailing list