[Asterisk-doc] docs NOTES,1.5,1.6 introduction.xml,1.16,1.17
blitzrage
asterisk-doc@lists.digium.com
Wed, 21 Jul 2004 17:15:10 +0000
Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv4507/docs
Modified Files:
NOTES introduction.xml
Log Message:
Added information submitted by Jim Van Meggelen, Olle Johansson, Steven
Critchfield and Rich Murphey to the Introduction chapter as submitted
and discussed on the mailing list July 21, 2004.
Index: NOTES
===================================================================
RCS file: /cvsroot/asterisk/docs/NOTES,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** NOTES 13 Jan 2004 16:36:22 -0000 1.5
--- NOTES 21 Jul 2004 17:15:04 -0000 1.6
***************
*** 89,92 ****
--- 89,94 ----
</example>
+ citing refernces: <citetitle pubwork="book">Title of Book </citetitle>
+
Used outside of <para></para>
-----------------------------
Index: introduction.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/introduction.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -d -r1.16 -r1.17
*** introduction.xml 16 Jul 2004 18:13:17 -0000 1.16
--- introduction.xml 21 Jul 2004 17:15:04 -0000 1.17
***************
*** 52,105 ****
<title>Prerequisite Knowledge and Skills</title>
<para>
! Asterisk has a steep learning curve, and some skills are required before
! beginning to set up an Asterisk System. This book assumes the reader has
! knowledge of both telephony and Linux system administration.
</para>
<sect3>
<title>Telephony</title>
<para>
! Obviously, you should know enough about the telephony
! technology that you are using to be able to set
! up and debug it. As a general guideline, you should
! understand the difference between FXS/FXO, and what ISDN,
! PRI, BRI, POTS, PSTN, VoIP, signaling, and codecs are.
</para>
<para>
! For the novice, a good introductory work is Noll's
! <citetitle pubwork="book">Introduction to Telephones and
! Telephone Systems</citetitle>, published by Artech House Publishers. Another indispensable
! resource for all skill levels is <citetitle pubwork="book">
! Newton's Telecom Dictionary</citetitle>, published by CMP Books.
</para>
</sect3>
<sect3>
! <title>System Administration</title>
<para>
! This book assumes that you have an i386 machine with Linux
! installed ready for Asterisk. Unfamiliarity with Linux
! administration will only compound the difficulties
! inherent in getting Asterisk installed and working. There
! are many resources that can help one learn about Linux.
! On the Internet, <ulink url="http://tldp.org/">Linux
! Documentation Project</ulink> provides many great
! resources for beginners. In the bookstore, Frisch's
! <citetitle pubwork="book">Essential System Administration
! </citetitle> along with Nemeth, et al.'s
! <citetitle pubwork="book"> Linux Administration Handbook
! </citetitle> and <citetitle pubwork="book">Unix System
! Administration Handbook</citetitle> are recommended. Buying
! one or two of these books can save a lot of headaches down
! the road.
</para>
! <note>
! <title>Other Systems</title>
<para>
! While Asterisk has been known to work on other hardware platforms (such as
! x86_64) and other operating systems (such as FreeBSD), we recommend you use
! Asterisk under Linux on an i386, especially while you are first starting out.
! Getting Asterisk up and running on other platforms or operating systems is
! not for the faint of heart!
</para>
- </note>
</sect3>
</sect2>
--- 52,129 ----
<title>Prerequisite Knowledge and Skills</title>
<para>
! Because of the nearly limitless flexibility of Asterisk, successfully configuring
! a system requires more than a passing familiarity with several technical concepts,
! most notably Linux Installation and Administration, as well as an understanding of
! Telephony. In this document, we will only be scraping the surface of these complex
! technologies as we discuss concepts relevant to Asterisk design, installation and
! administration. If you desire more knowledge on either subject, we have suggested
! several sources which will set you on the path towards the required knowledge.
</para>
<sect3>
<title>Telephony</title>
<para>
! Asterisk is a PBX, and that means that the more Telecommunications knowledge
! you have, the easier Asterisk will be to learn. If you plan to use analog
! circuits and telephones, you will want to understand the difference between
! FXS and FXO interfaces. Digital trunks will require you to be conversant
! with technologies such as ISDN-PRI (including wiring of T1s). Terms such as
! PSTN or VoIP should be second nature to you, and you'd do well to obtain an
! understanding of the concept of analog to digital conversion, and what codecs
! are.
</para>
+
<para>
! Before you get overwhelmed, please understand that many excellent references
! exist to help you obtain this knowledge. A good introductory work is
! <citetitle pubwork="book">Noll's Introduction to Telephones and Telephone Systems</citetitle>
! , published by Artech House Publishers. The definitive encyclopaedia of all
! things Telecom is <citetitle pubwork="book">Newton's Telecom Dictionary</citetitle>
! , published by CMP Books - this book should be on any telecommunication professional's
! bookshelf.
</para>
</sect3>
<sect3>
! <title>Linux Installation and Administration</title>
<para>
! You will need an i386-compatible system with Linux installed before you can
! install and use Asterisk. If you do not have a solid grasp of Linux administration
! concepts you will want to focus on obtaining those skills before attempting an
! Asterisk install. On the Internet, <ulink url="http://www.tldp.org" type="http">
! The Linux Documentation Project</ulink> (http://www.tldp.org) provides many great
! resources for beginners. In the bookstore, Frisch's <citetitle pubwork="book">
! Essential System Administration</citetitle> along with Nemeth, et al.'s <citetitle
! pubwork="book">Linux Administration Handbook</citetitle> and <citetitle pubwork="book">
! Unix System Administration Handbook</citetitle> are recommended. <citetitle pubwork="book">
! Running Linux</citetitle> by Matt Welch, Lar Kaufman et al. is still one of the
! all-time most successful Linux introductions. Reading one or two of these
! books can save a lot of headaches down the road.
</para>
! </sect3>
! <sect3>
! <title>Non-Linux Platforms</title>
<para>
! Asterisk works on many operating systems, however the main development
! and the PSTN hardware support is focused on the Linux i386 platform.
! On other platforms, you are mostly limited to the use of VoIP protocols
! in your PBX. Some applications will not run without a timer that
! currently is implemented only on Linux systems. The FreeBSD operating
! system has recently got a lot of attention by Asterisk developers
! and Asterisk is running smoothly on that platform with the above
! mentioned limitations.
! </para>
!
! <para>
! Digium's Asterisk server runs on FreeBSD, OpenBSD and OS X, but the drivers
! do not yet support these platforms. FreeBSD's 'ports' provides drivers for
! the most recent stable release of Asterisk, and work is progressing on
! integrating those drivers into Digium's releases.
! </para>
!
! <para>
! Support for non-linux platforms is provided by third-parties, and as a
! result there are various limitations on features, drivers or release dates
! vs Asterisk on Linux. As that support becomes integrated into Digium's
! releases, these limitations will go away.
</para>
</sect3>
</sect2>