2008年11月17日 (月) 00:22時点における版

CLIから利用可能なSCCP(chan_sccp)関連コマンド

show コマンド

IP電話機や、SCCP周りの状況を表示するコマンド。

sccp show channels

通話中のSCCPチャネルを表示する。

Agares*CLI>
ID    LINE       DEVICE           AST STATE        SCCP STATE       CALLED
===== ========== ================ ================ ================ ==========
00004 506        7961G            OffHook          OffHook
00003 505        7911             Up               Connected        300

sccp show devices

Cisco電話機のレジスト状況を一覧表示する。

Agares*CLI> sccp show devices
Agares*CLI>
NAME             ADDRESS         MAC              Reg. State
================ =============== ================ ==========
Softphone        --              SEP003013??????  None
Cisco 7911G      192.168.0.51    SEP001BD4??????  Ok

NAME: 電話機の名称。sccp.conf中の"description"で設定する。
ADDRESS: 電話機のIPアドレス
MAC: MACアドレス。SEP<MACアドレス>と表示される。sccp.conf中の"device =>"で設定する。
Reg. State: レジスト状況を表示。レジストされていれば"Ok"と表示される。

sccp show device SEP<MACアドレス>

Cisco電話機の設定を表示する。

Agares*CLI> sccp show device SEP001BD4??????
Current settings for selected Device
------------------------------------

MAC-Address        : SEP001BD4??????
Protocol Version   : phone=9, channel=3
Keepalive          : 60
Registration state : Ok(3)
State              : OnHook(0)
MWI handset light  : ON
Description        : Cisco IP Phone7911G
Config Phone Type  : 7911
Skinny Phone Type  : Cisco7911(307)
Softkey support    : Yes
Autologin          : 502
Image Version      :
Timezone Offset    : 0
Capabilities       : 0x10c (ulaw|alaw|g729)
Codecs preference  : (alaw|ulaw)
Can DND            : Reject
Can Transfer       : Yes
Can Park           : Yes
Private softkey    : Enabled
Can CFWDALL        : No
Can CFWBUSY        : No
Dtmf mode          : In-Band
Trust phone ip     : No
Early RTP          : No

Lines
id  : name                 label
------------------------------------
   1: 502                  MR G's Phone

Speedials
id  : name                 number
------------------------------------
   1: ALL Telephone        500
   2: Music on Hold        300
   3: Casper Music on Hold 2006????
   4: Dr K                 050???????

sccp show globals

グローバル設定を表示する。
sccp.conf中の"[general]"で設定する。

Agares*CLI> sccp show globals
SCCP channel driver global settings
------------------------------------

Platform byte order   : BIG ENDIAN
Protocol Version      : 3
Server Name           : Agares
Bind Address          : 192.168.0.4:2000
Keepalive             : 60
Debug level           : 10
Date format           : Y/M-D
First digit timeout   : 16
Digit timeout         : 8
RTP tos               : 184
Context               : default
Language              : jp
Accountcode           :
Musicclass            : default
AMA flags             : 3 - DOCUMENTATION
Callgroup             : 1
Pickupgroup           : 1
Capabilities          : 0xc (ulaw|alaw)
Codecs preference     : (alaw|ulaw)
CFWDALL               : No
CFWBUSY               : Yes
DND                   : Reject
Park                  : Enabled
Private softkey       : Enabled
Echo cancel           : Enabled
Silence suppression   : Disabled
Trust phone ip        : No
Early RTP             : No
AutoAnswer ringtime   : 0
AutoAnswer tone       : 50
RemoteHangup tone     : 50
Transfer tone         : 0
CallWaiting tone      : 45

sccp show lines

ラインキーの状態を表示する。
sccp.conf中の"[lines]"で設定する。

Agares*CLI> sccp show lines
Agares*CLI>
NAME             DEVICE           MWI  Chs  Active Channel
================ ================ ==== ==== =================================================
508              SEP001795??????  OFF  0    --                                         
507              SEP0013C4??????  OFF  0    --                                         
506              SEP001795??????  OFF  1    Connected  Inbound             0x4 (ulaw)
505              SEP001BD4??????  OFF  0    --

sccp show sessions

SCCPで張られているセッションを表示する。
詳細はソースを参照すべし。

