aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rwxr-xr-xREADME58
1 files changed, 45 insertions, 13 deletions
diff --git a/README b/README
index e52ca4d2e..99aeec3e1 100755
--- a/README
+++ b/README
@@ -1,12 +1,17 @@
The Asterisk Open Source PBX
by Mark Spencer <markster@digium.com>
+and the Asterisk.org developer community
+
Copyright (C) 2001-2005 Digium, Inc.
+and other copyright holders.
================================================================
+
* SECURITY
It is imperative that you read and fully understand the contents of
- the SECURITY file before you attempt to configure an Asterisk server.
+the SECURITY file before you attempt to configure and run an Asterisk
+server.
-* WHAT IS ASTERISK
+* WHAT IS ASTERISK ?
Asterisk is an Open Source PBX and telephony toolkit. It is, in a
sense, middleware between Internet and telephony channels on the bottom,
and Internet and telephony applications at the top. For more information
@@ -19,7 +24,12 @@ community on this Wiki:
http://www.voip-info.org/wiki-Asterisk
-* OPERATING SYSTEMS
+There is a book on Asterisk published by O'Reilly under the
+Creative Commons License. It is available in book stores as well
+as in a downloadable version on the http://www.asteriskdocs.org
+web site.
+
+* SUPPORTED OPERATING SYSTEMS
== Linux ==
The Asterisk Open Source PBX is developed and tested primarily on the
@@ -41,18 +51,34 @@ ANY special hardware, not even a soundcard) to install and run Asterisk.
* All Wildcard (tm) products from Digium (www.digium.com)
* QuickNet Internet PhoneJack and LineJack (http://www.quicknet.net)
* any full duplex sound card supported by ALSA or OSS
- * ISDN4Linux compatible ISDN card
* VoiceTronix OpenLine products
-Hint: CAPI compatible ISDN cards can be run using the add-on channel chan_capi.
+The are several drivers for ISDN BRI cards available from third party sources.
+Check the voip-info.org wiki for more information on chan_capi, chan_misdn and
+zaphfc.
+
+* UPGRADING FROM VERSION 1.0
- Second, ensure that your system contains a compatible compiler and development
+ If you are updating from a previous version of Asterisk, make sure you
+read the UPGRADE.txt file in the source directory. There are some files
+and configuration options that you will have to change, even though we
+made every effort possible to maintain backwards compatibility.
+
+ In order to discover new features to use, please check the configuration
+examples in the /configs directory of the source code distribution.
+To discover the major new features of Asterisk 1.2, please visit
+http://www.astricon.net/asterisk1-2/
+
+* NEW INSTALLATIONS
+
+ Ensure that your system contains a compatible compiler and development
libraries. Asterisk requires either the GNU Compiler Collection (GCC) version
3.0 or higher, or a compiler that supports the C99 specification and some of
the gcc language extensions. In addition, your system needs to have the C
-library headers available, and the headers and libraries for OpenSSL and zlib.
+library headers available, and the headers and libraries for OpenSSL,
+ncurses and zlib.
On many distributions, these files are installed by packages with names like
-'libc-devel', 'openssl-devel' and 'zlib-devel' or similar.
+'glibc-devel', 'ncurses-devel', 'openssl-devel' and 'zlib-devel' or similar.
So let's proceed:
@@ -73,10 +99,10 @@ the sample PBX, with demonstration extensions, etc. If so, run:
3) "make samples"
- Doing so will overwrite any existing config files you have. If you are lacking a
-soundcard you won't be able to use the DIAL command on the console, though.
+ Doing so will overwrite any existing config files you have.
- Finally, you can launch Asterisk with:
+ Finally, you can launch Asterisk in the foreground mode (not a daemon)
+ith:
# asterisk -vvvc
@@ -95,6 +121,10 @@ Remember that if you don't have a full duplex sound card (and Asterisk
will tell you somewhere in its verbose messages if you do/don't) then it
won't work right (not yet).
+ "man asterisk" at the Unix/Linux command prompt will give you detailed
+information on how to start and stop Asterisk, as well as all the command
+line options for starting Asterisk.
+
Feel free to look over the configuration files in /etc/asterisk, where
you'll find a lot of information about what you can do with Asterisk.
@@ -196,12 +226,14 @@ that starts Asterisk.
* MORE INFORMATION
- See the doc directory for more documentation.
+ See the doc directory for more documentation on various features. Again,
+please read all the configuration samples that include documentation on
+the configuration options.
Finally, you may wish to visit the web site and join the mailing list if
you're interested in getting more information.
- http://www.asterisk.org/index.php?menu=support
+ http://www.asterisk.org/support
Welcome to the growing worldwide community of Asterisk users!