freeswitch 1.6.12 安装笔记（apt-get 方式）

上周折腾了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)

---

2) 使用 apt-get 方式进行安装，通过这种方式安装，就是下载别人已编译打包好的代码，进行安装部署，减少自己编译需要解决很多依赖包的麻烦。

【注意】

1. 如果 FS 官网挂了，这种安装方式也会受到影响，部分东西仍是需要到 FS 官网上进行下载的
2. 通过 apt-get 方式安装的 FS 不包括 mod_shout 模块

参考官方的安装文档 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

通过以下命令，可以查找到和 freeswitch 相关的所有 packages：

apt-cache search freeswitch

单独安装 mod_shout 模块：

apt-cache search freeswitch-mod-shout

# 单独安装 mod_shout 模块
apt-get install freeswitch-mod-shout

---

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 源码里面包含了这个脚本的：

https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse/debian/freeswitch-systemd.freeswitch.service

该启动脚本配置了很多启动参数，可以对这些参数进行调整，但一般不建议直接修改这个脚本，自定义的启动参数可以另外配置在以下位置：

; alternatives which you can enforce by placing a unit drop-in into
; /etc/systemd/system/freeswitch.service.d/*.conf:

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

【注意】

1. 通过 apt-get 方式安装 FS ，默认不安装 mod_shout 模块的，需要自己手动安装。
2. 这些模块不一定全都是你所需要的，比如，我自己用了 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

至此，全部安装已经完成，可以开始使用你的 FreeSWITCH 了 ^_^

---

【参考】

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