=========================================== FreeIris 安装说明 http://www.freeiris.org/ =========================================== 这个文档包含了如何安装freeiris到您的系统上之说明. 1. 系统需求 2. 安装基本需求软件 3. 如何安装Asterisk 以及 Asterisk-addons 4. 如何安装FreeIris 5. FAQ 1. 系统需求 ------------------------------------------- A) 硬件需求(必备) - 处理器: 支持Linux的任意一款CPU(有MMU单元) - 内存: 不少于64MB的可用内存 - 网卡: 至少一块网卡 B) 硬件需求(可选) - 数字中继卡 : ISDN PRI : 4E1 2E1 1E1 ISDN PRI(回声消除) : 4E1 2E1 1E1 ISDN BRI : 8B1 4B1 2B1 1B1 ISDN BRI(回声消除) : 8B1 4B1 2B1 1B1 - 模拟中继卡 : FXS/FXO(回声消除) : 4口 8口 12口 24口 B) 软件需求 - 操作系统 : Linux - Freeiris依赖 : apache2 mysql perl 如果您不使用捆绑的perl还需要另外安装perl模块请参考perlmod.list - 可选安装 : Zaptel : 为数字和模拟中继卡的驱动,安装时依赖内核源码树. 本资料不做讲解. - 其他依赖 : 如果按照例题安装基本满足依赖需求,否则请参考asterisk或asterisk-addons 的说明 2. 安装基本需求软件 ------------------------------------------- A) 安装Linux系统 本资料假设您安装的为Centos 4.4系统,如果是Redhat系列的系统安装 过程基本相同,如果其他系统请参考相关资料本例不做说明. 1) 安装Centos 4.4系统,在软件包选择的时候必须选上以下软件包 开发工具 内核开发工具(如果有) Mysql服务 HTTP服务 2) 安装系统时请注意如非高级用户请禁用SElinux 3) 系统启动完成后请登入,设置一个mysql的数据库作为数据存储 > mysql mysql> create database freeiris mysql> quit 3. 如何安装Asterisk 以及 Asterisk-addons ------------------------------------------- A) 安装Asterisk 请注意这个步骤需要使用Root身份并且需要你机器已经安装好编译调试工具 1) 下载及解缩安装包 > wget http://downloads.digium.com/pub/asterisk/releases/asterisk-1.4.18.1.tar.gz (最新版请访问www.asterisk.org) > tar zxvf asterisk-1.4.18.1.tar.gz > cd asterisk-1.4.18.1 2) 配置编译源代码及安装 > ./configure > make > make install 3) 安装默认conf文件 > make samples 4) 测试asterisk是否安装成功可以执行asterisk的主命令 > asterisk -vvvvvvvvc 如果这个时候提示cli> 表示已经成功 cli> stop now 退出asterisk 5) 配置自动启动(仅在centos系统中测试过) > make config 6) 安装完毕 B) 安装Asterisk-addons 请注意这个步骤需要使用Root身份并且需要你机器已经安装好编译调试工具. 请注意,这个步骤需要机器已经安装有mysqlclient库,这个库在centos系统选择 mysql的情况下是默认安装的,如果没有可以尝试安装yum install mysql-devel. 1) 下载及解缩安装包 > wget http://downloads.digium.com/pub/asterisk/releases/asterisk-addons-1.4.6.tar.gz (最新版请访问www.asterisk.org) > tar zxvf asterisk-addons-1.4.6.tar.gz > cd asterisk-addons-1.4.6 2) 配置编译源代码 > ./configure > make 3) 安装 注意: make install为可选,实际上freeiris并不完整需要addons所有内容.如非必要 按照以下语法执行. > cp cdr/cdr_addon_mysql.so /usr/lib/asterisk/modules/ 4) 测试asterisk-addons是否安装成功可以执行asterisk的主命令 > asterisk -vvvvvvvvc 如果这个时候提示cli> 表示已经成功 cli> stop now 退出asterisk 5) 启动asterisk进程 > asterisk -vvvvvvvg & 6) 安装完毕 4. 如何安装Freiris ------------------------------------------- 请在安装前确保系统的mysql服务已经启动,asterisk A) 下载freeiris安装包的两种方法 1) 采用web下载 > wget http://opensource.0420.com/download/download.php?file=freeiris1-current.tar.gz > tar zxvf freeiris1-current.tar.gz > cd freeiris1-xxx-xxx 2) 采用svn下载,这个方法适合高级用户使用 > svn export http://opensource.0420.com/svn/freeiris/trunk ./freeiris_trunk > cd freeiris_trunk B) 安装调试Freeiris 1) 设置setup脚本权限 > chmod 755 setup 2) 进行freeeiris的安装设置 > ./setup Welcome to FreeIris install script 2.0 hoowa.sun ---------------------------------------------------------- WARNING: Freeiris is is free Open Source software. IT COMES WITHOUT WARRANTY OF ANY KIND. ---------------------------------------------------------- [INPUT] Do you agree with License(in COPYING file) (yes/no)? 系统提示您是否接受license,如果不接受就不能安装,请仔细阅读COPYING.确定输入yes > yes [STEP] Getting information... [RESPONSE] Operation System : linux [RESPONSE] Publish Version : redhat [RESPONSE] Linux Kernel : 2.6.9-42.EL [RESPONSE] asterisk.conf : /etc/asterisk/asterisk.conf [RESPONSE] mysql client command : /usr/bin/mysql [INPUT] Please input install target folder (default /usr/local/freeiris)? > (默认回车) [RESPONSE] freeiris target : /usr/local/freeiris [INPUT] 0. bundled perl 1. customize Please choose Perl intepreter (default 0)? > (默认回车) (如果是freebsd系统无法使用捆绑的perl) [RESPONSE] perl intepreter : (bundled) [INPUT] Your httpd.conf file at /etc/httpd/conf (yes/no/cancel) (default yes)? > 输入httpd文件所在的地址，如果是centos并且已经默认安装了httpd就请: (默认回车) [INPUT] Please input Mysql address (default 127.0.0.1)? > (默认回车) [INPUT] Please input Mysql port (default 3306)? > (默认回车) [INPUT] Please input Mysql databasename ?freeiris > (默认回车) [INPUT] Please input Mysql username ?root > (默认回车) [RESPONSE] Try to Connect MySQL Server...... [RESPONSE] Connect MySQL Server successfully !...... 0 simpchinese 1 english [INPUT] Please Input NUM of Web Display Language(default 0): > 0 (显示语言,0中文,1英文) [RESPONSE] ----------------------------------------------------------------- Your Configuration : OS : linux Publish : redhat OS Kernel : 2.6.18-53.el5 Asterisk config : /etc/asterisk mysql command line : /usr/bin/mysql install prefix : /usr/local/freeiris perl intepreter : httpd conf : /etc/httpd/conf mysql db host : 127.0.0.1 mysql db user : rot mysql db pass : (*) mysql db name : freeiris mysql db port : 3306 website language : english ----------------------------------------------------------------- Continue Will copying all files to your computer(yes/no) > 以上信息正确继续安装yes [STEP] Copying files to /usr/local/freeiris... [RESPONSE] Creating folder /usr/local/freeiris [RESPONSE] Copying files to /usr/local/freeiris/ [STEP] Setup freeiris... [RESPONSE] Softlink /usr/local/freeiris/etc/freeiris to /etc/freeiris [RESPONSE] Softlink /usr/local/freeiris/agi/*.agi to /var/lib/asterisk/agi-bin/*.agi [RESPONSE] Softlink /usr/local/freeiris/sounds/freeiris to /var/lib/asterisk/sounds/freeiris [RESPONSE] Overwrite /usr/local/freeiris/etc/voipconf.dist/* to /etc/asterisk/ [RESPONSE] Setting Permission to all config files... [STEP] database configuration... [RESPONSE] Auto Create tables...... [RESPONSE] saving database config to freeiris and asterisk !...... [STEP] setting language enviroment... [RESPONSE] current web display language is english [STEP] saving freeirisd services... [RESPONSE] Install Freeiris Stuff Daemon Services into Init.d [STEP] Install completed! ------------------------------------------------------------------ Installed freeiris to : Installed bundled perl to : /usr/local/freeiris/perl/ maked link to : /etc/freeiris maked link to : your asterisk agi-bin / *.agi maked link to : your asterisk sounds / freeiris overwrite your asterisk config files chmod target files permission initializtion mysql database Installed freeirisd.sh to chkconfig and 345 on ------------------------------------------------------------------ ----------------------------------------------- - - - Freeiris Opensource Telephony Project - - - - Installed on your system! - - - - admin panel : - - http://yourhost/freeiris/adminp.do - - default user : admin - - default password : admin - - - - you many need to reboot!!! - - - - - - - - - - Freeiris Development Team. hoowa sun - - - - www.freeiris.org - - - ----------------------------------------------- > 复制完成 3) 重新启动asterisk以加载freeiris设置后的信息 > asterisk -r cli> restart now 4) 测试freeiris是否安装正确 > cd /usr/local/freeiris/bin/ > ./freeirisd verbose [WEEK MON DAY HH:MM:SS YYYY] STARTUP ONCE /usr/local/freeiris/bin/freeirisbill.pl & [WEEK MON DAY HH:MM:SS YYYY] STARTUP DAEMON /usr/local/freeiris/bin/freeirisaamp.pl & > (ctrl+c) (终止当前进程) 5) 测试web是否工作 > /etc/init.d/httpd restart > 通过浏览器访问 http://yourhost/freeiris/ 6) 重新启动系统 > reboot 7) 安装完毕 5. FAQ ------------------------------------------- Q: 为何我系统中不支持G.729 G.723算法? A: 这两个算法为持有版权算法,您可以从http://asterisk.hosting.lv/下载到 适合您版本的算法,但是如果要使用在商业模式请向版权所有人交纳费用.