Freeiris2 开源通信项目

关于

Freeiris是我们通信项目的名称. Free表示自由,开放,共享, iris为希腊神话中的彩虹女神,宙斯
的通信官. Freeiris项目是由通信爱好者所共同组建的一个平台, 因为我们这里大部分同时也是
开源软件运动的推广者, 因此我们将自己的精力, 技术, 融合在了一起创造了Freeiris这么一个平
台.

信息

Freeiris2采用GPL协议第二版作为发行协议。相关协议请仔细阅读文件LICENSE
如果您不同意协议中的要求或您存在个人生理或心理缺陷无法阅读协议请您立即放弃使
用Freeiris2,如果您需要帮助请尽快与我们联系。

文档

Freeiris2 用户操作手册
 Freeiris2 开发人员指南
 Freeiris2 Extra Interface 接口开发手册

 项目历史开发文档

更多的消息或信息请访问官方网站 http://www.freeiris.org

安装

警告 :
1. Freeiris2目前不适合在WIN下安装和开发, 客户端部分webclient/目录可以单独被安装在win下请自己研究.
2. Freeiris2是一类专业系统,如果没有相关专业知识请不要尝试安装使用
3. 因为可能导致文件权限出错,请不要在windows下解压缩文件.
4. 如果遇到问题请访问网站中的讨论组进行讨论,无论什么时候开发组成员都不会回答任何关于使用问题的Email或咨询.
5. 如果不是Linux专家请安装前关闭系统的selinux和firewall防止IP数据无法穿透.

目前系统安装方式

第一种方式、光盘版安装——适合独立安装新系统(仅用于测试和演示)

请访问网站直接下载光盘版安装包并且刻录光盘进行安装

第二种方式、采用全程源代码编译安装方法——可以订制更详细的内容，适合高级用户

全程编译安装基本系统
安装Freeiris2安装包

全程编译安装基本系统:

本安装方法适合高级使用者,从代码进行安装.

需要环境:
Centos 5.X (Best is >= Centos 5.3)
Redhat类操作系统(Centos、Fedora、Redhat)都可以,但未经过测试.
其他2.6.X的Linux, 未经过测试,并且系统可能需要经过修改.

以下说明都以Centos 5.6为例

安装依赖包:

	
yum install kernel-devel httpd mysql-server mysql mysql-devel php php-mysql perl libdbi-dbd-mysql perl-libwww-perl php-process

建议依赖包安装完成后重新启动一次系统

其中httpd和mysql要设置为系统服务跟随系统一起启动

安装dahdi驱动(A1200P板卡用户要自己打patch请咨询openvox公司,如果要安装oslec回音消除也请参考资料):

	
wget "http://www.freeiris.org/download/down.php?target=asterisk&obj=&file=dahdi-linux-complete-2.5.0.2%2B2.5.0.2.tar.gz"
tar zxvf dahdi-linux-complete-2.5.0.2+2.5.0.2.tar.gz
cd dahdi-linux-complete-xxx
make all
make install
make config
/etc/init.d/dahdi start
/etc/init.d/dahdi stop
cd ..

wget "http://www.freeiris.org/download/down.php?target=asterisk&obj=&file=libpri-1.4.12.tar.gz"
tar zxvf libpri-1.4.12.tar.gz
cd libpri-1.4.12
make
make install
cd ..

安装asterisk软件:

	
wget "http://www.freeiris.org/download/down.php?target=asterisk&obj=&file=asterisk-1.4.43.tar.gz"
tar zxvf asterisk-1.4.43.tar.gz
cd asterisk-1.4.43
./configure
make
make install
make samples
make config
cd ..

wget "http://www.freeiris.org/download/down.php?target=asterisk&obj=&file=asterisk-addons-1.4.13.tar.gz"
tar zxvf asterisk-addons-1.4.13.tar.gz
cd asterisk-addons-1.4.13
./configure
make cdr
cp cdr/cdr_addon_mysql.so /usr/lib/asterisk/modules/
cd ..

