1. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Installing Asterisk Carl Davis

2. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California PREREQUISITES Asterisk distribution – asterisk-1.2.12.tar provides SIP based VoIP Zaptel library – zaptel-1.2.9.tar Digium hardware support PRI library – libpri-1.2.3.tar supports ISDN PRI interfaces Asterisk Sounds distribution – asterisk sounds- 1.2.1.tar provides professionally recorded prompts for use in your asterisk system.

3. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California More PREREQUISITES Linux distribution –RedHat Fedora Core (used in this presentation) –Debian –SuSE –Gentoo –Slackware –FreeBSD –And many more…

4. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California And More PREREQUISITES GNU Compiler Collection (GCC), v3.0 or higher Make and bison – comes with most systems C library headers – glibc-devel package Curses graphics library – ncurses-devel package Secure Socket library – openssl-devel Zlib Compression library – zlib-devel Newt Windowing Toolkit – libnewt-devel for use with zttool and ztcfg, very useful utilities Doxygen documentation tool - doxygen

5. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Even More PREREQUISITES! Root login permissions Local or remote terminal console – telnet sessions work fine as long as the server allows root login from a telnet session. General knowledge of Linux commands –tar, ftp, cd and other administrative commands –Editor dujour (i.e.: vi, emacs, pico)

6. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California And with All That Said… Now, with all that said, you really dont need this knowledge. Get the book Asterisk: The Future of Telephony from asteriskdocs.org, go to chapter 3 and type in each thing they have written. When you get into trouble, go to the Asterisk wiki at voip-info.org. You havent done anything that someone else hasnt already done. If you have, try for a prize. Ready to Start?

7. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Obtaining the Source Code FTP from asterisk.org These generally resolve to ftp.digium.com Mirror sites are available Current stable version of Asterisk is 1.2.12(10/2006) Asterisk 1.4 is in beta The transfer supplies tarballs, tar.gz compressed archives containing the necessary source Refer to asterisk.org for source code access via the Subversion source control system

8. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Extracting Source Code Copy the tar.gz archives into /usr/src Change directory, cd, to /usr/src Extract the source code from the archives –tar zxvf zaptel-*.tar.gz –tar zxvf libpri-*.tar.gz –tar zxvf asterisk-*.tar.gz The files will be extracted into their respective directories.

9. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Building Zaptel cd /usr/src/zaptel-* make clean [root@stellar zaptel-1.2.2]# make clean –rm -f torisatool makefw tor2fw.h radfw.h –rm -f ztcfg torisatool makefw ztmonitor ztspeed zttool zttest fxotune –rm -f *.o ztcfg tzdriver sethdlc sethdlc-new –… make [root@stellar zaptel-1.2.2]# make –cc -I. -O4 -g -Wall -DBUILDING_TONEZONE - DSTANDALONE_ZAPATA -DZAPTEL_CONFIG=\"/etc/zaptel.conf\" -c -o gendigits.o gendigits.c –cc -o gendigits gendigits.o -lm –./gendigits –ZAPTELVERSION="" build_tools/make_version_h > version.h.tmp –… make install

10. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Building libpri cd /usr/src/libpri-* make clean [root@stellar libpri-1.2.2]# make clean –rm -f *.o *.so *.lo *.so.1 *.so.1.0 –rm -f testpri testprilib libpri.a libpri.so.1.0 –rm -f pritest pridump –… make –CC=gcc./mkdep -Wall -Werror -Wstrict-prototypes -Wmissing- prototypes -g `ls *.c` –gcc -Wall -Werror -Wstrict-prototypes -Wmissing-prototypes -g -c -o copy_string.o copy_string.c –gcc -Wall -Werror -Wstrict-prototypes -Wmissing-prototypes -g -c -o pri.o pri.c –gcc -Wall -Werror -Wstrict-prototypes -Wmissing-prototypes -g -c -o q921.o q921.c –… make install

11. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Building Asterisk cd /usr/src/asterisk-* make clean make make install

12. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Installing Asterisk +---- Asterisk Installation Complete ------------------------------+ + + + YOU MUST READ THE SECURITY DOCUMENT + + + + Asterisk has successfully been installed. + + If you would like to install the sample + + configuration files (overwriting any + + existing config files), run: + + + + make samples + + +

13. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Installing Asterisk +----------------- or ---------------------------------------------------+ + + + You can go ahead and install the asterisk + + program documentation now or later run: + + + + make progdocs + + + + **Note** This requires that you have + + doxygen installed on your local system + +-------------------------------------------------------------------------+

14. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Installing Asterisk make samples –Installs the sample configuration files in the /etc/asterisk directory make progdocs –Installs the Asterisk program documentation. This uses doxygen to generate the documentation from the source and some areas are documented better than others make config –Configures the Linux system to execute Asterisk automatically on system startup

15. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Commonly Used CLI Options -c –Console. This allows you to connect to the Asterisk CLI. Example: asterisk -c -v –Verbosity. This is used to set the amount of output for CLI debugging. Example: asterisk –vc or asterisk -vvvvvvc -r –Remote. This is used to reconnect remotely to an already running Asterisk process. Example: asterisk -vr

16. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Starting Asterisk [root@stellar asterisk-1.2.2]# asterisk –vvvc == Parsing '/etc/asterisk/asterisk.conf': Found == Parsing '/etc/asterisk/extconfig.conf': Found Asterisk 1.2.2, Copyright (C) 1999 - 2006 Digium, Inc. and others Created by Mark Spencer Asterisk comes with ABSOLUTELY NO WARRANTY; type 'show warranty' for details. This is free software, with components licensed under the GNU General Public License version 2 and other licenses; you are welcome to redistribute it under certain conditions. Type 'show license' for details. ======================================================== == Parsing '/etc/asterisk/logger.conf': Found Asterisk Event Logger Started /var/log/asterisk/event_log == Parsing '/etc/asterisk/dnsmgr.conf': Found Asterisk Dynamic Loader loading preload modules: == Parsing '/etc/asterisk/modules.conf': Found == Manager registered action Ping == Manager registered action Hangup Asterisk Ready.

17. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Getting Help *CLI> help ! Execute a shell command abort halt Cancel a running halt add extension Add new extension into context add ignorepat Add new ignore pattern add queue member Add a channel to a specified queue ael debug contexts Enable AEL contexts debug ael debug macros Enable AEL macros debug …

18. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Starting Asterisk Service Re-Attaching to Asterisk Console If you ran the make config command earlier or manually copied the initialization scripts, use them to start Asterisk. Otherwise, run the executable from /usr/sbin. [root@stellar asterisk-1.2.2]# /etc/rc.d/init.d/asterisk start Starting asterisk: [ OK ] [root@stellar asterisk-1.2.2]# asterisk -vvvr == Parsing '/etc/asterisk/asterisk.conf': Found == Parsing '/etc/asterisk/extconfig.conf': Found Asterisk 1.2.2, Copyright (C) 1999 - 2006 Digium, Inc. and others. Created by Mark Spencer Asterisk comes with ABSOLUTELY NO WARRANTY; type 'show warranty' for details. This is free software, with components licensed under the GNU General Public License version 2 and other licenses; you are welcome to redistribute it under certain conditions. Type 'show license' for details. ========================================================= Connected to Asterisk 1.2.2 currently running on stellar (pid = 20077) remote UNIX connection Verbosity is at least 3 stellar*CLI>

19. www.itexpo.com October 10-13, 2006 San Diego Convention Center, San Diego California Q&A Carl Davis President & Chief Architect Stellar System Technologies carl_davis@stellarsystech.com www.stellarsystech.com Executive Director High Tech Business Council of Rochester www.htbc.org