readme file for the devkit config

README.DevKitLite (text/plain), 5.04 KB, created by Dorian Gray on 2003-11-07 03:53:59 UTC

---===NEW DEV KIT LITE - SPECIAL CONFIGS===---

These are a custom set of asterisk sample files tailored to the Dev Kit Lite 2
channel development (1 FXO + 1 FXS) system offered by Digium.  The
extensions.conf, zapata.conf, voicemail.conf, and musiconhold.conf files have
been specially laid out to provide 'sane defaults' for that particular hardware
setup.

PLACE THESE FILES

 

If you have installed and used asterisk before, move any existing asterisk and
zaptel files out of the way, unless you intend to overwrite them.

Unpack the files onto the filesystem. Untar from /, as files are placed in /var/
and /etc. See the bottom of this file for a complete file list.

#tar -xzf asterisk.new.dev.kit.files.tgz 

AUTOMAGICALLY INSTALL ASTERISK AND THE DRIVERS

The first step in the install process is to run the script 'astinstaller' included
on this floppy.  This will check out the most recent source code from our CVS
repository and build it on your system. For Red Hat and Mandrake users, this script
will check the dependancies before attempting to build. For other distributions,
this step will be skipped, and it will just chaeck out and build the code. The
build WILL fail if these dependancies are not met:

The readline libraries must be installed (debian package libreadline4)
The readline development (header files) must be installed (debian package
libreadline4-dev)
OpenSSL and its development files must be installed (debian: libssl and libssl-dev)
The kernel source package must be installed (debian: kernel-headers or
kernel-source)

LOAD THE HARDWARE DRIVERS

Make sure the appropriate usb driver is loaded. Load up the hardware drivers using
'modprobe':

#modprobe wcfxo

You will get an error - Don't worry this is just 'ztcfg' complaining about the
missing channel you are about to load.

#modprobe wcfxs

Tell the system to autoconfigure zaptel channels based on the zaptel.conf:

#ztcfg -vv 

The zaptel.conf and zapata.conf are edited under the assumption that the 'wcfxo'
driver would be loaded before the 'wcfxs' driver, making the X100P channel 1 and
the TDM10B channel 2.  We recommend loading the devices in this order. It will work
either way.

MAKE THE MAILBOXES
These files are configured to make use of 2 mailboxes, 100 and 101. You can of
course change these boxes to anything you like.  You will need to create these
mailboxes in /var/spool/asterisk/vm.  The quick way is to run the
/usr/src/asterisk/addmailbox (you can copy this binary into /usr/src or similar if
you like) and enter the mail box number you'd like to create when prompted. This
will copy a default set of audio files and create the directory tree under
/var/spool/asterisk/vm/$MAILBOXNUMBER.

RUN ASTERISK

Run the command 'asterisk -vvvc' to run asterisk attached to the console.
Alternately, run ' asterisk' to fork as a daemon and then 'asterisk -vvvr' to
connect to the daemon (in triple verbose mode.)

RECORD AN INTRO MESSAGE

Voicemail will fail under the current configuration until an introductory massage
has been recorded.  Dial '7' (from the phone attached to the S100U) to record a 
message.  Record your message into the handset and press # to finish. 
It will play your message back to you and hang up. You can probably beautify 
this step with a little work in the extensions.conf.

GET TO KNOW THE CONFIGURATION

Read over the files in /etc/asterisk. There is a lot of commentary about what's
going on in there in the files. Make sure you have 'The Asterisk Handbook,'
available from www.asterisk.org. Also check out FAQ and other documentation materials at Documatation section of www.digium.com.

USING THESE FILES WITH OTHER HARDWARE

If you are using other hardware in addition to the Dev Kit Lite, no provisions have
been made in these files, and you will have to edit these files to use them. If you
are using the Dev Kit Lite in addition to a Zaptel-based T1 interface card, please
note the T1 card must be loaded before FXO/FXS station interfaces. A single T1 (24
channel card must be loaded first and occupy channels 1-24, with the dev kit lite
drivers loaded afterwards, placing those channels at 25 and 26.

SPECIAL NOTE FOR INTERNATIONAL USERS!

The extension match for dialing an outgoing POTS line is based on US telephony
numbering conventions.  It is impossible to anticipate all of the many numbering
conventions used in the world and offer examples. If you are not in the US or
Canada, you will most likely need to modify the extension match to suit the
local systems.

COMPLETE FILE LIST

etc/asterisk/
etc/asterisk/asterisk.adsi
etc/asterisk/telcordia-1.adsi
etc/asterisk/adsi.conf
etc/asterisk/adtranvofr.conf
etc/asterisk/alsa.conf
etc/asterisk/cdr_mysql.conf
etc/asterisk/extensions.conf
etc/asterisk/iax.conf
etc/asterisk/logger.conf
etc/asterisk/manager.conf
etc/asterisk/meetme.conf
etc/asterisk/modem.conf
etc/asterisk/modules.conf
etc/asterisk/musiconhold.conf
etc/asterisk/oss.conf
etc/asterisk/parking.conf
etc/asterisk/phone.conf
etc/asterisk/sip.conf
etc/asterisk/voicemail.conf
etc/asterisk/zapata.conf
etc/asterisk/queues.conf
etc/asterisk/agents.conf
var/lib/asterisk/sounds/thanks.gsm
etc/zaptel.conf