本次安装环境是centos 7, 源码目录是
**
/usr/local/src/freeswitch 复制代码
- 下载源码(1.6.20是目前1.6的最新版)
**
cd /usr/local/src git clone -b v1.6.20 https://freeswitch.org/stash/scm/fs/freeswitch.git freeswitch 复制代码
- 配置编译安装的基础环境
**
yum install -y git alsa-lib-devel autoconf automake bison broadvoice-devel bzip2 curl-devel db-devel e2fsprogs-devel flite-devel g722_1-devel gcc-c++ gdbm-devel gnutls-devel ilbc2-devel ldns-devel libcodec2-devel libcurl-devel libedit-devel libidn-devel libjpeg-devel libmemcached-devel libogg-devel libsilk-devel libsndfile-devel libtheora-devel libtiff-devel libtool libuuid-devel libvorbis-devel libxml2-devel lua-devel lzo-devel mongo-c-driver-devel ncurses-devel net-snmp-devel openssl-devel opus-devel pcre-devel perl perl-ExtUtils-Embed pkgconfig portaudio-devel postgresql-devel python26-devel python-devel soundtouch-devel speex-devel sqlite-devel unbound-devel unixODBC-devel wget which yasm zlib-devel 复制代码
2.1 要是需要安装mysql数据库支持,需要多装以下的依赖
**
yum install unixODBC -devel yum install mysql-connector-odbc 复制代码
- 运行 ./rebootstrap.sh 初始化环境变量
**
cd /usr/local/src/freeswitch ./rebootstrap.sh 复制代码
- 运行 ./configure 配置编译环境
**
cd /usr/local/src/freeswitch ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib > configure.consolelog.txt 复制代码
如果需要连接mysql数据库需要用下面的参数
**
cd /usr/local/src/freeswitch ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib -C --enable-core-odbc-support > configure.consolelog.txt 复制代码
4.1 上面把配置过程导入到 configure.consolelog.txt中,方便后续编译出错时查找相关的提示信息。
4.2 上面配置了--prefix 指定freeswitch1.6.20编译安装到/usr/local/freeswitch_1_6_20目录下,如果不配置则默认是/usr/local/freeswitch,主要是后续安装新版本方便。
4.3 上面配置了--disable-multilib,因为我们不需要跨32位支持,避免因为跨平台编译导致一些意外的错误。
4.4 这个脚本在每次编译前都要执行一次,不管是全部源码编译还是mod插件编译,可以避免编译出现意外
- 执行 make 进行编译
**
cd /usr/local/src/freeswitch make 复制代码
5.1make时会遇到一些小问题,基本解决思路是:
- 先看make的提示,是缺少什么依赖库
- 再查看刚才保存的configure.consolelog.txt,看看具体依赖的版本,因为FS编译时对具体的版本也是有要求的,不符合版本要求也不行
- 然后到centos.pkgs.org去查找相关的以来库的rpm文件
- 下载安装相关依赖库
- 重新执行 步骤4 运行 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib > configure.consolelog.txt 配置编译环境.
- 重新执行 make
以下是解决按照FS默认配置编译时,遇到的一些问题及解决方案
5.1.1 缺少yasm时的解决方案。
问题,执行make时,可能提示找不到yasm,导致make失败,解决方法如下:
**
#下载 wget http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/y/yasm-1.2.0-4.el7.x86_64.rpm #从RPM安装 rpm -Uvh yasm-1.2.0-4.el7.x86_64.rpm 复制代码
5.1.2 1.6版本默认安装 mod_opus,该插件安装失败的解决方案
问题,查询configure.consolelog.txt,可以发现项目依赖opus 1.1版本
**
#查看系统支持的opus版本: yum list opus #可见系统只支持 1.0.2-6.el7 #因此先卸载 yum remove -y opus #重新安装 1.1版本 #先下载 opus 1.1 wget http://pkgrepo.linuxtech.net/el6/release/x86_64/libopus-1.1-1.el6.x86_64.rpm #安装 rpm -Uvh libopus-1.1-1.el6.x86_64.rpm #再下载opus-devel 1.1 wget http://pkgrepo.linuxtech.net/el6/release/x86_64/libopus-devel-1.1-1.el6.x86_64.rpm #安装 rpm -Uvh libopus-devel-1.1-1.el6.x86_64.rpm #重新执行 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib --with-lib-subdir=/usr/lib64 > configure.consolelog.txt #配置编译环境. checking for opus >= 1.1... yes #依赖检查通过 #重新 make 即可成功 复制代码
5.2 make 成功后的效果
**
+---------- FreeSWITCH Build Complete ----------+ + FreeSWITCH has been successfully built. + + Install by running: + + + + make install + + + + While you're waiting, register for ClueCon! + + https://www.cluecon.com + + + +-----------------------------------------------+ 复制代码
- 执行 make install 进行安装
**
cd /usr/local/src/freeswitch make install 复制代码
install成功后的效果
**
+---------- FreeSWITCH install Complete ----------+ + FreeSWITCH has been successfully installed. + + + + Install sounds: + + (uhd-sounds includes hd-sounds, sounds) + + (hd-sounds includes sounds) + + ------------------------------------ + + make cd-sounds-install + + make cd-moh-install + + + + make uhd-sounds-install + + make uhd-moh-install + + + + make hd-sounds-install + + make hd-moh-install + + + + make sounds-install + + make moh-install + + + + Install non english sounds: + + replace XX with language + + (ru : Russian) + + (fr : French) + + ------------------------------------ + + make cd-sounds-XX-install + + make uhd-sounds-XX-install + + make hd-sounds-XX-install + + make sounds-XX-install + + + + Upgrade to latest: + + ------------------------------------ + + make current + + + + Rebuild all: + + ------------------------------------ + + make sure + + + + Install/Re-install default config: + + ------------------------------------ + + make samples + + + + + + Additional resources: + + ------------------------------------ + + https://www.freeswitch.org + + https://freeswitch.org/confluence + + https://freeswitch.org/jira + + http://lists.freeswitch.org + + + + irc.freenode.net / #freeswitch + + + + Register For ClueCon: + + ------------------------------------ + + https://www.cluecon.com + + + +-------------------------------------------------+ 复制代码
6.1 安装语音包
**
make sounds-install make moh-install 复制代码
- 简单安全配置
**
#FS默认没有配置,需要安装配置 cd /usr/local/src/freeswitch make samples cd /usr/local/freeswitch_1_6_20/etc/freeswitch 复制代码
7.1 修改默认密码
**
#默认是1234 vi vars.xml #修改 <X-PRE-PROCESS cmd="set" data="default_password=1234"/> #为 <X-PRE-PROCESS cmd="set" data="default_password=7654321"/> 复制代码
7.2 修改默认端口
7.2.1 Eventsocket端口
**
# 这个不用改也行 vi autoload_configs/event_socket.conf.xml # 修改 <param name="listen-port" value="8021"/> 为 <param name="listen-port" value="7021"/> # 修改后 fs_cli 访问 FS命令行时,需要 # fs_cli -P 7021 复制代码
7.2.2 SIP端口
**
vi vars.xml # 修改 <X-PRE-PROCESS cmd="set" data="internal_sip_port=5060"/> # <X-PRE-PROCESS cmd="set" data="internal_tls_port=5061"/> # 为 <X-PRE-PROCESS cmd="set" data="internal_sip_port=3060"/> # <X-PRE-PROCESS cmd="set" data="internal_tls_port=3061"/> # 修改 <X-PRE-PROCESS cmd="set" data="external_sip_port=5080"/> # <X-PRE-PROCESS cmd="set" data="external_tls_port=5081"/> # 为 <X-PRE-PROCESS cmd="set" data="external_sip_port=3080"/> # <X-PRE-PROCESS cmd="set" data="external_tls_port=3081"/> 复制代码
- 运行测试
8.1 启动FS
8.1.1 建立 FS 命令行的映射
**
# 建立 FS 命令行的映射,方便后续随时启动 ln -sf /usr/local/freeswitch_1_6_20/bin/freeswitch /usr/bin/ ln -sf /usr/local/freeswitch_1_6_20/bin/fs_cli /usr/bin/ 复制代码
8.1.2 启动 FS
**
#前台启动 freeswitch #后台启动 freeswitch -nc 复制代码
8.1.3 连接命令行
**
fs_cli -P 7021 复制代码
8.2 sip软电话接入测试
8.2.1 安装sip话机
百度 zoiper3下载 安装
8.2.2 配置sip话机
user: 1002
password: 7654321
Domain: 192.168.43.110:3060
其他默认
8.2.3 拨打测试
拨打 5000
如果一切OK,就可以接通到FS的IVR测试菜单
- 编译插件支持mp3播放
**
# 切换到 FS的源代码目录 cd /usr/local/src/freeswitch vi modules.conf # 取消 formats/mod_shout 前的注释# make mod_shout-install # 编译安装成功后 cd /usr/local/freeswitch_1_6_20 vi etc/freeswitch/autoload_configs/modules.conf.xml # 取消 <load module="mod_shout"/> 的注释,以后FS会自动加载shout模块 #从命令行加载shout模块 load mod_shout 复制代码
9.1 解决 *** You must install libshout3-dev to build mod_shout。 停止。 问题
**
# 检查 configure.consolelog.txt vi configure.consolelog.txt # 发现 依赖 checking for shout >= 2.2.2... no # 到 https://centos.pkgs.org 查一下 wget http://mirror.centos.org/centos/7/os/x86_64/Packages/libshout-2.2.2-11.el7.x86_64.rpm wget http://mirror.centos.org/centos/7/os/x86_64/Packages/libshout-devel-2.2.2-11.el7.x86_64.rpm rpm -Uvh libshout-2.2.2-11.el7.x86_64.rpm rpm -Uvh libshout-devel-2.2.2-11.el7.x86_64.rpm # 重新配置 编译安装环境 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib --with-lib-subdir=/usr/lib64 > configure.consolelog.txt # 查看 配置结果: checking for shout >= 2.2.2... yes # make mod_shout-install 就可以成功了 复制代码
9.2 解决 *** You must install libmpg123-dev to build mod_shout。 停止。 问题
**
# 检查 configure.consolelog.txt vi configure.consolelog.txt # 发现 依赖 checking for libmpg123 >= 1.16.0... no # 到 https://centos.pkgs.org 查一下 wget http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/x86_64/RPMS.classic//libmpg123-1.25.10-alt1.x86_64.rpm wget http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/x86_64/RPMS.classic//libmpg123-devel-1.25.10-alt1.x86_64.rpm rpm -Uvh libmpg123-1.25.10-alt1.x86_64.rpm rpm -Uvh libmpg123-devel-1.25.10-alt1.x86_64.rpm # 重新配置 编译安装环境 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib --with-lib-subdir=/usr/lib64 > configure.consolelog.txt # 查看 配置结果: checking for libmpg123 >= 1.16.0... yes # make mod_shout-install 就可以成功了 复制代码
9.3 解决 *** You must install libmp3lame-dev to build mod_shout。 停止。问题
**
# 检查 configure.consolelog.txt vi configure.consolelog.txt # 发现 依赖 checking for lame_init in -lmp3lame... no wget http://pkgrepo.linuxtech.net/el6/release/x86_64/libmp3lame-3.98.4-4.el6.x86_64.rpm wget http://pkgrepo.linuxtech.net/el6/release/x86_64/libmp3lame-devel-3.98.4-4.el6.x86_64.rpm rpm -Uvh libmp3lame-3.98.4-4.el6.x86_64.rpm rpm -Uvh libmp3lame-devel-3.98.4-4.el6.x86_64.rpm # 重新配置 编译安装环境 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib --with-lib-subdir=/usr/lib64 > configure.consolelog.txt # 查看 配置结果: checking for lame_init in -lmp3lame... yes # make mod_shout-install 就可以成功了 复制代码
- 编译插件支持英文TTS
**
# 切换到 FS的源代码目录 cd /usr/local/src/freeswitch vi modules.conf # 取消 formats/asr_tts/mod_flite 前的注释# make mod_flite-install # 编译安装成功后 cd /usr/local/freeswitch_1_6_20 vi etc/freeswitch/autoload_configs/modules.conf.xml # 取消<load module="mod_flite"/> 的注释 # 以后FS会自动加载flite模块 #从命令行加载flite模块 load mod_flite 复制代码
10.1 解决 *** You must install libflite-dev to build mod_flite。 问题
**
# 检查 configure.consolelog.txt 发现 依赖 checking for flite >= 2.0.0... no # flite = 1.3-22.el7 被 (已安裝) flite-devel-1.3-22.el7.x86_64 需要 yum remove -y flite #卸载 git clone https://github.com/festvox/flite.git flite-2.1.0 cd flite-2.1.0 ./configure --prefix=/usr/lib64/flite2.1 --enable-shared #注意一定要加上enable-shared,否则编译不出来动态链接库,后面编译还是会失败. 2.0.0版还要 --enable-fPIC make && make install ln -s /usr/lib64/flite2.1/lib/* /usr/lib64/ vi /usr/lib64/pkgconfig/flite.pc 复制代码
粘贴
**
prefix=/usr/lib64/flite2.1 exec_prefix=${prefix} libdir=${exec_prefix}/lib includedir=${prefix}/include Name: flite Description: a text to speech library Requires: Version: 2.1.0 Libs: -L${libdir} -lflite -lflite_cmu_grapheme_lang -lflite_cmu_grapheme_lex -lflite_cmu_indic_lang -lflite_cmu_indic_lex -lflite_cmulex -lflite_cmu_time_awb -lflite_cmu_us_awb -lflite_cmu_us_kal16 -lflite_cmu_us_kal -lflite_cmu_us_rms -lflite_cmu_us_slt -lflite_usenglish Libs.private: -lm Cflags: -I${includedir}/flite/ 复制代码
**
# 重新配置 编译安装环境 ./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib --with-lib-subdir=/usr/lib64 > configure.consolelog.txt # checking for flite >= 2.0.0... yes # make mod_flite-install 就可以成功了 复制代码
- 配置外呼
- 通过ODBC支持MySQL数据库的具体过程
11.1 安装unixODBC支持
**
yum install unixODBC unixODBC-devel libtool-ltdl libtool-ltdl-devel 复制代码
11.2 下载安装MySQL ODBC驱动
**
wget https://dev.mysql.com/get/Downloads/Connector-ODBC/8.0/mysql-connector-odbc-8.0.13-1.el7.x86_64.rpm rpm -ivh mysql-connector-odbc-8.0.13-1.el7.x86_64.rpm 复制代码
11.3 配置ODBC连接的DSN
**
vi /etc/odbcinst.ini 复制代码
修改其中的
[MySQL ODBC 8.0 UNICODE Driver]
为
[MySQLTDS]
不改也没事,主要是好用好记
11.4 新建freeswitch的连接串
**
vi /etc/odbc.ini 复制代码
内容如下:
**
[freeswitch] DRIVER = MySQLTDS SERVER = localhost Port = 3306 DATABASE = freeswitch OPTION = 67108864 USER = username PASSWORD = password 复制代码
11.5 创建freeswitch数据库
**
mysql -uroot -p --用root密码登录 --执行创建库命令 CREATE DATABASE IF NOT EXISTS freeswitch DEFAULT CHARSET utf8 COLLATE utf8_general_ci; show create database freeswitch; +------------+---------------------------------------------------------------------+ | Database | Create Database | +------------+---------------------------------------------------------------------+ | freeswitch | CREATE DATABASE `freeswitch` /*!40100 DEFAULT CHARACTER SET utf8 */ | +------------+---------------------------------------------------------------------+ 1 row in set (0.00 sec) 复制代码
11.6 测试连接
运行下面的命令,结果如下就成功了。
**
isql -v freeswitch +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ 复制代码
11.7 重新编译freeswitch,打开ODBC支持
**
./configure --prefix=/usr/local/freeswitch_1_6_20 --disable-multilib -C --enable-core-odbc-support > configure.consolelog.txt make make install 复制代码
11.8 配置freeswitch的数据库DSN
**
find . -name "*.xml" | xargs grep dsn ./etc/freeswitch/autoload_configs/cidlookup.conf.xml: <param name="odbc-dsn" value="phone:phone:phone"/> ./etc/freeswitch/autoload_configs/directory.conf.xml: <!--<param name="odbc-dsn" value="dsn:user:pass"/>--> ./etc/freeswitch/autoload_configs/easyroute.conf.xml: <param name="db-dsn" value="easyroute"/> ./etc/freeswitch/autoload_configs/lcr.conf.xml: <param name="odbc-dsn" value="freeswitch-mysql:freeswitch:Fr33Sw1tch"/> ./etc/freeswitch/autoload_configs/lcr.conf.xml:<!-- <param name="odbc-dsn" value="freeswitch-pgsql:freeswitch:Fr33Sw1tch"/> --> ./etc/freeswitch/autoload_configs/nibblebill.conf.xml: <param name="odbc-dsn" value="bandwidth.com"/> ./etc/freeswitch/autoload_configs/voicemail.conf.xml: <!--<param name="odbc-dsn" value="dsn:user:pass"/>--> ./etc/freeswitch/autoload_configs/callcenter.conf.xml: <param name="odbc-dsn" value="dsn:user:pass"/> ./etc/freeswitch/autoload_configs/db.conf.xml: <param name="odbc-dsn" value="dsn:user:pass"/> ./etc/freeswitch/autoload_configs/switch.conf.xml: <!-- <param name="core-db-dsn" value="pgsql://hostaddr=127.0.0.1 dbname=freeswitch user=freeswitch password='' options='-c client_min_messages=NOTICE'" /> --> ./etc/freeswitch/autoload_configs/switch.conf.xml: <param name="core-db-dsn" value="dsn:user:pass" /> ./etc/freeswitch/jingle_profiles/server.xml: <!--If you have ODBC support and a working dsn you can use it instead of SQLite--> ./etc/freeswitch/jingle_profiles/server.xml: <!--<param name="odbc-dsn" value="dsn:user:pass"/>--> ./etc/freeswitch/sip_profiles/internal-ipv6.xml: <!--If you have ODBC support and a working dsn you can use it instead of SQLite--> ./etc/freeswitch/sip_profiles/internal-ipv6.xml: <!--<param name="odbc-dsn" value="dsn:user:pass"/>--> ./etc/freeswitch/sip_profiles/internal.xml: <!--If you have ODBC support and a working dsn you can use it instead of SQLite--> ./etc/freeswitch/sip_profiles/internal.xml: <!--<param name="odbc-dsn" value="dsn:user:pass"/>--> ./etc/freeswitch/sip_profiles/internal.xml: <!--<param name="odbc-dsn" value="pgsql://hostaddr=127.0.0.1 dbname=freeswitch user=freeswitch password='' options='-c client_min_messages=NOTICE' application_name='freeswitch'" />--> ./etc/freeswitch/skinny_profiles/internal.xml: <param name="odbc-dsn" value=""/> 复制代码
把上面找到的文件中的dsn:user:pass 改成 freeswitch:username:password
11.9 启动freeswitch, 系统会自动创建表,至此,freeswitch支持mysql完成。
11.10 bug记录
上述操作后,执行channels的默认建表脚本,会报错。因为没有深究为什么需要varchar(1024)的字段,为了不影响后续功能,暂时把所有的VARCHAR(1024)改成TEXT类型,手动创建后,再运行freeswitch后解决。
**
--默认建表脚本 CREATE TABLE channels ( uuid VARCHAR(256), direction VARCHAR(32), created VARCHAR(128), created_epoch INTEGER, name VARCHAR(1024), state VARCHAR(64), cid_name VARCHAR(1024), cid_num VARCHAR(256), ip_addr VARCHAR(256), dest VARCHAR(1024), application VARCHAR(128), application_data VARCHAR(4096), dialplan VARCHAR(128), context VARCHAR(128), read_codec VARCHAR(128), read_rate VARCHAR(32), read_bit_rate VARCHAR(32), write_codec VARCHAR(128), write_rate VARCHAR(32), write_bit_rate VARCHAR(32), secure VARCHAR(64), hostname VARCHAR(256), presence_id VARCHAR(4096), presence_data VARCHAR(4096), accountcode VARCHAR(256), callstate VARCHAR(64), callee_name VARCHAR(1024), callee_num VARCHAR(256), callee_direction VARCHAR(5), call_uuid VARCHAR(256), sent_callee_name VARCHAR(1024), sent_callee_num VARCHAR(256), initial_cid_name VARCHAR(1024), initial_cid_num VARCHAR(256), initial_ip_addr VARCHAR(256), initial_dest VARCHAR(1024), initial_dialplan VARCHAR(128), initial_context VARCHAR(128)