From e685f2fc570a6f19bbacb5b68fcfa601c715e655 Mon Sep 17 00:00:00 2001 From: drowe67 Date: Sat, 16 Jan 2010 04:06:18 +0000 Subject: [PATCH] first pass at README.txt git-svn-id: https://svn.code.sf.net/p/freetel/code@119 01035d8c-6547-0410-b346-abe4f91aad63 --- easy-asterisk-gui/Makefile | 4 +- easy-asterisk-gui/README.txt | 109 ++++++++++++++++++ .../{ => etc/asterisk}/extensions.conf | 0 3 files changed, 111 insertions(+), 2 deletions(-) create mode 100644 easy-asterisk-gui/README.txt rename easy-asterisk-gui/{ => etc/asterisk}/extensions.conf (100%) diff --git a/easy-asterisk-gui/Makefile b/easy-asterisk-gui/Makefile index bc6998af..8d1753d0 100644 --- a/easy-asterisk-gui/Makefile +++ b/easy-asterisk-gui/Makefile @@ -8,5 +8,5 @@ # make TESTIP=boris test test: - rcp voiplines.js set_voiplines.pl set_voiplines.sh voiplines.sh voiplines.pl set_ring.sh prototype.js admin.sh index.html faq.sh faq.html about.sh at-530.html ipphones.pl ipphones.sh ipphones.js voipline.jpg anphone.png phoneline.jpg ipphone.png phones.pl tooltips.html phones.sh phones.js tick.png cross.png banner.html menu.html check_loggedin.sh logout.sh login.sh network.sh network.js set_network.sh tooltip.js tooltip.css root@$(TESTIP):/www - rcp sip.conf extensions.conf root@$(TESTIP):/etc/asterisk + rcp cgi-bin/*.html cgi-bin/*.sh cgi-bin/*.pl cgi-bin/*.js cgi-bin/*.css cgi-bin/*.png root@$(TESTIP):/www + rcp etc/asterisk/*.conf root@$(TESTIP):/etc/asterisk diff --git a/easy-asterisk-gui/README.txt b/easy-asterisk-gui/README.txt new file mode 100644 index 00000000..04278754 --- /dev/null +++ b/easy-asterisk-gui/README.txt @@ -0,0 +1,109 @@ +Easy Asterisk +============= + +Introduction +------------ + +Easy Asterisk is a simple Web GUI for Asterisk with comprehensive tool +tip documentation and a learning curve of a few minutes. Analog ports +and IP Phones are automatically detected, and no knowledge of Asterisk +configuration is required. + +Easy Asterisk is "unfeatured" - most of the Asterisk features are +hidden by the GUI. Instead it tries to make very basic, very common +Asterisk installations fast and simple, for example: + +* An Asterisk server running on your home gateway/firewall/server. + You want to connect a few IP Phones and make cheap phones calls + using VOIP. An CD based Asterisk distro is a possibility but you + don't want to dedicate a full PC just for Asterisk. You don't + really want to learn obscure dial plan syntax and yet another conf + file format. + +* An small office that already has an old analog phone system. You + want to keep your current analog lines for incoming calls, but + install 8 IP Phones and use VOIP for outgoing calls. You know + enough to set up a DSL router but don't want to rely on some phone + or computer guy at $100/hr to maintain your phone system. + +Implementation +-------------- + +Easy Asterisk is written for the +http://rowetel.com/ucasterisk/ip04.html[IP0X embedded Asterisk] +hardware but will also run on x86 and probably many other platforms. +Easy Asterisk does not require a dedicated PC, you do not need to +reformat a hard disk and install an ISO CD image. + +It is implemented as a set of CGI scripts (shell, perl, java-script) +and pre-configured extensions.conf and sip.conf files. Only a basic +web server and microperl support are required, making it suitable for +small embedded platforms. No Perl libraries or CPAN are required. + +Easy Asterisk is "unfeatured" - it hides many of the advanced Asterisk +features in the interest of simple and fast configuration. However +once you get started and your experience builds these features are of +course available using regular Asterisk configuration techniques. + +Easy Asterisk has been written to be compatible with regular Asterisk +conf-file style configuration. Just leave the conf file lines with +"easy-asterisk" comments alone. The Asterisk conf files +extensions.conf and sip.conf are directly modified by Easy Asterisk, +but changes are limited to the "easy-asterisk" lines. + +No database is used. Neither is the users.conf/AJAX style interface +based on the Asterisk built-in web server which should be disabled +when using Easy Asterisk. + +For Auto-detection of Zap ports Easy Asterisk looks at +/etc/zapata.conf, so you may need this set up correctly for your +analog hardware. On the IP0X this happens automatically. + +Installation +------------ + +Note this process will overwrite your Asterisk extensions.conf and +sip.conf files - back them up if you have an existing Asterisk +installation that you want to keep. + +IP0X: + + ------------------------------------------------------------------- + root~> ipkg install easy-asterisk + root~> reboot + ------------------------------------------------------------------- + +x86: + +1. You need a web server, Asterisk and some sort of Perl installed + (very basic Perl installation is fine). Configure your web server + to run CGIs (.sh and .pl) from /your/web/server/root (lighttpd + config instructions below). + +2. Login as root to install the Easy Asterisk files: + + ------------------------------------------------------------------- + # cd ~ + # svn co https://freetel.svn.sourceforge.net/svnroot/freetel/easy-asterisk-gui + # cp easy-asterisk-gui/etc/asterisk/* /etc/asterisk + # cp easy-asterisk-gui/cgi-bin/* /your/web/server/root + # mv etc/asterisk/users.conf etc/asterisk/users.conf.bak + ------------------------------------------------------------------- + + The final step above may not be required on your machine if you + don't have a users.conf. + +3. Switch off the internal Asterisk web server by editing + /etc/asterisk.httpd.conf. Make sure the enabled line reads like + this: + + enabled=no + + Then stop and restart Asterisk. + +4. I use lighttpd as the web server, the /etc/lighttpd.conf lines + required are: + + ------------------------------------------------------------------- + cgi.assign = ( ".sh" => "/bin/sh",".pl" => "/usr/sbin/microperl" ) + ------------------------------------------------------------------- diff --git a/easy-asterisk-gui/extensions.conf b/easy-asterisk-gui/etc/asterisk/extensions.conf similarity index 100% rename from easy-asterisk-gui/extensions.conf rename to easy-asterisk-gui/etc/asterisk/extensions.conf -- 2.25.1