目  录

第1章 SIP配置命令... 1-1

1.1 SIP配置命令.. 1-1

1.1.1 display voice sip call-statistics. 1-1

1.1.2 display voice sip register-state. 1-3

1.1.3 outband sip. 1-4

1.1.4 proxy. 1-5

1.1.5 register-enable. 1-5

1.1.6 registrar ipv4. 1-6

1.1.7 reset voice sip statistics. 1-7

1.1.8 sip. 1-7

1.1.9 sip-comp. 1-8

1.1.10 sip-comp agent 1-8

1.1.11 sip-comp server 1-9

1.1.12 sip-domain. 1-10

1.1.13 source-ip. 1-10

1.1.14 user 1-11

1.1.15 wildcard-register enable. 1-12

第1章  SIP配置命令

1.1  SIP配置命令

1.1.1  display voice sip call-statistics

【命令】

display voice sip call-statistics

【视图】

任意视图

【参数】

无

【描述】

display voice sip call-statistics用来显示SIP客户端所有的呼叫统计信息。

【举例】

# 显示SIP客户端所有呼叫的统计信息。

<VG> display voice sip call-statistics                                         

 Message Statistics of Stack:

TPT Message                UDP   TCP   SCTP  TLS   Total

----------------------------------------------------------------

InMsg                      0      0      0      0      0

OutMsgSucc                0      0      0      0      0

OutMsgFail                0      0      0      0      0

TXN Message                Inv_Cli NonInv_Cli Inv_Srv NonInv_Srv

----------------------------------------------------------------

Create Succ                   0         0         0         0

Create Fail                   0         0         0         0

Terminal Abnom               0         0         0         0

Request Message   Inv  Ack  Bye  Can  Opt  Reg  Inf  Prk Upd

----------------------------------------------------------------

  In:                0    0    0    0    0    0    0    0    0

 Out:                0    0    0    0    0    0    0    0    0

Response Message                 1xx  2xx  3xx  4xx  5xx  6xx

----------------------------------------------------------------

  In:                               0    0    0    0    0    0

 Out:                               0    0    0    0    0    0

Error Statistics:

---------------------------------------

       callCb creation failures:     0

     call-leg creation failures:     0

  transaction creation failures:    0

         callCb locate failures:      0

       call-leg locate failures:      0

    transaction locate failures:     0

            user not registered:       0

             user not available:       0

   request with missing headers:     0

 response-no To tag in response:     0

         response - invalid via:       0

  messages without headers rcvd:     0

            SDP decode failures:       0

          registration timeouts:       0

retransmitted requests received:     0

           transaction timeouts:       0

表1-1 display voice sip call-statistics显示字段含义

1.1.2  display voice sip register-state

【命令】

display voice sip register-state

【视图】

任意视图

【参数】

无

【描述】

display voice sip register-state命令用来显示SIP注册的状态信息。

【举例】

# 显示SIP UA上所有的注册状态信息。

<VG> display voice sip register-state

Number                    Entity     Registrar Address     Expires Status

+-----------------------------------------------------------------------+

105                       105        100.1.1.1:5060        30      login

2000                      107        100.1.1.1:5060        200     online

表1-2 display voice sip register status命令显示信息描述表

1.1.3  outband sip

【命令】

outband sip

undo outband

【视图】

POTS/VoIP语音实体视图

【参数】

无

【描述】

outband sip命令用来配置采用SIP带外方式传输DTMF码。undo outband sip命令用来恢复缺省情况。

缺省情况下，采用带内传输方式传输DTMF码。

【举例】

# 为VoIP语音实体10配置SIP带外方式传输DTMF码。

<VG> system-view

[VG] voice-setup

[VG-voice] dial-program

[VG-voice-dial] entity 10 voip

[VG-voice-dial-entity10] address sip ip 10.1.1.2

[VG-voice-dial-entity10] outband sip

1.1.4  proxy

【命令】

proxy ipv4 ip-address [ port port-number ]

undo proxy ipv4

【视图】

SIP客户端视图

【参数】

ipv4 ip-address：代理服务器的IPv4地址。

port port-number：代理服务器的端口号，取值范围为1～65535，缺省值为5060。

【描述】

proxy命令配置SIP UA上的代理服务器信息。undo proxy ipv4命令用来删除SIP UA上的代理服务器信息。

