FreeSWITCH啟動、查看、及關閉
FreeSWITCH一般安裝在路徑 /usr/local/freeswitch ，可執行程序位於/usr/local/freeswitch/bin 下，配置文件位於/usr/local/freeswitch/conf（當然這寫不是絕對的，具體還要看你自己安裝時候的配置）
FreeSWITCH幫助命令
freeswitch -help
''' Usage: freeswitch [OPTIONS] These are the optional arguments you can pass to freeswitch: -nf -- no forking -reincarnate -- restart the switch on an uncontrolled exit -reincarnate-reexec -- run execv on a restart (helpful for upgrades) -u [user] -- specify user to switch to -g [group] -- specify group to switch to -core -- dump cores -help -- this message -version -- print the version and exit -rp -- enable high(realtime) priority settings -lp -- enable low priority settings -np -- enable normal priority settings -vg -- run under valgrind -nosql -- disable internal sql scoreboard -heavy-timer -- Heavy Timer, possibly more accurate but at a cost -nonat -- disable auto nat detection -nonatmap -- disable auto nat port mapping -nocal -- disable clock calibration -nort -- disable clock clock_realtime -stop -- stop freeswitch -nc -- do not output to a console and background -ncwait -- do not output to a console and background but wait until the system is ready before exiting (implies -nc) -c -- output to a console and stay in the foreground Options to control locations of files: -base [basedir] -- alternate prefix directory -cfgname [filename] -- alternate filename for FreeSWITCH main configuration file -conf [confdir] -- alternate directory for FreeSWITCH configuration files -log [logdir] -- alternate directory for logfiles -run [rundir] -- alternate directory for runtime files -db [dbdir] -- alternate directory for the internal database -mod [moddir] -- alternate directory for modules -htdocs [htdocsdir] -- alternate directory for htdocs -scripts [scriptsdir] -- alternate directory for scripts -temp [directory] -- alternate directory for temporary files -grammar [directory] -- alternate directory for grammar files -certs [directory] -- alternate directory for certificates -recordings [directory] -- alternate directory for recordings -storage [directory] -- alternate directory for voicemail storage -cache [directory] -- alternate directory for cache files -sounds [directory] -- alternate directory for sound files '''
啟動、關閉
如果不帶參數的話，直接在命令行中輸入 freeswitch 就能啟動，當你看到下面所示內容時基本就是啟動正常了
# 啟動freeswitch freeswitch # 關閉freeswitch shutdown
freeswitch@d0a5f22d2bb3> 2019-06-06 09:48:51.667336 [CONSOLE] switch_core.c:2438 .=============================================================. | _____ ______ _____ _____ ____ _ _ | | | ___| __ ___ ___/ ___\ \ / /_ _|_ _/ ___| | | | | | | |_ | '__/ _ \/ _ \___ \\ \ /\ / / | | | || | | |_| | | | | _|| | | __/ __/___) |\ V V / | | | || |___| _ | | | |_| |_| \___|\___|____/ \_/\_/ |___| |_| \____|_| |_| | | | .=============================================================. | Anthony Minessale II, Michael Jerris, Brian West, Others | | FreeSWITCH (http://www.freeswitch.org) | | Paypal Donations Appreciated: paypal@freeswitch.org | | Brought to you by ClueCon http://www.cluecon.com/ | .=============================================================. .=======================================================================================================. | _ _ ____ _ ____ | | / \ _ __ _ __ _ _ __ _| | / ___| |_ _ ___ / ___|___ _ __ | | / _ \ | '_ \| '_ \| | | |/ _` | | | | | | | | |/ _ \ | / _ \| '_ \ | | / ___ \| | | | | | | |_| | (_| | | | |___| | |_| | __/ |__| (_) | | | | | | /_/ \_\_| |_|_| |_|\__,_|\__,_|_| \____|_|\__,_|\___|\____\___/|_| |_| | | | | ____ _____ ____ ____ __ | | | _ \_ _/ ___| / ___|___ _ __ / _| ___ _ __ ___ _ __ ___ ___ | | | |_) || || | | | / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \ | | | _ < | || |___ | |__| (_) | | | | _| __/ | | __/ | | | (_| __/ | | |_| \_\|_| \____| \____\___/|_| |_|_| \___|_| \___|_| |_|\___\___| | | | | ____ _ ____ | | / ___| |_ _ ___ / ___|___ _ __ ___ ___ _ __ ___ | | | | | | | | |/ _ \ | / _ \| '_ \ / __/ _ \| '_ ` _ \ | | | |___| | |_| | __/ |__| (_) | | | | _ | (_| (_) | | | | | | | | \____|_|\__,_|\___|\____\___/|_| |_| (_) \___\___/|_| |_| |_| | | | .=======================================================================================================. 2019-06-06 09:48:51.667349 [INFO] switch_core.c:2447 FreeSWITCH Version 1.8.5~64bit ( 64bit) FreeSWITCH Started Max Sessions [1000] Session Rate [30] SQL [Enabled]
如果有錯誤信息，會以紅色字體的形式提現出來，這時需要自己去排查錯誤
后台啟動、關閉
當然我們一般運行 FreeSWITCH 都是以后台的形式
# 后台啟動 freeswitch -nc # 關閉后台freeswitch freeswitch -stop
查看相關日志
我們可以首先查看一下FreeSWITCH是否正常啟動
netstat -anp | grep freeswitch
''' tcp 0 0 172.17.0.7:8081 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:8082 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:7443 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:5080 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:5060 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:2855 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:2856 0.0.0.0:* LISTEN 14252/freeswitch tcp 0 0 172.17.0.7:5066 0.0.0.0:* LISTEN 14252/freeswitch udp 0 0 0.0.0.0:1337 0.0.0.0:* 14252/freeswitch udp 0 0 172.17.0.7:52133 172.17.0.1:5351 ESTABLISHED 14252/freeswitch udp 0 0 172.17.0.7:5060 0.0.0.0:* 14252/freeswitch udp 0 0 172.17.0.7:5080 0.0.0.0:* 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2109650 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2105745 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2107133 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2105746 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2108033 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2107132 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2108032 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2109651 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2107134 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2107131 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2102897 14252/freeswitch unix 3 [ ] STREAM CONNECTED 2102898 14252/freeswitch '''
后台啟動了FreeSWITCH后我們需要查看相關日志需要用 fs_cli 命令，如果出現下圖內容就說明連上了
fs_cli ''' .=======================================================. | _____ ____ ____ _ ___ | | | ___/ ___| / ___| | |_ _| | | | |_ \___ \ | | | | | | | | | _| ___) | | |___| |___ | | | | |_| |____/ \____|_____|___| | | | .=======================================================. | Anthony Minessale II, Ken Rice, | | Michael Jerris, Travis Cross | | FreeSWITCH (http://www.freeswitch.org) | | Paypal Donations Appreciated: paypal@freeswitch.org | | Brought to you by ClueCon http://www.cluecon.com/ | .=======================================================. .=======================================================================================================. | _ _ ____ _ ____ | | / \ _ __ _ __ _ _ __ _| | / ___| |_ _ ___ / ___|___ _ __ | | / _ \ | '_ \| '_ \| | | |/ _` | | | | | | | | |/ _ \ | / _ \| '_ \ | | / ___ \| | | | | | | |_| | (_| | | | |___| | |_| | __/ |__| (_) | | | | | | /_/ \_\_| |_|_| |_|\__,_|\__,_|_| \____|_|\__,_|\___|\____\___/|_| |_| | | | | ____ _____ ____ ____ __ | | | _ \_ _/ ___| / ___|___ _ __ / _| ___ _ __ ___ _ __ ___ ___ | | | |_) || || | | | / _ \| '_ \| |_ / _ \ '__/ _ \ '_ \ / __/ _ \ | | | _ < | || |___ | |__| (_) | | | | _| __/ | | __/ | | | (_| __/ | | |_| \_\|_| \____| \____\___/|_| |_|_| \___|_| \___|_| |_|\___\___| | | | | ____ _ ____ | | / ___| |_ _ ___ / ___|___ _ __ ___ ___ _ __ ___ | | | | | | | | |/ _ \ | / _ \| '_ \ / __/ _ \| '_ ` _ \ | | | |___| | |_| | __/ |__| (_) | | | | _ | (_| (_) | | | | | | | | \____|_|\__,_|\___|\____\___/|_| |_| (_) \___\___/|_| |_| |_| | | | .=======================================================================================================. Type /help <enter> to see a list of commands [This app Best viewed at 160x60 or more..] +OK log level [7] freeswitch@d0a5f22d2bb3> '''
問題解決
如果 fs_cli 命令連不上，報錯信息如下：
[ERROR] fs_cli.c:1679 main() Error Connecting [] Usage: fs_cli [-H <host>] [-P <port>] [-p <secret>] [-d <level>] [-x command] [-t <timeout_ms>] [profile] -?,-h --help Usage Information -H, --host=hostname Host to connect -P, --port=port Port to connect (1 - 65535) -u, --user=user@domain user@domain -p, --password=password Password -i, --interrupt Allow Control-c to interrupt -x, --execute=command Execute Command and Exit -l, --loglevel=command Log Level -U, --log-uuid Include UUID in log output -S, --log-uuid-short Include shortened UUID in log output -q, --quiet Disable logging -r, --retry Retry connection on failure -R, --reconnect Reconnect if disconnected -d, --debug=level Debug Level (0 - 7) -b, --batchmode Batch mode -t, --timeout Timeout for API commands (in miliseconds) -T, --connect-timeout Timeout for socket connection (in miliseconds) -n, --no-color Disable color
這時需要修改一下連接IP，首先我們需要啟動 enable the mod_event_socket 模塊，文件 位於 /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml ，然后修改默認的啟動IP，修改文件位於 /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml ，然后重啟 FreeSWITCH 即可
nano /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml ''' <configuration name="event_socket.conf" description="Socket Client"> <settings> <param name="nat-map" value="false"/> <param name="listen-ip" value="::"/> <param name="listen-port" value="8021"/> <param name="password" value="ClueCon"/> <!--<param name="apply-inbound-acl" value="loopback.auto"/>--> <!--<param name="stop-on-bind-error" value="true"/>--> </settings> </configuration> ''' # 將上面的<param name="listen-ip" value="::"/>改為<param name="listen-ip" value="0.0.0.0"/>
查看狀態
在 fs_cli 中輸入 status
freeswitch@d0a5f22d2bb3> status ''' UP 0 years, 0 days, 0 hours, 0 minutes, 17 seconds, 869 milliseconds, 212 microseconds FreeSWITCH (Version 1.8.5 64bit) is ready 0 session(s) since startup 0 session(s) - peak 0, last 5min 0 0 session(s) per Sec out of max 30, peak 0, last 5min 0 1000 session(s) max min idle cpu 0.00/99.50 Current Stack Size/Max 240K/8192K '''
在 fs_cli 中輸入 sofia status
freeswitch@d0a5f22d2bb3> sofia status ''' Name Type Data State ================================================================================================= 172.17.0.7 alias internal ALIASED external profile sip:mod_sofia@172.17.0.7:5080 RUNNING (0) external::example.com gateway sip:joeuser@example.com NOREG internal profile sip:mod_sofia@172.17.0.7:5060 RUNNING (0) ================================================================================================= 2 profiles 1 alias '''
添加一個用戶
在 /usr/local/freeswitch/comf/directory/default 下有默認的1000-1019共20個賬號，可以通過 copy 並修改其中的 user_id 來實現增加新的賬號
路由配置
- 默認路由文件：/usr/local/freeswitch/comf/dialplan/default.xml ，可以修改他
- 添加新的路有也可以修改文件：/usr/local/freeswitch/comf/dialplan/default
- 外線來電路有配置文件：/usr/local/freeswitch/comf/dialplan/public.xml
待續....
配置文件
FreeSwitch的配置文件默認是放在 FreeSwitch\Conf\ 下，最頂層是的 FreeSwitch.xml，也就是說最先加載的就是這個 XML， FreeSwitch 根據這個 XML 依次加載 Conf 目錄下的其它配置文件。
先說conf根目錄下的文件
- freeswitch.xml：主配置文件，它會使用include語句裝入其它文件。
- vars.xml：一些常用變量，都在這個配置文件中定義。
再說conf下的文件夾
- autoload_configs：存放自動加載的配置文件。
- 此文件夾下的modules.conf.xml：配置當freeswitch啟動時自動裝載哪些模塊。
- 此文件夾下其它xml：一般來說都是對應每個模塊的配置文件。
- chatplan文件夾：存放的是聊天計划配置文件。
- dialplan文件夾：存放的是撥號計划配置文件。
- directory文件夾：用戶目錄，存儲跟用戶相關的信息。
- 此文件夾下的的defalut目錄是默認的用戶目錄配置，default下的xml文件是對應每個sip用戶的，每個sip用戶都有一個配置文件。
- ivr_menus文件夾：IVR菜單配置文件。
- jingle_profiles文件夾：連接Google Talk的相關配置文件。
- lang文件夾：多語言支持配置文件。
- 此文件夾下的en為英語，fr文件夾是法語。
- mrcp_profiles文件夾：MRCP的相關配置，用於跟第三方語音合成和語音識別系統對接。
- sip_profiles文件夾：sip配置文件
- 此文件夾下的internal.xml：一個SIP profile，或稱作一個SIP-UA，監聽在本地IP及端口5060。
- 此文件夾下的externa.xml：另一個SIP-UA，用作外部連接，端口5080。
- skinny_profiles文件夾：思科SCCP協議話機的配置文件。
待續...