3. 实战1:FreeSwitch的安装

本次安装环境是centos 7, 源码目录是

/usr/local/src/freeswitch
  1. 下载源码(1.6.20是目前1.6的最新版)
cd /usr/local/src
git clone -b v1.6.20 https://freeswitch.org/stash/scm/fs/freeswitch.git freeswitch
  1. 配置编译安装的基础环境
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
  1. 运行 ./rebootstrap.sh 初始化环境变量
cd /usr/local/src/freeswitch
./rebootstrap.sh
  1. 运行 ./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插件编译,可以避免编译出现意外

  1. 执行 make 进行编译
cd /usr/local/src/freeswitch
make

5.1make时会遇到一些小问题,基本解决思路是:

  1. 先看make的提示,是缺少什么依赖库
  2. 再查看刚才保存的configure.consolelog.txt,看看具体依赖的版本,因为FS编译时对具体的版本也是有要求的,不符合版本要求也不行
  3. 然后到https://centos.pkgs.org去查找相关的以来库的rpm文件
  4. 下载安装相关依赖库
  5. 重新执行 步骤4 运行 ./configure –prefix=/usr/local/freeswitch_1_6_20 –disable-multilib > configure.consolelog.txt 配置编译环境.
  6. 重新执行 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                       + 
+                                               +  
+-----------------------------------------------+
  1. 执行 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
  1. 简单安全配置
#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"/>
  1. 运行测试

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测试菜单

  1. 编译插件支持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 就可以成功了
  1. 编译插件支持英文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 就可以成功了
  1. 配置外呼

  2. 通过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)
);

– 未完 –

    原文作者:云中漫步2125
    原文地址: https://www.jianshu.com/p/49f680d54cc9
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