Asterisk CLI 進階用法

■ 線上求助

指令不熟時，可以呼叫 help 來協助

CLI> help voicemail
              voicemail reload Reload voicemail configuration
          voicemail show users List defined voicemail boxes
          voicemail show zones List zone message formats

■ 設定了 call-limit 如何檢查目前 Channel 使用數

參數 call-limit 可用來限制 incoming calls 的通話數量，要檢查通道的使用數量，可執行以下指令

Asterisk -rx "sip show inuse"

* Peer name               In use          Limit
...
provider1                    3/0/0           30
provider2                    0/0/0           12
... 

■ 如何不顯示訊息 Remote UNIX connection, Remote UNIX connection disconnected

(http://www.asteriskdocs.org/en/3rd_E...conf-file.html)
編輯 /etc/asterisk/asterisk.conf

...
[options]
...
hideconnect=yes
... 

■ 修改 CLI 提示字元

1. 在 extensions.conf 的 [globals] 增加一行(如果是 FreePBX，請改成 globals_custom.conf)
   ${ENV(ASTERISK_PROMPT)}
    
2. 編輯 /etc/profile，加上這兩行
   ASTERISK_PROMPT='%t, %l2, %h*> '
   export ASTERISK_PROMPT
    
3. 重啟 Asterisk 及重新登入 SSH。

更多的參數使用：

%d Date (year-month-date)
%s Asterisk system name (from asterisk.conf)
%h Full hostname
%H Short hostname
%t Time
%% Percent sign
%# '#' if Asterisk is run in console mode, '>' if running as remote console
%Cn[;n] Change terminal foreground (and optional background) color to specified
            A full list of colors may be found in include/asterisk/term.h 

On Linux systems, you may also use
%l1 Load average over past minute
%l2 Load average over past 5 minutes
%l3 Load average over past 15 minutes
%l4 Process fraction (processes running / total processes)
%l5 The most recently allocated pid

■ 啟動/關閉Asterisk服務

立即關閉/重啟

CLI> core stop now

CLI> core restart now 

沒有任何通話時才關閉/重啟

CLI> core stop when convenient

CLI> core restart when convenient

非強迫性的關閉/重啟

CLI> core stop gracefully

CLI> core restart gracefully

■ 如何開啟 DTMF Debugging

當遇到 dtmf 偵錯時，會需要打開 DTMF Debugging 來監看系統訊息，例如：

[2010-05-15 17:33:11] DTMF[24654]: channel.c:2191 __ast_read: DTMF begin '2' received on SIP/osslab-b76020b0
[2010-05-15 17:33:11] DTMF[24654]: channel.c:2195 __ast_read: DTMF begin ignored '2' on SIP/osslab-b76020b0
[2010-05-15 17:33:12] DTMF[24654]: channel.c:2116 __ast_read: DTMF end '2' received on SIP/osslab-b76020b0, duration 60 ms
[2010-05-15 17:33:12] DTMF[24654]: channel.c:2172 __ast_read: DTMF end '2' has duration 60 but want minimum 80, emulating on SIP/osslab-b76020b0
[2010-05-15 17:33:12] DTMF[24654]: channel.c:2224 __ast_read: DTMF end emulation of '2' queued on SIP/osslab-b76020b0
[2010-05-15 17:33:12] DTMF[24654]: channel.c:2191 __ast_read: DTMF begin '2' received on SIP/osslab-b76020b0

注意：輸入一個 DTMF 按鍵，會出現兩次一樣的訊息。

開啟方法為 編輯 /etc/asterisk/logger.conf，增加 dtmf

[logfiles]
console => dtmf
full => notice,warning,error,debug,verbose,dtmf

存檔後，執行

CLI> logger reload
CLI> logger show channels
CLI>  logger set level DTMF off <== only for Asterisk 1.6.x

Tips:

＊ 依據 BUG#0017922，Asterisk 1.6.x 預設是無法在 console 下顯示 DTMF log，必須執行
     logger set level DTMF off 。

■ 顯示目前所有已定義的 Outbound Route 規則列表

使用外部執行方式，直接在 console 執行：

#asterisk -rx "dialplan show" | tr -d "\r" | perl -00 -ne 'print if /Context..outrt/'

■ 檢查系統可用哪些的 codec

#asterisk -rx "core show translation recalc"

如圖示，紅框的 codec 各欄位皆為 - 表示系統未支援。

■ 顯示 sip.conf 的設定

CLI>sip show settings

■ 顯示 General Settings 的內容

CLI> core show settings

■ 顯示分機及 Trunk 連接狀態

CLI> sip show peers

Name/username              Host         Dyn Nat ACL Port     Status
voxalot/xxxx            64.34.173.199        N      5060     OK (257 ms)
voiptalk/xxxx           77.240.48.94                5060     OK (1311 ms)
vbuzzer/xxxx            69.172.204.133              80       OK (257 ms)

■ 顯示指定的分機的連接狀態

以分機 100 為例

CLI> sip show peer 100

■ 顯示目前通話中的所有SIP通道資訊

CLI> sip show channels

■ 顯示SIP Trunk 註冊狀態

CLI> sip show registry

■ 強制掛斷線上的通話-soft hangup

// 從線上通話列表找出要掛斷通話的 Call ID

#>asterisk -rx "sip show channels"

Peer             User/ANR    Call ID      Seq (Tx/Rx)  Format           Hold     Last Message
...
xx.xx.xx.xx    *600        6faa39db3ca  00103/00000  0x100 (g729)     No       Tx: ACK           
xx.xx.xx.xx    mypstn      b68d164f-e9  00101/00102  0x4 (ulaw)       No       Rx: ACK

// 以 Call ID 找出相應的 Channel ID

#>asterisk -rx "sip show channel b68d164f-e9" | grep -i "channel id"

Owner channel ID:       SIP/mypstn-b7d27020

// 執行中斷通話指令

for Asterisk 1.4.x
#>asterisk -rx "soft hangup SIP/mypstn-b7d27020"

for Asterisk 1.6.x
#>asterisk -rx "hangup request SIP/mypstn-b7d27020"

■ 顯示所有分機號碼

#>asterisk -rx "sip show inuse"


* User name               In use          Limit
221                       0               50
214                       0               50
213                       0               50
212                       0               50
...
* Peer name               In use          Limit
mypstn                    0/0             1
221                       0/0             50
214                       0/0             50
213                       0/0             50
212                       0/0             50
211                       0/0             50
210                       0/0             50
209                       0/0             50
...

■ 顯示 sip users 狀態

所有sip分機及sip trunk (type=user & friend) 的連線帳號/密碼、預設 context、NAT 設定。

#>asterisk -rx "sip show users"

Username                   Secret           Accountcode      Def.Context      ACL  NAT
xxxxxx                     oooooo                            from-sip-extern  No   Always
xxxxxx                     oooooo                            from-trunk       No   No
xxxxxx                     oooooo                            from-trunk       No   RFC3581
xxxxxx                     oooooo                            from-trunk       No   RFC3581
 

■ 如何將即時監看的 CLI Logs 的內容存檔

在進入 CLI 模式作除錯工作時，系統所顯示的訊息由於螢幕輸出的限制，經常無法看到全部，這裡有個方法可以一邊監看訊息，同時一邊也將訊息存檔，當要分析 Logs 時，先離開 CLI，用 less 指令就可以慢慢看剛所儲存的訊息內容。

#>asterisk -rvvvvvv | tee /path/to/your.log