thr3ads.net - asterisk users - [Asterisk-Users] Outline For Asterisk Book

If this information is useful, please help other people find it:
Share via:

Steven Sokol

2003-Nov-21 10:34 UTC

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

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]

Steven Critchfield

2003-Nov-21 11:16 UTC

head link

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

Especially with respect to a Orieley & co book, think about a removable
card that lists in short description the applications and the arguments.
This could be the item that gets taped to the side of the monitor of the
new user trying to lay out his dialplan.

On Fri, 2003-11-21 at 11:34, Steven Sokol wrote:> 	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
Suggest that e-2 be removed and merged under this heading. Other than
mentioning of capabilities there is no need for a chapter devoted to
them. Add to that that you can then make the case for buying Diguim
hardware with the channel driver comments.
> 			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@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users-- 
Steven Critchfield  <critch@basesys.com>

Michael Manousos

2003-Nov-21 11:46 UTC

head link

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

Hi Steven,

I think this is a great idea and the best way to make
users more familiar with Asterisk and its configuration and usage.
I can and will provide input for all H.323 related sections.

Michael.

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@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users

asterisk@lists.styx.org

2003-Nov-21 13:09 UTC

head link

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

Great idea!

I would also like to see some discussion of ISDN BRI and CAPI
hardware, as well as some discussion of "distributed asterisk"
what happens when you start deploying a network of many asterisk
boxes, how to do forwarding and switching properly, TDMoE as well as
E164 enum call routing -- on the latter I can perhaps contribute
some text now that I have gotten it to work properly ;)

Cheers,
Will

Johnson, Randy

2003-Nov-21 13:24 UTC

head link

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

This is a great development.  What a good way to develop a book for a great
piece of software!  I had an ouline slowly developing as my Asterisk
implementations broadened, but now I'll jump on board behind yours.  I am
not an Asterisk guru either, but I'll contribute as I can.  Some initial
suggestions are in-line below.

One general suggestion:  Include with the printed book a bootable
Knoppix-style CD that would boot up, autoload drivers for the DevKit or
DevKit Lite, and be ready to hit with SIP and IAX from DIAX and X-Lite from
another PC running Windows on the same network (and maybe a GS phone, too).
I think this should be feasible.

I hope Outlook doesn't mess this up too much--I've to make it as
list-friendly as I know how...

Randy Johnson
> -----Original Message-----
> From: Steven Sokol [mailto:ssokol@sokol-associates.com] 
> Sent: Friday, November 21, 2003 12:35 PM
> To: asterisk-users@lists.digium.com
> Subject: [Asterisk-Users] Outline For Asterisk Book - Please 
> Review & Comment
> 
> 
> 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.).
> 
[snip]> 
> 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
Is this also Telephony 101?  FXO, FXS, loop start/ground start, PRI, E&M,
RBS, T1, etc.  Telephony has a lot of new concepts for someone coming from
software or networking...  Maybe a basic telephony dictionary at least
should be an appendix?
> 		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
How about either 4) or iv. Like:

		4) Other Related Open Source Alternatives
			i.	VOCAL
			ii.	SER
			iii.	GnuGK
			iv.	Bayonne

This will put Asterisk in context for someone familiar with any of these,
point out Asterisk's advantages, and show how they can be used together if
appropriate.
> 	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
			iv.  CDR

(does this belong here?  It should be somewhere...)
> 		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
I would break f.1) up more like (pardon the numbering format):

	i.  Soft Phones
		1'.  Gnophone
		2'.  DIAX
		3'. Other
	ii.  Management and Configuration Tools
		1'.  Astman/Gastman
		2'.  Ethereal Plugin for IAX2
		3'. Others (I know there are other web and/or GUI tools
floating around).
		
( or something like that...)
> 		2) Hardware
> 			i.   VoIP Hard-Phones
> 			ii.  VoIP Gateways
> 			ii.  Channel Banks
A possible addition here would be:

			iv. Legacy PBX Equipment
and 
			v.  Other Hardware Options
				1'.  VoiceTronix OpenLine and OpenSwitch
Cards
				2'.  QuickNet Cards
				3'.  ISDN Cards (Eicon, etc.)
				4'.  Dialogic Cards (and Proprietary
Drivers)

(I just re-read and saw 4b3 and 4b4 below, but I think this belongs here in
the "Components" section as well.)
And also, how about:

	3) Service Providers
		i.   SIP ...
		ii.  IAX ...