缺省情况下，没有配置SIP UA上的代理服务器信息。

【举例】

# 配置SIP代理服务器地址为169.54.5.10，端口号为1120。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] proxy ipv4 169.54.5.10 port 1120

1.1.5  register-enable

【命令】

register-enable { off |on }

undo register-enable

【视图】

SIP客户端视图

【参数】

off：禁止SIP注册功能。

on：启动SIP注册功能。

【描述】

register-enable命令用来使能SIP注册功能。undo register-enable用来关闭SIP注册功能，与register-enable off效果相同。

缺省情况下，SIP注册功能处于关闭。

【举例】

# 开启SIP注册功能。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip]sip-server master 169.54.5.10

[VG-voice-sip] register-enable on

1.1.6  registrar ipv4

【命令】

registrar ipv4 ip-address [ port port-number ] [ expires seconds ] [ slave ]

undo registrar ipv4 [ slave ]

【视图】

SIP客户端视图

【参数】

ip-address：服务器IP的地址。

port-number：服务器的端口号，取值范围为1～65535，缺省值为5060。

seconds：注册老化时间，取值范围为60～65535，单位为秒，缺省值为3600秒。

slave：指定注册服务器为备份服务器。

【描述】

registrar ipv4命令用来配置SIP UA上的注册服务器信息。undo registrar ipv4命令用来删除SIP UA上的注册服务器信息。

缺省情况下，没有配置SIP UA上的注册服务器信息。

该命令必须在未启动注册功能的情况下执行。

【举例】

# 设置主用注册服务器地址为169.54.5.10，端口号为1120，老化时间为120秒。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] registrar ipv4 169.54.5.10 port 1120 expires 120

1.1.7  reset voice sip statistics

【命令】

reset voice sip statistics

【视图】

用户视图

【参数】

无

【描述】

reset voice sip statistics命令用来清除SIP客户端所有的统计信息。

【举例】

# 清除SIP客户端所有的统计信息。

<VG> reset voice sip statistics

1.1.8  sip

【命令】

sip

【视图】

语音视图

【参数】

无

【描述】

sip命令用来进入SIP客户端视图。

【举例】

# 进入SIP客户端视图。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip]

1.1.9  sip-comp

【命令】

sip-comp { callee | from }

undo sip-comp { callee | from }

【视图】

SIP客户端视图

【参数】

callee：表示系统从To头域中取被叫号码。

from：表示设备发送SIP报文时，From头域的IP地址使用To头域的IP地址。通常情况下，From头域表示主叫地址，To头域表示被叫地址。但是在与其他厂商某些设备兼容时，需要使用sip-comp from命令将From头域的IP地址配置成和To头域的IP地址相同才能正常建立呼叫。

【举例】

# 设置设备发送SIP报文的From头域的IP地址使用To头域的IP地址。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] sip-comp from

1.1.10  sip-comp agent

【命令】

sip-comp agent product-name product-version

undo sip-comp agent

【视图】

SIP客户端视图

【参数】

agent product-name product-version：表示SIP请求报文中User-agent头域的内容，其中product-name和product-version分别表示UAC端产品名称和UAC端产品版本号，为1～31个字符的字符串，区分大小写，字符串中不能包括｛，｝。

【描述】

sip-comp agent命令用来配置SIP请求报文中的User-agent头域。undo sip-comp agent命令用来删除已有配置。

缺省情况下，没有配置SIP请求报文中的User-agent头域。

【举例】

# 配置SIP请求报文中的User-agent头域为company 1.0。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] sip-comp agent company 1.0

1.1.11  sip-comp server

【命令】

sip-comp server product-name product-version

undo sip-comp server

【视图】

SIP客户端视图

【参数】

server product-name product-version：表示SIP响应报文中Server头域的内容，其中product-name和product-version分别表示UAS端产品名称和UAS端产品版本号，为1～31个字符的字符串，区分大小写，字符串中不能包括｛，｝。

【描述】

sip-comp server命令用来配置SIP响应报文中的Server头域。undo sip-comp server命令用来删除已有配置。

缺省情况下，没有配置SIP响应报文中的Server头域。

【举例】

# 配置SIP响应报文中的Server头域为company 1.1。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] sip-comp server company 1.1

1.1.12  sip-domain