Agares*CLI> sccp show sessions
Socket     IP              KA   DEVICE          STATE           TYPE
========== =============== ==== =============== =============== ===============
14         192.168.0.51    18   SEP001BD4?????? OnHook          Cisco7911

KA: KeepAliveの秒数。"keepalive"で設定された秒数まで行くと0に戻る。
STATE: ハンドセットの状態。受話器を上げるとOffHookと表示される。

sccp show version

SCCPチャンネルドライバのバージョンを表示する。

Agares*CLI> sccp show version
SCCP channel version: 20060408

system message/message devices コマンド

IP電話機にメッセージを表示する。
暫く経つと消えるものと、ずっと残るものがある。

system message: メッセージを表示する。
message devices: 決められた秒数のみ、メッセージを表示する。

sccp message devices <秒数>

入力したメッセージを、一定時間、電話機に表示する。
秒数を特に指定しない場合、10秒で元に戻る。

Agares*CLI> sccp message devices "Good Job!!" 10
    -- SEP001795??????: Display notify with timeout 10
    -- SEP001BD4??????: Display notify with timeout 10

sccp system message

指定したメッセージを電話機に表示する。

Agares*CLI> sccp system message "Asterisk"
SCCP system message text stored successfully

メッセージを消す時は、"sccp system message"

Agares*CLI> sccp system message
SCCP system message deleted!

sccp system message 小技

sccp.confにはsystem messageの設定が無い(or 設定が見付かってない)ので、
起動直後はsystem messageは空欄のままになっている。
crontab等を利用して、自動的にsystem messageを再設定するようにすることで、
自動的に設定が行われる。

Astlinux ~ # cat /mnt/kd/crontabs/root
0 */1 * * * /usr/sbin/asterisk -rx 'sccp system message "Forneus PBX Service' >/dev/null 2>&1

debug コマンド

sccp debug <デバッグレベル>

CLIに表示されるメッセージのレベルを変更する。
0から10まで変更可能

Agares*CLI> sccp debug 10
SCCP debug level was 0 now 10

sccp no debug

デバッグを停止する。

Agares*CLI> sccp no debug
SCCP Debugging Disabled

reset/restart コマンド

IP電話機を再起動する。

restart: クイックリブート。ファームウェアを再読み込みしない。
reset: 普通のリブート。ファームウェアを再読み込みする。

sccp restart SEP<MACアドレス>

指定したIP電話機を再起動する。
IP電話機のMACアドレスを指定すること(IPアドレス指定は不可)
ファームウェアを再読み込みせず、configを再読み込みする。

Agares*CLI> sccp restart SEP001BD4??????
SEP001BD4??????: restart request sent to the device
SEP001BD4??????: Turn off the monitored line lamps to permit the restart
    -- SEP001BD4??????: >> Got message UnregisterMessage
    -- SEP001BD4??????: unregister request sent
    -- SEP001BD4??????: Old session marked down
    -- SEP001BD4??????: Killing Session 192.168.0.51
    -- SCCP: Looking for line 502
    -- SCCP: Asterisk asked for the state (5) of the line 502
    -- SCCP: Accepted connection from 192.168.0.51
    -- SCCP: Using ip 192.168.0.4
    -- SCCP: >>

sccp reset SEP<MACアドレス>

指定したIP電話機をリセットする。
IP電話機のMACアドレスを指定すること(IPアドレス指定は不可)
ファームウェアを再読み込みするので、restartと比べると時間がかかる。

Agares*CLI> sccp reset SEP001BD4??????
SEP001BD4??????: reset request sent to the device
SEP001BD4??????: Turn off the monitored line lamps to permit the reset
    -- SEP001BD4??????: >> Got message UnregisterMessage
    -- SEP001BD4??????: unregister request sent
    -- SEP001BD4??????: Old session marked down
    -- SEP001BD4??????: Killing Session 192.168.0.51
    -- SCCP: Looking for line 502
    -- SCCP: Asterisk asked for the state (5) of the line 502

reload コマンド

sip reloadに相当するコマンドだが、reloadが機能しないため、
unload/loadコマンドで代用すること。

Agares*CLI> sccp reload
SCCP configuration reload not implemented yet! use unload and load.