编程语言
897
2016-11-1
上周折腾了2天，安装升级了 FreeSWITCH 最新版本 1.6.12，把步骤记录一下以备后续查看。
1) 查看系统版本 on Debian
$ uname -a Linux debian 3.16.0-4-amd64 #1 SMP Debian 3.16.36-1+deb8u1 (2016-09-03) x86_64 GNU/Linux $ lsb_release -a No LSB modules are available. Distributor ID: Debian Description: Debian GNU/Linux 8.6 (jessie) Release: 8.6 Codename: jessie # on Debian $ cat /etc/debian_version 8.6 # on CentOS cat /etc/centos-release CentOS release 6.6 (Final) # 查看当前主机信息 # For systemd Debian version you may also use hostnamectl: hostnamectl
apt-get update apt-get install sox apt-get install lsb-release apt-get install ngrep apt-get install subversion apt-get install lrzsz apt-get install python apt-get install python-dev apt-get install python-mysqldb
2) 使用 apt-get 方式进行安装，通过这种方式安装，就是下载别人已编译打包好的代码，进行安装部署，减少自己编译需要解决很多依赖包的麻烦。
【注意】
- 如果 FS 官网挂了，这种安装方式也会受到影响，部分东西仍是需要到 FS 官网上进行下载的
- 通过 apt-get 方式安装的 FS 不包括 mod_shout 模块
https://freeswitch.org/confluence/display/FREESWITCH/Debian+8+Jessie
https://freeswitch.org/confluence/display/FREESWITCH/Debian+Post-Install+Tasks
参考官方的安装文档 Installing from Debian packages
wget -O - https://files.freeswitch.org/repo/deb/debian/freeswitch_archive_g0.pub | apt-key add - echo "deb http://files.freeswitch.org/repo/deb/freeswitch-1.6/ jessie main" > /etc/apt/sources.list.d/freeswitch.list # you may want to populate /etc/freeswitch at this point. # if /etc/freeswitch does not exist, the standard vanilla configuration is deployed apt-get update && apt-get install -y freeswitch-meta-all && apt-get install -y freeswitch-meta-all-dbg
通过以下命令，可以查找到和 FreeSWITCH 相关的所有 packages：
apt-cache search freeswitch
单独安装 mod_shout 模块：
apt-cache search freeswitch-mod-shout apt-get install -y freeswitch-mod-shout && apt-get install -y freeswitch-mod-shout-dbg
3) apt-get 的安装日志，位于
tail -f /var/log/apt/history.log
4) 安装完成之后，FS 会自动启动，无论使用 /usr/bin/freeswitch -stop 或者 kill 都退出不了进程，因为它是通过 systemd 来启动的，需要使用如下命令才能正确退出 FS：
systemctl stop freeswitch.service
systemctl 其实是调用了一个脚本来启动 FS 的，可以通过以下命令找到该脚本：
find / -name "*freeswitch.service*" # 查找结果，第一个结果其实是软链接，指向第二个结果的 /etc/systemd/system/multi-user.target.wants/freeswitch.service /lib/systemd/system/freeswitch.service
FS 源码里面包含了这个脚本的：
该启动脚本配置了很多启动参数，可以对这些参数进行调整，但一般不建议直接修改这个脚本，自定义的启动参数可以另外配置在以下位置：
;;;;; Author: Travis Cross <tc@traviscross.com> [Unit] Description=freeswitch After=syslog.target network.target local-fs.target [Service] ; service Type=forking PIDFile=/run/freeswitch/freeswitch.pid Environment="DAEMON_OPTS=-nonat" EnvironmentFile=-/etc/default/freeswitch ExecStart=/usr/bin/freeswitch -u freeswitch -g freeswitch -ncwait $DAEMON_OPTS TimeoutSec=45s Restart=always ; exec User=root Group=daemon LimitCORE=infinity LimitNOFILE=100000 LimitNPROC=60000 LimitSTACK=250000 LimitRTPRIO=infinity LimitRTTIME=infinity IOSchedulingClass=realtime IOSchedulingPriority=2 CPUSchedulingPolicy=rr CPUSchedulingPriority=89 UMask=0007 ; 这里新建一个 conf 文件 ; alternatives which you can enforce by placing a unit drop-in into ; /etc/systemd/system/freeswitch.service.d/*.conf: ; ; User=freeswitch ; Group=freeswitch ; ExecStart= ; ExecStart=/usr/bin/freeswitch -ncwait -nonat -rp ; ; empty ExecStart is required to flush the list. ; ; if your filesystem supports extended attributes, execute ; setcap 'cap_net_bind_service,cap_sys_nice=+ep' /usr/bin/freeswitch ; this will also allow socket binding on low ports ; ; otherwise, remove the -rp option from ExecStart and ; add these lines to give real-time priority to the process: ; ; PermissionsStartOnly=true ; ExecStartPost=/bin/chrt -f -p 1 $MAINPID ; ; 新建完之后，需要 reload 配置文件 ; execute "systemctl daemon-reload" after editing the unit files.
5) 通过 systemctl 来启动、关闭、重启 FS：
# 立即启动 $ systemctl start freeswitch.service # 立即停止 $ systemctl stop freeswitch.service # 重启 $ systemctl restart freeswitch.service # 杀死 FS 服务进程及其所有子进程 $ systemctl kill freeswitch.service
查看 FS 启动日志：
# 查看某个 Unit 的日志 $ journalctl -u freeswitch.service $ journalctl -u freeswitch.service --since today # 实时滚动显示某个 Unit 的最新日志 $ journalctl -u freeswitch.service -f $ journalctl -u freeswitch.service -f -n 100
6) 安装完成后，执行命令确保需要的模块已经正常安装、加载：
fs_cli > module_exists mod_curl fs_cli > module_exists mod_xml_curl fs_cli > module_exists mod_xml_rpc fs_cli > module_exists mod_event_socket fs_cli > module_exists mod_shout fs_cli > module_exists mod_python fs_cli > module_exists mod_lua fs_cli > module_exists mod_cdr_csv fs_cli > module_exists mod_tts_commandline fs_cli > module_exists mod_flite fs_cli > module_exists mod_pocketsphinx fs_cli > module_exists mod_opus fs_cli > module_exists mod_unimrcp fs_cli > module_exists mod_redis # 直接查看模块是否已经编译生成 $ ll -lh /usr/lib/freeswitch/mod/
【注意】
- 通过 apt-get 方式安装 FS ，默认不安装 mod_shout 模块的，需要自己手动安装。
- 这些模块不一定全都是你所需要的，比如，我自己用了 lua 和 python，就需要 mod_lua 和 mod_python 这两模块；模块 mod_shout 是对 mp3 文件做支持的，如果需要播放 mp3 音频文件或者录音为 mp3 格式的文件，就需要该模块。
7) 使用 apt-get 方式安装 FS，安装完成后它的相关文件夹会比较分散，使用以下命令可以查找到以 freeswitch命名的文件夹：
find / -name freeswitch -type d # 查找结果 /run/freeswitch /var/log/freeswitch /var/lib/freeswitch /usr/share/doc/freeswitch /usr/share/perl5/auto/freeswitch /usr/share/freeswitch /usr/local/freeswitch /usr/lib/freeswitch /etc/freeswitch
8) 设置 core dump file 的文件命名规则，当 FS 崩溃的时候，会在【 根路径 】 / 下生成 core dump file
# 查看系统变量 sysctl kernel.core_pattern # 写入系统变量 sysctl -w kernel.core_pattern=core.%e.%h.%p
9) 查找 fs 崩溃的时候，生成的 core file
find /home -name *core*
至此，全部安装已经完成，可以开始使用你的 FreeSWITCH 了 ^_^
# 启动（如果服务是运行中状态，会启动失败） systemctl start freeswitch.service # 关闭 systemctl stop freeswitch.service # 运行状态 systemctl status freeswitch.service # 查看启动配置 systemctl can freeswitch.service # 开启开机启动 systemctl enable freeswitch.service # 取消开机启动 systemctl disable freeswitch.service # 查看运行中的服务 systemctl list-units --type=service
【参考】
https://freeswitch.org/confluence/display/FREESWITCH/Debian+8+Jessie
http://blog.jobbole.com/107760/
https://en.wikipedia.org/wiki/Core_dump
http://man7.org/linux/man-pages/man5/core.5.html
http://man.linuxde.net/sysctl/
http://www.ruanyifeng.com/blog/2016/03/systemd-tutorial-commands.html
http://www.ruanyifeng.com/blog/2016/03/systemd-tutorial-part-two.html