【命令】

sip-domain domain-name

undo sip-domain

【视图】

SIP客户端视图

【参数】

domain-name：SIP设备的域名，取值范围为：0～9，A～Z，a～z，_，-，.。长度为1～31个字符。

【描述】

sip-domain命令用来设置SIP设备的域名。undo sip-domain命令用来删除SIP设备的域名。

缺省情况下，未配置SIP设备的域名，使用IP地址方式。

SIP地址中可以支持域名地址方式和IP地址方式。如果使用IP地址方式，一旦设备的IP地址发生变化，那么用户的SIP地址也需要改变；因此为了使用户的SIP地址保持固定不变，可以配置SIP设备的地址使用域名地址方式。

【举例】

# 设置SIP设备域名为hello.com。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] sip-domain hello.com

1.1.13  source-ip

【命令】

source-ip ip-address

undo source-ip

【视图】

SIP客户端视图

【参数】

ip-address：IPv4地址。

【描述】

source-ip命令用来配置UA发送报文时本端绑定的源IP地址。undo source-ip命令用来删除已有配置。

缺省情况下，没有配置UA发送报文本端绑定的源IP地址。

需要注意的是，配置的源地址应当为网关接口已存在的IP地址。

该命令必须在未启动注册功能的情况下执行。

【举例】

# 设置UA发送报文时本端绑定的源IP地址为1.1.1.1。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] source-ip 1.1.1.1

1.1.14  user

【命令】

user username password { cipher | simple } password [ cnonce cnonce | realm realm ] *

undo user

【视图】

SIP客户端视图/POTS实体视图

【参数】

username：注册鉴权时使用的用户名，长度为1～31个字符，区分大小写，‘”’和‘\’为无效字符。

cipher：表示用加密方式显示当前用户的密码。

simple：表示用明文方式显示当前用户的密码。

password：鉴权使用的密码，为1～16个字符或者为24个字符的字符串，区分大小写，当选择cipher参数但以明文形式输入密码或选择simple参数时，长度为1～16个字符；当选择cipher参数并以密文形式输入密码时，长度必须为24个字符。cnonce cnonce：鉴权信息字段，用于服务器和SIP UA之间的握手验证，为1～50个字符的字符串，区分大小写，‘”’和‘\’为无效字符。

realm realm：域名，用于服务器和SIP UA之间的握手验证，为1～50个字符的字符串，区分大小写，‘”’和‘\’为无效字符。

【描述】

user命令用来配置SIP鉴权信息。undo user命令用来恢复缺省情况。

缺省情况下，在SIP客户端视图下用户名为VOICE-GATEWAY，鉴权密码为VOICE-SIP，在POTS语音实体视图下没有SIP鉴权信息。

  注意：

l      如果SIP UA上配置了realm，必须保证和服务器上配置的realm相同，否则会因为不匹配导致SIP UA不进行鉴权注册。如果SIP UA上没有配置realm，则SIP UA不进行realm的匹配判断，认为服务器上的realm是可信的。

l      如果需要在POTS语音实体下配置鉴权信息，建议对应相同电话号码的POTS语音实体配置相同的鉴权信息。

l      在鉴权注册的情况下，使能注册后，不要随意修改user命令，此种操作将会造成更新注册失败。

【举例】

# 配置全局的SIP鉴权信息，用户名为abcd，密码为1234，显示方式为加密方式。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] user abcd password cipher 1234

1.1.15  wildcard-register enable

【命令】

wildcard-register enable

undo wildcard-register

【视图】

SIP客户端视图

【参数】

无

【描述】

wildcard-register enable命令用来启用电话号码模糊（通配符）注册功能。undo wildcard-register命令用来禁止电话号码模糊（通配符）注册功能。

缺省情况下，禁止电话号码模糊（通配符）注册功能。

如果启用了该命令，模糊电话号码被直接放在了REGISTER报文中，其中通配符“.”还以“.”表示，通配符T以“＊”代替）。

该命令必须在未启动注册功能的情况下执行。

&  说明：

电话号码模糊注册功能需要注册服务器及位置服务器的支持。

【举例】

# 启用电话号码模糊（通配符）注册功能。

<VG> system-view

[VG] voice-setup

[VG-voice] sip

[VG-voice-sip] wildcard-register enable