I think a connection to the outside world is an important Optional
Component.
> 
> 2.  Installing Asterisk
> 	*.  Asterisk Quickstart
> 		1)  Install PC Hardware
> 		2)  Download Asterisk Software
> 		3)  Build Asterisk
> 		4)  Install Asterisk
> 		5)  Configure Autostart
> 		
[snip]> 	b.  Hardware Installation
> 		1)  IRQ Sharing Issues
> 		2)  Digium Wildcard Cards
> 		3)  LineJack and PhoneJack Cards
> 		4)  Other Cards (ISDN, VoiceTronix, Etc.)
I'm glad 3) and 4) are here (see above).  I might be able to contribute to
some of these sections.
> 	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)
[snip]
> 	f.  Sample Configurations
> 		[LOTS OF SAMPLES HERE]
Including, where possible, the configuration files from the foreign
devices...
> 		
> 4.  Common Issues
> 	a.  Music On Hold/MP3 Playback
> 		1) Proper Version of MPG123
> 		2) Zaptel Timer or Ztdummy
[snip]
> 	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 about:
		6) Legacy PBX Equipment
			i.   Nortel Meridian / Norstar Systems
			ii.  Avaya Definity Systems
			iii. Others

(I am currently running PRI to Nortel Meridian systems, and I will be
interfacing with a Definity G3 in the next week or two.  I might be able to
add some value in this section.)
> 	*.  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)
>	f.  Databases and Asterisk
		1'.  PGSQL Application
		2'.  CDR and MySQL 		

	h.  Data Networking with Asterisk and Zaptel (Zaptel PPP/HDLC)
> 6.  Scripting And AGI Extensions to Asterisk
> 	a.  What Is AGI?
> 	b.  What Languages Can I Use
> 	c.  
> 	AGI In: c, perl, php, etc.-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.digium.com/pipermail/asterisk-users/attachments/20031121/cb888468/attachment.htm

Steven Critchfield

2003-Nov-21 13:46 UTC

head link

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

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@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users-- 
Steven Critchfield  <critch@basesys.com>

costas

2003-Nov-21 14:59 UTC

head link

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

A little more about Linux commands to help troubleshoot installations. Also
using gnomephone would be nice.

---------- Original Message ----------------------------------
From: "Steven Sokol" <ssokol@sokol-associates.com>
Reply-To: asterisk-users@lists.digium.com
Date:  Fri, 21 Nov 2003 11:34:35 -0600
>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@lists.digium.com
>http://lists.digium.com/mailman/listinfo/asterisk-users
>
--
Costas Menico
Meezon Software Corp
201-224-8111
costas@meezon.com

--

Steven Sokol

2003-Nov-21 15:21 UTC

head link

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

Will,

I have added Clustering/TDMoE and ENUM as two additional topics in the
Advanced Configuration section.  I have also added the ISDN BRI/CAPI
stuff to the Add-On/Optional Components/Hardware chapter of Section 1.
Thanks for the suggestions.

I would love to have whatever you can write up on all of these topics.
Please send as plain text or RTF.

Thanks!

Steve
> -----Original Message-----
> From: asterisk-users-admin@lists.digium.com [mailto:asterisk-users-
> admin@lists.digium.com] On Behalf Of asterisk@lists.styx.org
> Sent: Friday, November 21, 2003 2:09 PM
> To: asterisk-users@lists.digium.com
> Subject: Re: [Asterisk-Users] Outline For Asterisk Book - Please
Review &> Comment
> 
> Great idea!
> 
> I would also like to see some discussion of ISDN BRI and CAPI
> hardware, as well as some discussion of "distributed asterisk"
> what happens when you start deploying a network of many asterisk
> boxes, how to do forwarding and switching properly, TDMoE as well as
> E164 enum call routing -- on the latter I can perhaps contribute
> some text now that I have gotten it to work properly ;)
> 
> Cheers,
> Will
> _______________________________________________
> Asterisk-Users mailing list
> Asterisk-Users@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users

Paul Bagyenda

2003-Nov-29 01:41 UTC

head link

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

Hi Steven,

  I am happy to contribute to the voicetronix channel section.

Paul.

Leif Madsen

2003-Nov-30 08:44 UTC

head link

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

On Sat, 2003-11-29 at 03:41, Paul Bagyenda wrote:> Hi Steven,
> 
>   I am happy to contribute to the voicetronix channel section.
If you have any documentation, you can send it to me for inclusion into
the book.  I am going to try and find some time to input stuff today,
but if you do not have it ready, then send it as soon as you finish it.

Thanks in advance,

-- 
Leif Madsen <leif@hacklocalhost.com>
http://www.hacklocalhost.com

Seemingly Similar Threads

Search for more apparently analagous threads

asterisk users - Nov 2003 - Outline For Asterisk Book - Please Review & Comment

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

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

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

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

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

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

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

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

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

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

Seemingly Similar Threads