[Asterisk-Users] Outline For Asterisk Book - Please Review
& Comment
Ernest W. Lessenger
ernest at oacys.com
Fri Nov 21 12:06:49 MST 2003
Sounds like a great idea! I'll gladly help if requested (I'm a technical
writer).
Comment: I don't see anything on echo cancellation. That's a big enough and
common enough issue that it deserves some discussion.
--Ernest
At 10:46 AM 11/21/2003, you wrote:
>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 at lists.digium.com
> > http://lists.digium.com/mailman/listinfo/asterisk-users
>
>
>_______________________________________________
>Asterisk-Users mailing list
>Asterisk-Users at lists.digium.com
>http://lists.digium.com/mailman/listinfo/asterisk-users
More information about the asterisk-users
mailing list