注意!!!!!!!!!!!!!!!!!!!!!!!!!!!
如果这个步骤提示cdr_addon_mysql.so找不到,很可能是你没有安装mysql-devel造成的.
如果报告这个错误,请先返回上面的步骤看看是不是有问题,不要跳过这个步骤.
下面请进入安装freeiris2安装包阶段

安装freeiris2安装包:

下载方法A.发行版

	
wget "http://www.freeiris.org/download/down.php?target=darwin&obj=&file=freeiris2-current.tar.gz"
tar zxvf freeiris2-current.tar.gz
cd freeiris2-*

下载方法B. SVN版

	
svn checkout http://darwin.freeiris.org/svn/freeiris/branches/freeiris2 ./freeiris2
cd freeiris2

执行安装程序:

	
chmod +x install.pl
./install.pl --install


 Freeiris2 Install Stage by hoowa sun 2.2
sun bing 
----------------------------------------------------------
WARNING:
  This is free Open Source software.
  IT COMES WITHOUT WARRANTY OF ANY KIND.
----------------------------------------------------------

[STEP] Prerequest checking.........

[STEP] Install files.........
  [RESPONSE] create folder --> /freeiris2/
  [RESPONSE] Copying /home/hoowa/fri2svn/trunk/* ---> /freeiris2/......
`/freeiris2//contrib/init.d/fri2d' -> `/etc/init.d/fri2d'
`/freeiris2//contrib/init.d/hardware' -> `/etc/init.d/hardware'


#==============================================#
#     ______             _      _     ___      #
#    |  ____|           (_)    (_)   |__ \     #
#    | |__ _ __ ___  ___ _ _ __ _ ___   ) |    #
#    |  __| '__/ _ \/ _ \ | '__| / __| / /     #
#    | |  | | |  __/  __/ | |  | \__ \/ /_     #
#    |_|  |_|  \___|\___|_|_|  |_|___/____|    #
#                                              #
#==============================================#
#    sun bing <hoowa.sun@freeiris.org>         #
#    www.freeiris.org                          #
#    Fonoirs Co.,Ltd.                          #
#==============================================#
#                                              #
#    Congration Your Install files Completed!  #
#                                              #
#    Warnning !!!!                             #
#    For RPM INSTALL :                         #
#    Your need to run  './install.pl --setup'  #
#                                              #
#==============================================#


----------------------------------------------------------
Setup Freeiris2
----------------------------------------------------------


[STEP] Setup your Mysql Database.............
  [RESPONSE] Try To mysql with user: root pass: null host: localhost
  [RESPONSE] Initlization database......
#==============================================#
# G.729 G.723.1 LICENSE WARNNING!!!            #
#==============================================#
# 1. This Codec G.729 and G.723.1 used only in #
#    education purposes.                       #
# 2. Files from http://asterisk.hosting.lv/    #
# 3. In Commerce you may need to pay a royalty #
#    fee. Please see http://www.sipro.com for  #
#    details. if a patent exists in you country#
#    for G.729 or G.723.1 then you should      #
#    contact the owner of that patent and      #
#    request their permission before excuting  #
#    the code.                                 #
# 4. if you don't agree this license please    #
#    remove files from                         #
#    /usr/lib/asterisk/modules/                #
#==============================================#
  [RESPONSE] install G.729 G.723.1 Binary files
  [RESPONSE] set freeiris2 services
  [RESPONSE] install example
  [RESPONSE] all done!	
  [RESPONSE] Please Reboot your system!

表示安装完成,重新启动系统安装流程会生效.

特别说明:
如果过程中提示数据库部分,说明系统尝试默认数据库登陆失败,请根据提示填写数据库连接信息.
默认情况下系统是以mysql的localhost root方式登陆，并且自动创建freeiris2库.

参考资料: Openvox公司硬件板卡的WIKI文档库
http://wiki.openvox.cn/index.php/Troubleshooting_of_PRI_cards_Chinese