国家 / 地区

12-语音命令参考

04-SIP命令

本章节下载  (514.23 KB)

docurl=/cn/Service/Document_Software/Document_Center/Routers/Catalog/MSR/MSR_50/Command/Command_Manual/H3C_MSR_CR(V5)-R2516-V1.16/12/201807/1093971_30005_0.htm

04-SIP命令

目  录

1 SIP

1.1 SIP配置命令

1.1.1 address sip

1.1.2 call-fallback

1.1.3 crypto

1.1.4 display voice sip call-statistics

1.1.5 display voice sip connection

1.1.6 display voice enum-group

1.1.7 display voice sip dns-record

1.1.8 display voice sip reason-mapping

1.1.9 display voice sip dynamic-contact-address

1.1.10 dns-type

1.1.11 display voice sip register-state

1.1.12 early-media enable

1.1.13 enum-group

1.1.14 keepalive

1.1.15 line-check enable

1.1.16 listen transport

1.1.17 media-protocol

1.1.18 outband sip

1.1.19 outbound-proxy

1.1.20 privacy

1.1.21 proxy

1.1.22 reason-mapping pstn

1.1.23 reason-mapping sip

1.1.24 register-enable

1.1.25 redundancy mode

1.1.26 registrar

1.1.27 remote-party-id

1.1.28 reset voice sip connection

1.1.29 reset voice sip dns-record

1.1.30 reset voice sip statistics

1.1.31 rule

1.1.32 sip

1.1.33 sip-comp

1.1.34 sip-comp agent

1.1.35 sip-comp server

1.1.36 sip-domain

1.1.37 source-bind

1.1.38 timer connection age

1.1.39 timer registration retry

1.1.40 timer registration expires

1.1.41 timer registration divider

1.1.42 timer registration threshold

1.1.43 timer session-expires

1.1.44 transport

1.1.45 trusted-point

1.1.46 uri

1.1.47 url

1.1.48 user

1.1.49 vpn-instance

1.1.50 wildcard-register enable

2 SIP本地存活

2.1 SIP本地存活命令

2.1.1 area-prefix

2.1.2 authentication

2.1.3 call-route

2.1.4 call-rule-set

2.1.5 srs

2.1.6 display voice sip-server register-user

2.1.7 display voice sip-server resource-statistic

2.1.8 expires

2.1.9 mode

2.1.10 number

2.1.11 probe remote-server

2.1.12 register-user

2.1.13 rule

2.1.14 service

2.1.15 server-bind ipv4

2.1.16 server enable

2.1.17 sip-server

2.1.18 trunk

2.1.19 trusted-point

3 SIP Trunk配置

3.1 SIP Trunk配置命令

3.1.1 address

3.1.2 address-hiding enable

3.1.3 address sip server-group

3.1.4 assign

3.1.5 account enable

3.1.6 bind sip-trunk account

3.1.7 codec transcoding

3.1.8 codec transparent

3.1.9 description

3.1.10 display voice sip-trunk account

3.1.11 display voice server-group

3.1.12 early-offer forced

3.1.13 group-name

3.1.14 hot-swap enable

3.1.15 keepalive

3.1.16 match source host-prefix

3.1.17 match destination host-prefix

3.1.18 match source address

3.1.19 media flow-around

3.1.20 midcall-signal passthrough

3.1.21 proxy server-group

3.1.22 registrar server-group

3.1.23 register enable

3.1.24 redundancy mode

3.1.25 server-group

3.1.26 sip-trunk account

3.1.27 sip-trunk enable

3.1.28 source-bind

3.1.29 supplementary-service sip call-forwarding

3.1.30 supplementary-service sip call-transfer

3.1.31 user


1 SIP

说明

MSR800、MSR 900、MSR900-E、MSR 930、MSR 2600、MSR 30-11、MSR 30-11E、MSR 30-11F和MSR3600-51F路由器不支持语音功能。

 

1.1  SIP配置命令

1.1.1  address sip

【命令】

address sip { dns domain-name [ port port-number ] | enum-group group-number | ip ip-address [ port port-number ] | proxy | server-group index }

undo address sip { dns | ip | proxy }

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

dns domain-name:被叫实体的域名,由“.”分隔的字符串组成(如aabbcc.com),每个字符串的长度不超过63个字符,包括“.”在内的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。

enum-group group-number:ENUM号码变换规则组号,取值范围为1~15。

port port-number:域名所对应地址的端口号,取值范围为1~65535。

ip ip-address:被叫的IP地址,即VoIP语音实体的呼叫目的地址。

port port-number:端口号,取值范围为1~65535。

proxy:采用SIP代理服务器完成SIP消息交互过程。

【描述】

address sip用来配置VoIP语音实体采用的SIP选路方式。undo address sip用来取消已有配置。

缺省情况下,没有配置选路方式。

关于server-group关键字可参考命令address sip server-group

【举例】

# 为VoIP语音实体10配置静态IP地址3.3.3.3。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 voip

[Sysname-voice-dial-entity10] address sip ip 3.3.3.3

# 为VoIP语音实体10配置域名为cc.news.com。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 voip

[Sysname-voice-dial-entity10] address sip dns cc.news.com

1.1.2  call-fallback

【命令】

call-fallback register

undo call-fallback register

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

【描述】

call-fallback register命令用来配置呼叫失败触发重新注册功能。undo call-fallback register命令用来关闭呼叫失败触发重新注册功能。

缺省情况下,呼叫失败触发重新注册功能处于关闭状态。

【举例】

# 开启呼叫失败触发重新注册功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] call-fallback register

1.1.3  crypto

【命令】

crypto { ssl-server-policy server-policy-name | ssl-client-policy client-policy-name }

undo crypto { server-policy | client-policy }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

ssl-server-policy server-policy-name:SSL服务器端策略名称,为1~16个字符的字符串,不区分大小写。

ssl-client-policy client-policy-name:SSL客户端策略名称,为1~16个字符的字符串,不区分大小写。

【描述】

crypto命令用来配置SIP会话使用TLS传输方式时选择的策略名称。undo crypto命令用来取消相应策略名称的配置。

缺省情况下,没有配置SIP会话使用的TLS策略名称。

需要注意的是:

·     配置该命令时,应当保证相应的SSL策略已经配置。

·     先配置客户端和服务器端的TLS策略,然后通过listen transport命令开启TLS传输协议接收呼叫,否则无法接收TLS的请求。

·     如果修改了TLS服务器策略的配置信息或是策略名称,则需要通过listen transport命令重启TLS协议的配置,这样新的策略才能生效。

·     如果修改了TLS客户端策略的配置信息或是策略名称,仅对后续新的TLS连接生效,当前已经建立的TLS连接仍然使用原有的策略。

相关配置可参考命令listen transport

【举例】

# 配置服务器端的策略名称为Server1,客户端的策略名称为Server2。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] crypto ssl-server-policy Server1

[Sysname-voice-sip] crypto ssl-client-policy Server2

1.1.4  display voice sip call-statistics

【命令】

display voice sip call-statistics [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

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

【举例】

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

<Sysname> display voice sip call-statistics

Message Statistics of Stack:

 

 TPT Message                UDP   TCP   SCTP  TLS   Total

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

 

 InMsg                    44      0      0      0     44

 OutMsgSucc               33      0      0      0     33

 OutMsgFail                0      0      0      0      0

 

 TXN Message                Inv_Cli NonInv_Cli Inv_Srv NonInv_Srv

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

 

 Create Succ                 10        12         0         1

 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    1    0    0    0    0    0    0

 Out:               10   10    4    3    0    5    0    0    0

 

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

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

  In:                              21   13    0    9    0    0

 Out:                               0    1    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命令显示信息描述表

字段

描述

TPT Message

SIP中传输层消息的统计信息。其中包括UDP消息、TCP消息、SCTP消息、TLS消息几种。每种类型的消息还可以按InMsg(接收到的消息)、OutMsgSucc(成功发送的消息)、OutMsgFail(发送失败的消息)进行显示

TXN Message

SIP中事务类消息的统计信息。在显示中分为Inv_Cli(用户端的INVITE事务)消息、NonInv_Cli(用户端的非INVITE事务)消息、Inv_Srv(服务器端的INVITE事务)消息、NonInv_Srv(服务器端的非INVITE事务)消息。每种类型的消息又可按照Create Succ(成功创建)、Create Fail(创建失败)、Terminal Abnom(终端异常)进行显示

Request Message

SIP中所有请求类消息的统计信息。主要包含Inv(INVITE)消息、ACK消息、BYE消息、Can(CANCEL)消息、Opt(OPTIONS)消息、Reg(REGISTER)消息、Inf(Information)消息、Prk(PRACK)消息、Upd(UPDATE)消息。其中每种消息又可以按照In(接收的)、Out(发送的)进行显示

Response Message

SIP中所有响应类消息的统计信息。主要包含1XX消息、2XX消息、3XX消息、4XX(Cancel)消息、5XX消息和6XX消息。其中每种消息又可以按照In(接收的)、Out(发送的)进行显示

callCb creation failures

SIP创建呼叫控制块失败的统计信息

call-leg creation failures

SIP创建呼叫腿失败的统计信息

transaction creation failures

SIP事务创建失败的统计信息

callCb locate failures

SIP呼叫控制块定位失败的统计信息

call-leg locate failures

SIP呼叫腿定位失败的统计信息

transaction locate failures

SIP事务定位失败的统计信息

user not registered

SIP用户未注册类消息的统计信息

user not available

SIP用户未不可达类消息的统计信息

request with missing headers

SIP中丢失头域类请求消息的统计信息

response-no To tag in response

SIP中缺少To Tag字段响应消息的统计信息

response - invalid via

SIP中Via字段非法的响应消息的统计信息

messages without headers rcvd

SIP中收到了没有头域的消息的统计信息

SDP decode failures

SIP中SDP消息解码失败的统计信息

registration timeouts

SIP中注册超时的统计信息

retransmitted requests received

SIP收到的重传请求的统计信息

transaction timeouts

SIP中事务超时的统计信息

 

1.1.5  display voice sip connection

【命令】

display voice sip connection { tcp | tls } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

tcp:显示所有的TCP连接的信息。

tls:显示所有的TLS连接信息。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip connection命令用来显示SIP传输层的连接信息,包括已经建立和正在建立的连接信息。

【举例】

# 显示SIP传输层的TCP连接信息。

<Sysname> display voice sip connection tcp

Conn-Id  Local-IP         Local-Port  Remote-IP        Remote-Port  Conn-State

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

 569      100.1.1.84       1593        100.1.1.100       5060            Established

 570      100.1.1.84       1594        100.1.1.101       5060            Established

 571      100.1.1.84       1595        100.1.1.81        5060            Established

 572      192.168.0.82     1596        192.168.0.81     5060            Established

# 显示SIP传输层的TLS连接信息。

<Sysname> display voice sip connection tls

Conn-Id  Local-IP         Local-Port  Remote-IP        Remote-Port  Conn-State

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

 73       192.168.0.202    1086        192.168.0.132    5061         Established

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

字段

描述

Conn-Id

连接ID

Local-IP   

本地IP地址

Local-Port

本地端口号

Remote-IP

远端IP地址

Reomte-Port

远端端口号

Conn-State

连接状态:

·     Connecting表示处于正在连接状态

·     Established表示连接已经建立

 

1.1.6  display voice enum-group

【命令】

display voice enum-group { all | mark group-number } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

all:显示所有的ENUM号码变换规则组。

mark group-number:显示指定的ENUM号码变换规则组号,取值范围为1~15。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice enum-group用来显示ENUM号码变换规则组的配置信息。

【举例】

# 显示所有号码变换规则组信息。

<Sysname> display voice enum-group all

Current configuration of ENUM groups

#

enum-group 1

rule 1 preference 1 408...(8333) 555\1 cc.news.com

#

enum-group 2

rule 2 preference 3 408...(8333) 888\1 cc.news2.com

#

End

表1-3 display voice enum-group命令显示信息描述表

字段

描述

Current configuration of ENUM groups

ENUM号码变换规则组的配置信息

enum-group 1

ENUM号码变换规则组

rule 1 preference 1 408…(8333) 5555\1 cc.news.com

ENUM号码变换规则组中的变换规则

 

1.1.7  display voice sip dns-record

【命令】

display voice sip dns-record [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

dns-record:显示SIP的DNS地址查询记录。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip dns-record命令用来显示SIP的DNS地址查询记录。

【举例】

# 显示SIP的DNS地址查询记录。

<Sysname> display voice sip dns-record

No.  Host                       IP

1    sip1.h3c.com              100.1.1.163:5060

2    sip2.8056.com             100.1.1.16:5060

表1-4 display voice sip dns-record命令显示信息描述表

字段

描述

No.

DNS地址查询记录序号

Host

查询域名

IP

域名对应的IP地址信息

 

1.1.8  display voice sip reason-mapping

【命令】

display voice sip reason-mapping { pstn-sip | sip-pstn } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip reason-mapping pstn-sip命令用来查询PSTN侧释放原因值到SIP状态码的映射关系。

display voice sip reason-mapping sip-pstn命令用来查询SIP状态码到PSTN侧释放原因值的映射关系。

【举例】

# 查询PSTN侧的释放原因值对应的SIP状态码关系。为了方便查看,显示信息中SIP-Status字段下的带有星号的数值是用户自定义的。

<Sysname> display voice sip reason-mapping pstn-sip

Release reason mapping of PSTN to SIP:

 

 Index       PSTN-Reason    SIP-Status     Default

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

  1              1            400*           404

  2              2            404            404

  3              3            404            404

  4             16            ---            ---

  5             17            486            486

  6             18            408            408

  7             19            480            480

  8             20            480            480

  9             21            403            403

 10             22            410            410

 11             23            410            410

 12             25            500            500

 13             26            404            404

 14             27            502            502

 15             28            484            484

 16             29            501            501

 17             31            480            480

 18             34            503            503

 19             38            503            503

 20             41            503            503

 21             42            503            503

 22             47            503            503

 23             55            403            403

 24             57            403            403

 25             58            503            503

 26             63            500            500

 27             65            488            488

 28             70            488            488

 29             79            501            501

 30             87            403            403

 31             88            503            503

 32            102            504            504

 33            111            500            500

 34            127            500            500

表1-5 display voice sip reason-mapping pstn-sip命令显示信息描述表

字段

描述

Index

索引号

PSTN-Reason

PSTN释放原因值

SIP-Status

配置的对应于PSTN释放原因值的SIP状态码(如果和默认值不一样,将加星号显示)

Default

默认的对应于PSTN释放原因值的SIP状态码

 

# 查询SIP状态码对应的PSTN侧的释放原因值关系。为了方便查看,显示信息中PSTN-Reason字段下的带有星号的数值是用户自定义的。

<Sysname> display voice sip reason-mapping sip-pstn

 

Release reason mapping of SIP to PSTN:

 

 Index       SIP-Status     PSTN-Reason    Default

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

  1            400            127*            41

  2            401             21             21

  3            402             21             21

  4            403             21             21

  5            404              1              1

  6            405             63             63

  7            406             79             79

  8            407             21             21

  9            408            102            102

 10            410             22             22

 11            413            127            127

 12            414            127            127

 13            415             79             79

 14            416            127            127

 15            420            127            127

 16            421            127            127

 17            423            127            127

 18            480             18             18

 19            481             41             41

 20            482             25             25

 21            483             25             25

 22            484             28             28

 23            485              1              1

 24            486             17             17

 25            487            127            127

 26            488            127            127

 27            500             41             41

 28            501             79             79

 29            502             38             38

 30            503             41             41

 31            504            102            102

 32            505            127            127

 33            513            127            127

 34            600             17             17

 35            603             21             21

 36            604              1              1

 37            606             58             58

表1-6 display voice sip reason-mapping sip-pstn命令显示信息描述表

字段

描述

Index

索引号

SIP-Status

SIP状态码

PSTN-Reason

配置的对应于SIP状态码的PSTN释放原因值(如果和默认值不一样,将加星号显示)

Default

默认的对应于SIP状态码的PSTN释放原因值

 

1.1.9  display voice sip dynamic-contact-address

【命令】

display voice sip dynamic-contact-address [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip dynamic-contact-address命令用来显示设备临时保存的SIP用户标识和其真实地址的映射信息。

【举例】

# 显示设备临时保存的动态获取到的SIP用户标识和其真实地址的映射信息。

<Sysname> display voice sip dynamic-contact-address

Number                        Entity Contact address      Expires  Type

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

1000                          40001  100.1.1.1:5060       3501     Register

2000                          40002  100.1.1.1:5060       20       Transfer

3000                          40003  cc.news.com:1120     25       Forward

表1-7 display voice sip dynamic-contact-address命令显示信息描述表

字段

描述

Number

用户标识,一般为电话号码。存在如下四种类型的用户标识:

·     设备临时保存漫游用户的注册号码

·     设备临时保存漫游用户订阅号码

·     收到3xx消息中携带的被前转的被叫号码

·     收到REFER消息中携带的被转接目的号码

Entity

为保存动态连接地址所创建的动态实体索引

Contact address

用户标识对应的真实连接地址

Expires

该用户标识的老化时间,时间单位为秒。

Type

表示创建该连接所对应的业务类型:

·     Register:漫游用户的注册

·     Subscribe:漫游用户的订阅

·     Forward:呼叫前转业务

·     Transfer: 呼叫转接业务

 

1.1.10  dns-type

【命令】

dns-type { a-record | srv }

undo dns-type

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

a-record:使用Type-A方式进行DNS查询。

srv使用SRV方式进行DNS查询。

【描述】

dns-type命令用来配置DNS查询方式。undo dns-type命令用来恢复缺省情况。

缺省情况下,使用a-record方式进行DNS查询。

需要注意的是,如果在address sip { dns domain-name [ port port-number ] | enum-group group-number }、proxy dns domain-name [ port port-number ]、mwi-server dns domain-name [ port port-number ]命令中指定了端口号,那么设备只能采用Type-A方式进行DNS查询。

相关配置可参考命令address sipproxy,以及“语音命令参考/语音业务”中的命令mwi-server

【举例】

# 配置使用SRV方式进行DNS查询。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] dns-type srv

1.1.11  display voice sip register-state

【命令】

display voice sip register-state [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

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

【举例】

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

<Sysname> display voice sip register-state

Number                    Entity     Registrar Server   Expires Status

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

105                       105        100.1.1.1:5060        N/A     login

2000                      107        100.1.1.1:5060        200     online

3000                      109        cc.news.com:1120      N/A     login

表1-8 display voice sip register-state命令显示信息描述表

字段

描述

Number

电话号码。处于正在注册、正在注销、注册在线、注册失败的电话号码

Entity

实体号

Registrar Server

注册服务器地址,采用IP地址加端口号或域名加端口号的方式表示

Expires

电话号码的注册老化时长,时间单位为秒

N/A表示电话号码没有注册成功

Status

表示该号码所处的状态:

offline:表示注册失败状态

online:表示注册成功状态

login:表示正在注册状态

logout:表示正在注销状态

dnsin:表示注册前进行DNS查询状态

dnsout:表示注销前进行DNS查询状态

 

1.1.12  early-media enable

【命令】

early-media enable

undo early-media enable

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

【描述】

early-media enable命令用来配置早期媒体协商,即设备作为被叫,向主叫回复带有媒体信息的183 Session Progress应答。undo early-media enable命令用来取消早期媒体协商,即设备作为被叫,向主叫回复不带媒体信息的180 Ringing应答。

缺省情况下,早期媒体协商功能处于开启状态,设备作为被叫,向主叫回复带有媒体信息的183 Session Progress应答。

【举例】

# 取消早期媒体协商,即设备作为被叫,向主叫回复不带媒体信息的180 Ringing应答。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] undo early-media enable

1.1.13  enum-group

【命令】

enum-group group-number

undo enum-group { group-number | all }

【视图】

拨号策略视图

【缺省级别】

2:系统级

【参数】

group-number:ENUM号码变换规则组号,取值范围为1~15,最多可以配置15个ENUM变换规则组。

all:删除所有ENUM号码变换规则组。

【描述】

enum-group命令用于创建一个ENMU号码变换规则组,并进入ENMU变换规则组视图。undo enum-group用于删除ENMU号码变换规则组。

缺省情况下,不存在ENUM号码变换规则组。

【举例】

# 创建ENUM号码变换规则组1,并进入ENUM号码变换视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] enum-group 1

[Sysname-voice-dial-enumgroup-1]

1.1.14  keepalive

【命令】

keepalive { options [ interval seconds ] | register }

undo keepalive

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

options:配置使用OPTIONS保活模式。

interval seconds:发送OPTIONS保活报文的时间间隔,取值范围为5~65535,单位为秒。缺省值为60秒。

register:配置使用REGISTER保活模式。

【描述】

keepalive命令用来配置保活模式。undo keepalive命令用来恢复缺省情况。

缺省情况下,使用register保活模式。

相关配置可参考命令redundancy mode

【举例】

# 配置使用OPTIONS保活模式,发送OPTIONS保活报文的时间间隔为30秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] keepalive options interval 30

1.1.15  line-check enable

【命令】

line-check enable

undo line-check

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

【描述】

line-check enable命令用来配置检查POTS语音实体下语音用户线的状态。undo line-check命令用来取消检查。

缺省情况下,在注册POTS语音实体下的号码时,需要检查与POTS语音实体绑定的语音用户线状态,只有配置语音用户线并且该语音用户线处于Up状态时,设备才能为号码发起注册请求。

相关配置可参考“语音命令参考/语音用户线”中的命令lineshutdown(Voice subscriber-line view)。

【举例】

# 取消检查POTS语音实体下语音用户线的状态。也就是说,只要配置了语音用户线,即使语音用户线处于shutdown状态,设备也可以为号码发起注册请求。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] undo line-check

1.1.16  listen transport

【命令】

listen transport { tcp | tls | udp }

undo listen transport { tcp | tls | udp }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

udp:表示开启UDP的传输方式,启动UDP侦听端口,侦听的端口号固定为5060。

tcp:表示开启TCP传输方式,启动TCP侦听端口,侦听的端口号固定为5060。

tls:表示开启TLS传输方式,启动TLS侦听端口,侦听的端口号固定为5061。

【描述】

listen transport命令用来开启传输协议的侦听端口。undo listen transport命令用来恢复缺省情况。

缺省情况下,同时开启UDP和TCP传输协议侦听端口,不开启TLS协议侦听端口。可以通过多次执行该命令来开启多个传输协议类型。三种传输协议互不影响。

以下两种情况需要配置该命令:

·     设备作为呼叫接收方,在接收相应传输协议的呼叫时,需要开启相应的传输协议的侦听端口。

·     使用registrar命令配置选用TCP/TLS协议向服务器发起注册时,必须在listen transport命令中完成相应传输协议的配置,否则设备无法发起注册请求。

需要注意的是:

·     配置TLS传输协议之前,必须已经使用crypto命令配置了TLS的客户端和服务器端策略,否则命令不生效。

·     当使用TCP/TLS传输协议时,执行undo listen transport命令会删除当前已经建立的连接。

相关配置可参考命令transportregistrar

【举例】

# 配置接收SIP呼叫时使用的传输协议为TLS。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] listen transport tls

1.1.17  media-protocol

【命令】

media-protocol { rtp | srtp } *

undo media-protocol

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

rtp:SIP呼叫使用RTP协议。

srtp:SIP呼叫使用SRTP协议。

【描述】

media-protocol命令用来配置SIP呼叫使用的媒体流协议。undo media-protocol命令用来恢复缺省情况。

缺省情况下,SIP呼叫使用RTP协议。

需要注意的是,如果同时配置RTP和SRTP协议,设备作为呼叫发起方,在发起呼叫时会携带两种媒体流协议,供接收方选择。设备作为呼叫接收方,会优先使用SRTP协议进行媒体流协商,若协商失败,则使用RTP协议。

【举例】

# 配置SIP呼叫使用SRTP协议。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] media-protocol srtp

1.1.18  outband sip

【命令】

outband sip

undo outband

【视图】

POTS/VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

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

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

关于采用H.225和H.245带外传输方式和NTE方式传输DTMF码的详细介绍请参见“语音配置指导”中的“语音实体”。

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 voip

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

[Sysname-voice-dial-entity10] outband sip

1.1.19  outbound-proxy

【命令】

outbound-proxy { dns domain-name | ipv4 ip-address } [ port port-number ]

undo outbound-proxy { dns | ipv4 }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

dns domain-name:外出代理服务器的域名,由“.”分隔的字符串组成(如aabbcc.com),每个字符串的长度不超过63个字符,包括“.”在内的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。

ipv4 ip-address:外出代理服务器的IPv4地址。

port port-number:端口号或外出代理服务器域名对应的端口号,取值范围为1~65535。

【描述】

outbound-proxy命令配置SIP UA使用的外出代理服务器信息。undo outbound-proxy命令用来删除SIP UA的外出代理服务器信息。

缺省情况下,没有配置SIP UA使用的外出代理服务器信息。

【举例】

# 配置SIP UA使用的外出代理服务器的IPv4地址为169.54.5.10,端口号为1120。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] outbound-proxy ipv4 169.54.5.10 port 1120

# 配置SIP UA使用的外出代理服务器的域名为abc.com,外出代理服务器域名对应的端口号为1100。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] outbound-proxy dns abc.com port 1100

1.1.20  privacy

【命令】

privacy { asserted | preferred }

undo privacy

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

asserted:添加P-Asserted-Identity头域。其中Privacy头域中包含是否隐藏主叫号码的信息,P-Asserted-Identity头域包含有主叫方的电话号码。

preferred:添加P-Preferred-Identity头域。其中Privacy头域中包含是否隐藏主叫号码的信息,P-Preferred-Identity头域包含有主叫方的电话号码。

【描述】

privacy命令用来配置P-Preferred-Identity头域或P-Asserted-Identity头域。undo privacy命令用来取消已有配置。

缺省情况下,没有添加P-Preferred-Identity头域或P-Asserted-Identity头域。

【举例】

# 添加P-Asserted-Identity头域。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] privacy asserted

1.1.21  proxy

【命令】

proxy { dns domain-name | ipv4 ip-address } [ port port-number ]

undo proxy { dns | ipv4 }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

dns domain-name:代理服务器的域名,由“.”分隔的字符串组成(如aabbcc.com),每个字符串的长度不超过63个字符,包括“.”在内的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。

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

port port-number:代理服务器的端口号,取值范围为1~65535。

【描述】

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

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

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

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

# 配置SIP代理服务器地址为abc.com,端口号为1100。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] proxy dns abc.com port 1100

1.1.22  reason-mapping pstn

【命令】

reason-mapping pstn pstn-code sip sip-code

undo reason-mapping pstn pstn-code

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

pstn-code:PSTN释放原因值。取值范围为1~127,但仅对表1-9中的PSTN释放原因值有效(释放原因值16也不能进行配置,因为16对应的是SIP请求消息,而不是SIP状态码)。

sip-code:SIP状态码。取值范围为400~699。

【描述】

reason-mapping pstn命令用来配置PSTN侧的释放原因值对应的SIP状态码undo reason-mapping pstn命令用来恢复缺省情况。

缺省情况下,PSTN侧的释放原因值和SIP状态码的对应关系参见表1-9

表1-9 PSTN释放原因值和SIP状态码的默认对应关系

PSTN释放原因值

PSTN释放原因值描述

SIP状态码

SIP状态码描述

1

Unallocated (unassigned) number!

404

Not Found

2

No route to specified transit network!

404

Not Found

3

No route to destination!

404

Not Found

16

Normal clearing!

---

BYE or CANCEL

17

User busy!

486

Busy here

18

No user responding!

408

Request Timeout

19

No answer from user!

480

Temporarily unavailable

20

Subscriber absent!

480

Temporarily unavailable

21

Call rejected!

403

Forbidden

22

Number changed!

410

Gone

23

Redirection to new destination!

410

Gone

25

Exchange routing error!

500

Server internal error

26

Non-selected user clearing!

404

Not Found

27

Destination out of order!

502

Bad Gateway

28

Invalid number format (address incomplete)!

484

Address incomplete

29

Facility rejected!

501

Not implemented

31

Normal, unspecified!

480

Temporarily unavailable

34

No circuit/channel available!

503

Service unavailable

38

Network out of order!

503

Service unavailable

41

Temporary failure!

503

Service unavailable

42

Switching equipment congestion!

503

Service unavailable

47

Resource unavailable, unspecified!

503

Service unavailable

55

Incoming class barred within Closed User Group (CUG)!

403

Forbidden

57

Bearer capability not authorized!

403

Forbidden

58

Bearer capability not presently available!

503

Service unavailable

63

Service or option not available, unspecified!

500

Server internal error

65

Bearer capability not implemented!

488

Not Acceptable Here

70

Only restricted digital information bearer capability is available!

488

Not Acceptable Here

79

Service or option not implemented, unspecified!

501

Not implemented

87

User not member of Closed User Group (CUG)!

403

Forbidden

88

Incompatible destination!

503

Service unavailable

102

Recovery on timer expiry!

504

Gateway timeout

111

Protocol error, unspecified!

500

Server internal error

127

Interworking, unspecified!

500

Server internal error

 

【举例】

# 配置PSTN侧的释放原因值17对应SIP状态码408。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice -sip] reason-mapping pstn 17 sip 408

1.1.23  reason-mapping sip

【命令】

reason-mapping sip sip-code pstn pstn-code

undo reason-mapping sip sip-code

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

sip-code:SIP状态码。取值范围为400~699,但仅对表1-10中的SIP状态码有效。

pstn-code:PSTN释放原因值。取值范围为1~127,但仅对表1-9中的PSTN释放原因值有效。

【描述】

reason-mapping sip命令用来配置SIP状态码对应的PSTN侧的释放原因值。undo reason-mapping sip命令用来恢复缺省情况。

缺省情况下,SIP状态码和PSTN侧的释放原因值的对应关系参见表1-10

表1-10 SIP状态码和PSTN释放原因值的默认对应关系

SIP状态码

SIP状态码描述

PSTN释放原因值

PSTN释放原因值描述

400

Bad Request

41

Temporary failure!

401

Unauthorized

21

Call rejected!

402

Payment required

21

Call rejected!

403

Forbidden

21

Call rejected!

404

Not found

1

Unallocated (unassigned) number!

405

Method not allowed

63

Service or option not available, unspecified!

406

Not acceptable

79

Service or option not implemented, unspecified!

407

Proxy authentication required

21

Call rejected!

408

Request timeout

102

Recovery on timer expiry!

410

Gone

22

Number changed!

413

Request Entity too long

127

Interworking, unspecified!

414

Request-URI too long

127

Interworking, unspecified!

415

Unsupported media type

79

Service or option not implemented, unspecified!

416

Unsupported URI Scheme

127

Interworking, unspecified!

420

Bad extension

127

Interworking, unspecified!

421

Extension Required

127

Interworking, unspecified!

423

Interval Too Brief

127

Interworking, unspecified!

480

Temporarily unavailable

18

No user responding!

481

Call/Transaction Does not Exist

41

Temporary failure!

482

Loop Detected

25

Exchange routing error!

483

Too many hops

25

Exchange routing error!

484

Address incomplete

28

Invalid number format (address incomplete)!

485

Ambiguous

1

Unallocated (unassigned) number!

486

Busy here

17

User busy!

487

Request Terminated

127

Interworking, unspecified!

488

Not Acceptable here

127

Interworking, unspecified!

500

Server internal error

41

Temporary failure!

501

Not implemented

79

Service or option not implemented, unspecified!

502

Bad gateway

38

Network out of order!

503

Service unavailable

41

Temporary failure!

504

Server time-out

102

Recovery on timer expiry!

505

Version Not Supported

127

Interworking, unspecified!

513

Message Too Large

127

Interworking, unspecified!

600

Busy everywhere

17

User busy!

603

Decline

21

Call rejected!

604

Does not exist anywhere

1

Unallocated (unassigned) number!

606

Not acceptable

58

Bearer capability not presently available!

 

【举例】

# 配置SIP状态码486对应PSTN侧的释放原因值18。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] reason-mapping sip 486 pstn 18

1.1.24  register-enable

【命令】

register-enable { off | on }

undo register-enable

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

off:禁止SIP注册功能。

on:开启SIP注册功能。

【描述】

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

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

【举例】

# 开启SIP注册功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] register-enable on

1.1.25  redundancy mode

【命令】

redundancy mode { homing | parking }

undo redundancy mode

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

homing:选用homing备份模式。

parking:选用parking备份模式。

【描述】

redundancy mode命令配置备份模式。undo redundancy mode命令用来恢复缺省情况。

缺省情况下,采用parking备份模式。

相关配置可参考命令keepalive

【举例】

# 配置备份模式为homing模式。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] redundancy mode homing

1.1.26  registrar

【命令】

registrar { dns domain-name | ipv4 ip-address } [ port port-number ] [ expires seconds ] [ tcp | tls ] [ scheme { sip | sips } ] [ slave ]

undo registrar ipv4 { dns | ipv4 } [ slave ]

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

dns domain-name:设置注册服务器的域名,由“.”分隔的字符串组成(如aabbcc.com),每个字符串的长度不超过63个字符,包括“.”在内的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。

ipv4 ip-address:注册服务器的IP地址。

port port-number:注册服务器的端口号,取值范围为1~65535。

expires seconds:注册老化时长,取值范围为60~65535,单位为秒。如果没有配置该值,则使用SIP客户端视图下timer registration expires配置的全局注册老化时长。

tcp:向服务器注册时采用TCP传输协议,缺省情况下,采用UDP传输协议。

tls:向服务器注册时采用TLS传输协议。

scheme:注册使用的URL方案类型。

sip:SIP格式的URL方案,缺省情况下,SIP格式的URL方案。

sips:SIPS格式的URL方案。

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

【描述】

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

缺省情况下,没有配置SIP UA使用的注册服务器信息。配置时如果不选择传输协议类型,则缺省使用UDP传输协议发起注册;不选择URL方案类型,缺省使用SIP格式的URL方案。

需要注意的是:

·     使用registrar命令配置的传输协议类型前,必须在listen transport命令中已经配置,否则无法发起注册请求。

·     如果配置使用TLS传输协议,需要通过crypto命令配置了客户端的SSL策略名称,否则无法发起注册请求。

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

【举例】

# 设置主用注册服务器地址为169.54.5.10,端口号为1120,注册老化时长为120秒,使用TCP传输协议。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

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

# 设置主用注册服务器地址为cc.news.com,端口号为1100,注册老化时长为120秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] registrar dns cc.news.com port 1100 expires 120

1.1.27  remote-party-id

【命令】

remote-party-id

undo remote-party-id

【视图】

SIP客户端视图

【参数】

【描述】

remote-party-id命令用来添加Remote-Party-ID头域。undo remote-party-id命令用来取消已有配置。

缺省情况下,没有添加Remote-Party-ID头域。

【举例】

# 配置添加Remote-Party-ID头域。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] remote-party-id

1.1.28  reset voice sip connection

【命令】

reset voice sip connection { tcp | tls } id conn-id

【视图】

用户视图

【缺省级别】

1:监控级

【参数】

tcp:删除TCP连接信息。

tls:删除TLS连接信息。

conn-id:连接ID值,可以通过display voice sip connection来确定conn-id字段值,取值范围为0~1499。

【描述】

reset voice sip connection命令用来清除SIP传输层的连接信息,包括已经建立和正在建立的连接信息。

【举例】

# 清除连接ID为1的TCP连接信息。

<Sysname> reset voice sip connection tcp id 1

1.1.29  reset voice sip dns-record

【命令】

reset voice sip dns-record

【视图】

用户视图

【缺省级别】

2:系统级

【参数】

【描述】

reset voice sip dns-record命令用来清除SIP的DNS查询记录。

【举例】

# 清除SIP的DNS查询记录。

<Sysname> reset voice sip dns-record

1.1.30  reset voice sip statistics

【命令】

reset voice sip statistics

【视图】

用户视图

【缺省级别】

2:系统级

【参数】

【描述】

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

【举例】

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

<Sysname> reset voice sip statistics

1.1.31  rule

【命令】

rule tag preference value match-pattern replacement-rule domain-name

undo rule { tag | all }

【视图】

ENUM号码变换组视图

【缺省级别】

2:系统级

【参数】

tag:ENUM号码变换规则序号,取值范围为1~2147483647,最多可以配置8个变换规则。

preference value:规则优先级,取值范围为1~2147483647,取值越小表示优先级越高。

match-pattern:匹配输入的电话号码,支持正则表达式。取值范围为1~31个字符,包括数字和正则表达式允许的( ) [ - ^ ] { , } | * + .等特殊字符。其中,-和^只能在[]和{}中使用。

replacement-rule:匹配规则,支持正则表达式。取值范围为1~31个字符,其中包括数字和特殊字符\。

domain-name:DNS查询的域名。由“.”分隔的字符串组成(如cc.news.com),包括“.”在内的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。

all:所有的ENUM号码变换规则序号。

【描述】

rule命令用于配置ENUM号码变换规则。undo rule命令用来删除已配置的ENUM号码变换规则。

缺省情况下,没有配置ENUM号码变换规则。

【举例】

# 配置ENUM号码变换规则。规则为1,优先级为500,用户输入的电话号码为01082775326,匹配规则后,变换后的电话号码为8277,添加beijing.gov后成为,设备会向域名7.7.2.8.beijing.gov发起查询请求。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] enum-group 1

[Sysname-voice-dial-enum1] rule 1 preference 500 010(.{4}).* \1 beijing.gov

1.1.32  sip

【命令】

sip

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

【描述】

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

【举例】

# 进入SIP客户端视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip]

1.1.33  sip-comp

【命令】

sip-comp { callee | dt | from | substitute | t38 | x-parameter | ms } *

undo sip-comp { callee | dt | from | substitute | t38 | x-parameter | ms } *

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

callee:表示系统从To头域中选取目的号码。

dt:在注册或取消注册时,需要在SIP注册报文的Contact头域中携带dt参数。该参数用于设备和VCX互通时使用。

from:表示设备发送SIP报文时,From头域使用To头域中的地址(IP地址或DNS域名)。通常情况下,From头域中包含请求方地址,To头域包含目的方地址。

substitute:设备做主叫时,表示将被叫号码中的“#”转换成ASCII码“%23”;设备做被叫时,设备会将收到的被叫号码中的“%23”转换为“#”,并在后续发送的请求和响应消息中的Contact头域中,将被叫号码中的“#”转换为ASCII码“%23”。通常情况下,如果转换后的被叫号码超过31位,则只发送前31位。受此长度限制,设备可能无法对所有“#”进行转换,此时发送号码可能会少于31位,例如,号码“123456789012345678901234567##89”转换后为“123456789012345678901234567%23”。

t38:表示在进行SIP方式的标准T.38传真时,发送的re-INVITE和对re-INVITE的200 OK应答报文的SDP中,对于T38FaxTranscodingJBIG、T38FaxTranscodingMMR、T38FaxFillBitRemoval传真参数均不包含“:0”。

x-parameter:表示在传真透传或modem透传时,发送的re-INVITE和对re-INVITE的200 OK应答报文的SDP中,传真透传包含X-fax描述,Modem透传包含X-modem描述。

ms:进行微软产品互通时,启用微软模式。

【描述】

sip-comp命令用来配置SIP兼容性。undo sip-comp命令用来恢复缺省情况。

缺省情况下:

·     从Request-Line中选取目的号码(Request-Line是SIP请求消息的起始行,Request-Line中包含目的号码)。

·     From头域中包含请求方地址,To头域包含目的方地址;

·     设备在发re-INVITE请求时不主动携带这些兼容选项字段;

·     在注册或取消注册时,SIP注册报文的Contact头域中不携带dt参数。

·     不对被叫号码中的“#”和ASCII码“%23”进行转换。

·     不启用微软模式

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] sip-comp from

# 配置x-parameter兼容参数。在传真透传或modem透传时,使发送re-INVITE报文的SDP中包含相应的事件描述。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] sip-comp x-parameter

1.1.34  sip-comp agent

【命令】

sip-comp agent product-name product-version

undo sip-comp agent

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

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

【描述】

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

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

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

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

1.1.35  sip-comp server

【命令】

sip-comp server product-name product-version

undo sip-comp server

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

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

【描述】

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

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

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

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

1.1.36  sip-domain

【命令】

sip-domain domain-name

undo sip-domain

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

domain-name:SIP设备的域名,取值范围为:0~9,A~Z,a~z,_,-,.。长度为1~31个字符,不区分大小写。

【描述】

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

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

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

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

1.1.37  source-bind

【命令】

source-bind { media | signal } { interface-type interface-number | ipv4 ip-address }

undo source-bind { media | signal }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

media:媒体流。

signal:信令流。

interface-type interface-number:指定接口类型和编号类型,目前只支持三层Ethernet、GigabitEthernet和Dialer接口。

ipv4 ip-address:绑定的IPv4地址。

【描述】

source-bind命令用来配置SIP支持源地址或接口绑定。undo source-bind命令用来删除已有的绑定配置。

缺省情况下,没有配置SIP源地址绑定功能。

【举例】

# 配置静态IP地址1.1.1.1为信令流的源地址。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] source-bind signal ipv4 1.1.1.1

1.1.38  timer connection age

【命令】

timer connection age { tcp tcp-age-time | tls tls-age-time }

undo timer connection age { tcp | tls }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

tcp tcp-age-time:TCP连接的老化时间,TCP连接的老化时间是指建立的TCP连接处于空闲状态的时间,老化时间过后,会删除连接。取值范围为5~30,单位为分钟。

tls tls-age-time:TLS连接的老化时间,TLS连接的老化时间是指建立的TLS连接处于空闲状态的时间,老化时间过后,会删除连接。取值范围为30~180,单位为分钟。

【描述】

timer connection age用来配置TCP和TLS连接的老化时间。undo timer connection age命令用来缺省情况。

缺省情况下,TCP连接的老化时间为5分钟,TLS连接的老化时间为30分钟。

【举例】

# 配置TCP连接老化时间为6分钟,TLS连接的老化时间为60分钟。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer connection age tcp 6

[Sysname-voice-sip] timer connection age tls 60

1.1.39  timer registration retry

【命令】

timer registration retry seconds

undo timer registration retry

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

seconds:注册失败后,到发起下一轮注册的间隔时间,取值范围为10~3600,单位为秒。

【描述】

timer registration retry命令用来配置注册失败后,到发起下一轮注册的间隔时间。undo timer registration retry命令用来恢复缺省情况。

缺省情况下,注册失败后,到发起下一轮注册的间隔时间为240秒。

【举例】

# 配置注册失败后,到发起下一轮注册的时间间隔为300秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer registration retry 300

1.1.40  timer registration expires

【命令】

timer registration expires seconds

undo timer registration expires

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

seconds:注册老化时长,取值范围为60~3600,单位为秒。

【描述】

timer registration expires命令用来配置注册老化时长。undo timer registration expires命令用来恢复缺省情况。

缺省情况下,注册老化时长为3600秒。

相关配置可参考命令registrar server-groupregistrartimer registration thresholdtimer registration divider

【举例】

# 配置注册老化时长为600秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer registration expires 600

1.1.41  timer registration divider

【命令】

timer registration divider percentage

undo timer registration divider

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

percentage:注册老化时长的百分比,取值范围为50~100。

【描述】

timer registration divider命令用来配置注册老化时长的百分比。undo timer registration divider命令用来恢复缺省情况。

缺省情况下,注册老化时长的百分比为80。

相关配置可参考命令timer registration expirestimer registration threshold

【举例】

# 配置注册老化时长的百分比为50%。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer registration divider 50

1.1.42  timer registration threshold

【命令】

timer registration threshold seconds

undo timer registration threshold

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

seconds:注册老化时长的提前量,取值范围为0~3600,单位为秒。

【描述】

timer registration threshold命令用来配置注册老化时长的提前量。undo timer registration-threshold命令用来恢复缺省情况。

缺省情况下,注册老化时长的提前量为0秒。

相关配置可参考命令timer registration expirestimer registration divider

【举例】

# 配置注册老化时长的提前量为100秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer registration threshold 100

1.1.43  timer session-expires

【命令】

timer session-expires seconds [ minimum min-seconds ]

undo timer session-expires

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

seconds:SIP会话老化时间,取值范围为90~65535,单位为秒。

minimum min-seconds:会话更新最短时间间隔,取值范围为90~65535,单位为秒。

【描述】

timer session-expires命令用来配置SIP会话定期更新。undo timer session-expires命令用来恢复缺省情况。

缺省情况下:

·     不主动启用会话定期更新机制。不主动启用会话定期更新机制是指如果被叫方关闭会话定期更新,而主叫方开启了会话定期更新,那么在呼叫过程中通过协商,被叫也会启用定期更新机制。

·     会话最短时间间隔为90秒。

【举例】

# 配置SIP会话老化时间为1800秒,会话更新最短时间间隔为1000秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] timer session-expires 1800 minimum 1000

1.1.44  transport

【命令】

transport { tcp | tls | udp }

undo transport

【视图】

SIP客户端视图/VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

udp:发起呼叫时,采用UDP传输协议。

tcp:发起呼叫时,采用TCP传输协议。

tls:发起呼叫时,采用TLS传输协议。

【描述】

transport命令用来配置发起SIP呼叫时采用的传输协议类型。undo transport命令用来恢复缺省情况。

缺省情况下,全局传输协议类型为UDP协议。VoIP语音实体下没有缺省传输协议类型。如果该语音实体下没有配置传输协议,那么该VoIP语音实体的缺省情况与全局传输协议相同。

SIP客户端视图下的transport命令表示的是全局采用的传输协议类型,如果用户需要针对某一个呼叫采用其他的传输协议时,可以在对应的VoIP语音实体视图下配置相应的传输协议类型。当VoIP语音实体视图下配置的传输协议类型与SIP客户端视图下的transport命令配置的传输协议类型不一致时,则使用该VoIP语音实体下的配置,即VoIP语音实体配置优先于全局配置。

需要注意的是:

·     当语音实体是SIP类型的VoIP语音实体时,该命令才能生效。

·     发送方和接收方必须同时配置相同的传输协议类型,如在发送方配置transport tcp,那么在接收方需要配置listen transport tcp

·     配置TLS传输协议时之前,需要通过crypto命令配置客户端和服务器的SSL策略名称,否则无法发起会话请求。

·     如果已经配置address sip server-group命令,则使用该命令配置的传输协议类型。

·     如果已经配置address sip proxy命令,并且SIP客户端视图下配置了proxy server-group命令时,则使用proxy server-group命令中选用的服务器所配置的传输协议类型。

【举例】

# 配置SIP呼叫采用TLS传输协议。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] transport tls

1.1.45  trusted-point

【命令】

trusted-point ipv4 ipv4-address

undo trusted-point { ipv4 ipv4-address | all }

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

ipv4 ipv4-address:可信节点的IPv4地址。

all:所有可信节点信息。

【描述】

trusted-point命令用来配置可信节点。undo trusted-point命令用来删除指定IP地址的可信节点或所有可信节点。

缺省情况下,没有配置可信节点。

最多可配置100个可信节点。

【举例】

# 配置可信节点192.168.0.10。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] trusted-point ipv4 192.168.0.10

1.1.46  uri

【命令】

uri user-info [ domain domain-name ]

undo uri

【视图】

POTS语音实体视图

【缺省级别】

2:系统级

【参数】

user-info:标识发起呼叫的用户名称,字符串的长度不超过31个字符,不区分大小写,字符串中可以包含字母、数字、“.”、“-”及“_”,包括用户域名部分的总长度不超过255个字符。

domain domain-name:标识发起呼叫的用户所在域的域名,由“.”分隔的字符串组成(如aabbcc.com),每个字符串的长度不超过63个字符,包括“.”在内,包括用户名称部分的总长度不超过255个字符。不区分大小写,字符串中可以包含字母、数字、“-”及“_”。如果没有配置该参数,则使用sip-domain命令配置的SIP设备的域名标识domain-name。如果没有配置SIP设备的域名,则使用接口IP地址代替domain-name

【描述】

uri命令用于配置用户身份,即使用“user-info@domain-name”的格式发送请求报文。undo uri命令用来删除已配置的用户身份。

缺省情况下,使用“号码@SIP设备的域名或接口IP地址”的格式发送请求报文。

相关配置可参考命令sip-domain

【举例】

# 为POTS语音实体下配置标识发起呼叫的用户名称为hello,发起呼叫的用户所在域的域名为voice.com。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 10 pots

[Sysname-voice-dial-entity10] uri user-info hello domain voice.com

1.1.47  url

【命令】

url { sip | sips }

undo url

【视图】

SIP客户端视图/VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

sip:指定在SIP呼叫时使用SIP格式的URL方案类型。

sips:指定在SIP呼叫时使用SIPS格式的URL方案类型。

【描述】

url命令配置SIP呼叫时使用的URL类型。undo url命令用来恢复缺省情况。

SIP客户端视图下的url命令为全局命令,当VoIP语音实体下配置了URL类型时,则使用VoIP语音实体配置,否则使用该命令配置的URL类型,即VoIP语音实体配置优先于全局配置。

缺省情况下,采用SIP格式的URL方案。

需要注意的是:

·     配置SIPS的URL类型时,传输协议类型必须是TLS,否则将无法发起会话。

·     如果已经配置address sip server-group命令,则使用该命令配置的URL类型。

·     如果已经配置address sip proxy命令,并且SIP客户端视图下配置了proxy server-group命令时,则使用proxy server-group命令中选用的服务器所配置的URL类型。

【举例】

# 设置全局SIP呼叫使用SIPS格式的URL方案。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] url sips

# 配置VoIP实体SIP呼叫使用SIPS格式的URL方案。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1000 voip

[Sysname-voice-dial-entity1000] url sips

1.1.48  user

【命令】

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

undo user

【视图】

SIP客户端视图/POTS/IVR语音实体视图

【缺省级别】

2:系统级

【参数】

username:注册鉴权时使用的用户名,长度为1~63个字符,区分大小写,‘”’和‘\’为无效字符。

cipher:以密文方式设置用户的密码。

simple:以明文方式设置用户的密码。

password:设置鉴权使用的明文密码或密文密码,区分大小写。明文密码的长度范围是1~16;密文密码的长度范围是1~53。

cnonce cnonce:鉴权信息字段,用于服务器和SIP UA之间的握手验证,为1~50个字符的字符串,区分大小写,‘”’和‘\’为无效字符。

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

【描述】

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

缺省情况下,没有SIP鉴权信息。

以明文或密文方式设置的密码,均以密文的方式保存在配置文件中。

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

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

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

 

【举例】

# 配置全局SIP鉴权信息,用户名为abcd,以明文方式设置用户。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] user abcd password simple 1234

# 在IVR语音实体下配置SIP鉴权信息,以明文方式设置用户密码为1234。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 100 ivr

[Sysname-voice-dial-entity100] user abcd password simple 1234

1.1.49  vpn-instance

【命令】

vpn-instance vpn-instance-name

undo vpn-instace

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

vpn-instance-name:MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,区分大小写。

【描述】

vpn-instance命令用来配置使用SIP协议的语音服务绑定的VPN。undo vpn-instance命令用来取消已有配置。

缺省情况下,没有配置使用SIP协议的语音服务绑定的VPN。

需要注意的是:

·     在没有SIP语音服务(包括SIP语音呼叫、注册、SIP订阅,本地存活服务器等)运行的情况下才能配置该命令。配置后,该命令对所有使用SIP协议的语音服务生效。

·     如果要使用SIP支持源地址绑定功能,为了该功能的正常使用,需要确保使用SIP协议的语音服务绑定的VPN,与源地址绑定命令指定接口下关联的VPN实例应该保持一致。

【举例】

# 配置使用SIP协议的语音服务绑定的VPNvpn-voice

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] vpn-instance vpn-voice

1.1.50  wildcard-register enable

【命令】

wildcard-register enable

undo wildcard-register

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

【描述】

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

缺省情况下,电话号码模糊(通配符)注册功能处于关闭状态。

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

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

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

 

【举例】

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

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] wildcard-register enable


2 SIP本地存活

2.1  SIP本地存活命令

2.1.1  area-prefix

【命令】

area-prefix prefix

undo area-prefix { prefix | all }

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

prefix:区域前缀,只能是数字,取值范围为1~15。

all:删除所有的区域前缀。

【描述】

area-prefix命令用来配置号码区域前缀。undo area-prefix命令用来取消已经配置的号码区域前缀。

缺省情况下,没有配置任何区域前缀。

最多可以配置八条区域前缀。如果配置了多条区域前缀,SIP本地服务器采用深度匹配原则选择匹配深度最大的前缀进行处理。

【举例】

# 配置号码区域前缀。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] area-prefix 8277

[Sysname-voice-server] area-prefix 0108277

2.1.2  authentication

【命令】

authentication username username password { cipher | simple } password

undo authentication

【视图】

register-user视图

【缺省级别】

2:系统级

【参数】

username username:注册鉴权时使用的用户名,长度为1~63个字符,区分大小写,‘\’和‘”’为无效字符。

cipher:以密文方式设置用户的密码。

simple:以明文方式设置用户的密码。

password password:设置注册鉴权使用的明文密码或密文密码,区分大小写。明文密码的长度范围是1~16;密文密码的长度范围是1~53。

【描述】

authentication命令用来配置鉴权信息。undo authentication命令用来取消配置的鉴权信息。

缺省情况下,没有配置鉴权信息。

需要注意的是:

·     当SIP本地服务器需要进行鉴权时,必须通过该命令配置鉴权信息才能注册成功。

·     以明文或密文方式设置的密码,均以密文的方式保存在配置文件中。

【举例】

# 配置鉴权信息。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] register-user 1234

[Sysname-voice-server-user1234] authentication username 1234 password simple 1234

2.1.3  call-route

【命令】

call-route

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

【描述】

call-route命令用来进入call-route视图。

【举例】

# 进入call-route视图

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-route

[Sysname-voice-server-route]

2.1.4  call-rule-set

【命令】

call-rule-set

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

【描述】

call-rule-set命令用来进入call-rule-set视图。

【举例】

# 进入call-rule-set视图

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-rule-set

[Sysname-voice-server-set]

2.1.5  srs

【命令】

srs tag

undo srs

【视图】

sip-server视图/register-user视图

【缺省级别】

2:系统级

【参数】

tag:规则集标签,取值范围为0~31,并且必须是已经配置的呼叫限制规则集对应的tag值。

【描述】

srs命令用来应用相应的呼叫限制规则集。undo srs命令用来取消应用关系。

缺省情况下,没有应用任何呼叫限制规则集。

【举例】

# 在register-user视图下应用呼叫限制规则集。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-rule-set

[Sysname-voice-server-set] service 1

[Sysname-voice-server-set-svc0] rule 1 permit outgoing 5...

[Sysname-voice-server-set-svc0] rule 2 permit outgoing 1...

[Sysname-voice-server-set-svc0] quit

[Sysname-voice-server-set] quit

[Sysname-voice-server] register-user 1000

[Sysname-voice-server-user1000] srs 1

# 在sip-server视图下应用呼叫限制规则集。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] srs 1

2.1.6  display voice sip-server register-user

【命令】

display voice sip-server register-user { tag | all } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

tag:指定用户的状态信息。

all:所有用户的状态信息。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip-server register-user命令用来查看注册用户的信息,包括号码、注册状态、注册的IP地址及端口号。

【举例】

# 查看注册用户的信息。

<Sysname> display voice sip-server register-user all

user       number       status                    address

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

1          404          online                    192.168.0.98:5060

2          325          offline                   

3          380          online                    192.168.0.57:5060

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

字段

描述

user

用户的tag

number

用户的号码

status

用户的注册状态:

offline表示注销状态

online表示注册状态

address

用户注册的IP地址及端口号

 

2.1.7  display voice sip-server resource-statistic

【命令】

display voice sip-server resource-statistic [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip-server resource-statistic命令用来查看服务器资源使用情况。

【举例】

# 查看服务器资源信息。

<Sysname> display voice sip-server resource-statistic

 

SIP Server state: Active

 

    CbType        Total        Used        Free

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

    SLC_Conf      64           0           64

    SLC_Call      128          0           128

    SLC_Sub       64           0           64

    SLC_Reg       64           0           64

    SSA_Call      128          0           128

    SSA_Sub       128          0           128

表2-2 display voice sip-server resource-statistic命令显示信息描述表

字段

描述

SIP Server state

本地SIP服务器的状态:

·     Active:SIP本地存活服务器处于可用状态

·     Inactive:SIP本地存活服务器处于不可用状态

CbType

资源控制模块类型

Total

资源控制模块的总数

Used

正在使用的资源控制模块个数

Free

剩余的资源控制模块个数

SLC_Conf

SLC(Service Logic Control,呼叫控制模块)总控制模块

SLC_Call

SLC呼叫模块

SLC_Sub

SLC订阅模块

SLC_Reg

SLC注册模块

SSA_Call

SSA(SIP Stack Adapt,SIP适配模块)呼叫模块

SSA_Sub

SSA订阅模块

 

2.1.8  expires

【命令】

expires time-interval

undo expires

【视图】

register-user视图

【缺省级别】

2:系统级

【参数】

time-interval:最长注册间隔时间,单位为秒,取值范围为300~65535。

【描述】

expires命令用来配置最长注册间隔时间。undo expires命令用来恢复缺省情况。

缺省情况下,最长注册间隔时间为server-bind ipv4配置的全局注册间隔时长。

此命令用于配置用户注册间隔时间,当某个用户没有配置自己的用户注册间隔时间时,使用全局注册间隔时间。当用户发送的注册请求的时间间隔大于设置的时间时,服务器返回设置的时间值。

相关配置请参见命令server-bind ipv4

【举例】

# 设置注册用户1234的最长注册间隔时间为3700秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] register-user 1234

[Sysname-voice-server-user1234] expires 3700

2.1.9  mode

【命令】

mode { alive-server | alone-server }

undo mode

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

alive-server:服务器运行于本地存活模式。

alone-server:服务器运行于独立模式。

【描述】

mode命令用来配置服务器运行模式。undo mode命令用来恢复缺省情况。

缺省情况下,服务器运行于独立模式。

需要注意的是,只有在服务器处于不可用状态下,才能更改服务器运行模式配置。

相关配置可参考命令server enable

【举例】

# 配置服务器运行模式为本地存活模式。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname–voice-server] mode alive-server

2.1.10  number

【命令】

number party-number

undo number

【视图】

register-user视图

【缺省级别】

2:系统级

【参数】

party-number:注册用户的电话号码,只能是数字,取值范围为1~31。

【描述】

number命令用来配置注册用户的电话号码。undo number命令用来取消配置的电话号码。

缺省情况下,没有配置任何注册用户的电话号码。

【举例】

# 设置注册用户1234的电话号码为300。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] register-user 1234

[Sysname-voice-server-user1234] number 300

2.1.11  probe remote-server

【命令】

probe remote-server ipv4 ipv4-address [ port port-number ] [ keepalive time-interval ]

undo probe remote-server ipv4

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

ipv4 ipv4-address:远端服务器的IPv4地址。

port port-number:远端服务器端口号,取值范围为1~65535,缺省值为5060。

keepalive time-interval:向远端服务器定时发送OPTION报文的时间间隔,单位为秒,取值范围为64~128。缺省时间为64秒。

【描述】

probe remote-server ipv4命令用来配置保活检测。undo probe remote-server ipv4命令用来取消保活检测配置。

缺省情况下,没有配置保活检测。

SIP本地服务器运行于本地存活模式时,保活检测配置命令只有在SIP本地服务器处于关闭状态下才允许配置。

【举例】

# 配置保活检测。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname–voice-server] probe remote-server ipv4 192.168.0.92 keepalive 100

2.1.12  register-user

【命令】

register-user tag

undo register-user { tag | all }

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

tag:用户标签,该标签全局唯一,取值范围为1~2147483647。

all:所有用户标签。

【描述】

register-user命令用来创建一个注册用户视图,并进入该用户视图undo register-user命令用来取消所创建的用户视图。

缺省情况下,没有创建任何注册用户。

【举例】

# 创建注册用户1234。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] register-user 1234

[Sysname-voice-server-user1234]

2.1.13  rule

【命令】

rule tag { deny | permit } { incoming | outgoing } { pattern | any }

undo rule { tag | all }

【视图】

service视图

【缺省级别】

2:系统级

【参数】

tag:呼叫限制规则标签,取值范围为0~31。

deny:表示禁止呼叫。

permit:表示允许呼叫。

incoming:表示入呼叫限制。

outgoing:表示出呼叫限制。

pattern:号码模式,只支持数字与点号“.”,每个点号代表一个字符,且点号只能出现在号码的末尾位置,目前不支持其他字符。

any:表示所有号码。

all:表示所有规则。

【描述】

rule命令用来配置呼叫限制规则。undo rule命令用来取消所配置的呼叫限制规则。

缺省情况下,没有配置任何呼叫限制规则。

【举例】

# 配置呼叫限制规则。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-rule-set

[Sysname-voice-server-set] service 1

[Sysname-voice-server-set–svc1] rule 1 deny incoming 2....

2.1.14  service

【命令】

service tag

undo service { tag | all }

【视图】

call-rule-set视图

【缺省级别】

2:系统级

【参数】

tag:呼叫限制规则集的标签号,取值范围为0~31。

【描述】

service命令用来创建一个呼叫限制规则,并进入该视图。undo service命令用来取消所创建的呼叫限制规则。

该规则视图下设置的是呼叫限制规则项,用户在该视图下通过rule tag { permit | deny } { incoming | outgoing } pattern命令设置相关的呼叫限制规则。

【举例】

# 创建呼叫限制规则集。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-rule-set

[Sysname-voice-server-set] service 1

[Sysname-voice-server-set-svc1]

2.1.15  server-bind ipv4

【命令】

server-bind ipv4 ipv4-address [ port port-number ] [ expires time-interval ]

undo server-bind ipv4

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

ipv4 ipv4-address:IPv4地址,该地址可以配置为本地路由器某一接口下的IP地址,也可以配置为127.0.0.1等本地环回地址。由于将服务器地址配置为127.0.0.1时服务器无法接受远端用户的注册,因此,建议实际组网应用时将服务器地址配置为本地路由器某一接口下的IP地址。

port port-number:端口号,取值范围为1-65535,缺省值为5060。

expires time-interval:允许客户端注册的最长间隔时间,单位为秒,取值范围为300~65535。缺省值为3600秒。

【描述】

server-bind ipv4命令用来将本地某一接口下配置的IP地址绑定为SIP本地服务器地址。undo server-bind ipv4命令用来取消SIP本地服务器地址的绑定。

缺省情况下,未绑定IP地址信息,即不存在服务器功能。

需要注意的是,对于IP地址绑定操作,必须在SIP本地服务器处于不可用状态下进行。

【举例】

# 绑定接口地址192.168.0.92为SIP本地服务器地址。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] server-bind ipv4 192.168.0.92

2.1.16  server enable

【命令】

server enable

undo server enable

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

【描述】

server enable命令用来使能SIP本地服务器功能。 undo server enable命令用来关闭SIP本地服务器功能。

缺省情况下,SIP本地服务器功能处于关闭状态。

需要注意的是,

·     只有在配置server enable命令后,SIP本地服务器功能才能生效。

·     在服务器运行于独立模式下必须首先配置server-bind ipv4命令才能配置server enable命令。

·     在服务器运行于本地存活模式下必须首先配置server-bind ipv4命令以及probe remote-server ipv4命令才能配置server enable命令。

【举例】

# 使能SIP本地服务器。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] server-bind ipv4 100.1.1.1

[Sysname-voice-server] server enable

2.1.17  sip-server

【命令】

sip-server

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

【描述】

sip-server命令用来进入sip-server视图。

【举例】

# 进入sip-server视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server]

2.1.18  trunk

【命令】

trunk tag called-number called-pattern ipv4 dest-ip-addr [ port port-number ] [ area-prefix prefix ]

undo trunk { tag | all }

【视图】

call-route视图

【缺省级别】

2:系统级

【参数】

tag:路由表项标签,取值范围为0~31,每个标签代表一条呼叫路由表项,最多支持32条呼叫路由表项。

called-pattern:被叫号码模式,只支持数字与点号“.”,每个点号代表一个字符,且点号只能出现在号码的后面几位,目前该字段不支持其他字符作为被叫号码模式。

ipv4 dest-ip-addr:目的IP地址,地址类型为IPv4。

area-prefix prefix:当内部用户呼叫外部用户时,使用此表项所示的路由时需要加的区域前缀,只能是数字,取值范围为1~15。

all:删除所有的规则项。

【描述】

trunk命令用来配置呼叫路由。undo trunk命令用来取消已有配置。

缺省情况下,没有配置任何呼叫路由表项。

【举例】

# 配置静态表项,目的地址为192.168.0.80,被叫号码为1000。在呼出时要求在主叫号码前添加区域前缀5000。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] call-route

[Sysname-voice-server-route] trunk 20 called-number 1000 ipv4 192.168.0.80 area-prefix 5000

2.1.19  trusted-point

【命令】

trusted-point ipv4 ipv4-address [ port port-number ]

undo trusted-point { ipv4 ipv4-address | all }

【视图】

sip-server视图

【缺省级别】

2:系统级

【参数】

ipv4 ipv4-address:可信节点的IPv4地址。

port port-number:可信节点的端口号,取值范围为1~65535,缺省值为5060。

all:所有可信节点信息。

【描述】

trusted-point命令用来配置可信节点。undo trusted-point命令用来删除指定IP地址的可信节点或所有可信节点。

缺省情况下,没有任何可信节点。

最多可配置8个可信节点。比较可信节点是否存在的依据仅仅是IP地址,与端口号无关。

【举例】

# 配置可信节点的IP地址为100.1.1.125。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-server

[Sysname-voice-server] trusted-point ipv4 100.1.1.125


3 SIP Trunk配置

3.1  SIP Trunk配置命令

3.1.1  address

【命令】

address index-number { ipv4 ip-address | dns dns-name } [ port port-number ] [ transport { udp | tcp | tls } ] [ url { sip | sips } ]

undo address index-number

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

index-number:地址索引,取值范围为1~5。

ipv4 ip-address:SIP服务器的IPv4地址。

dns dns-name:SIP服务器的域名,为1~255个字符的字符串,可以包含字母、数字、“-”、“_”或“.”,不区分大小写。

port port-number:SIP服务器使用的端口号,取值范围为1~65535。没有配置时根据传输协议类型选择端口,即选择的传输协议为UDP/TCP时,使用5060端口;选择的传输协议为TLS时,使用5061端口。

transport:SIP Trunk设备和SIP服务器之间进行连接时使用的传输层协议。

udp:使用UDP协议进行连接。缺省情况下,使用UDP作为传输协议。

tcp:使用TCP协议进行连接。

tls:使用TLS协议进行连接。

url:SIP Trunk设备和SIP服务器之间进行连接时使用的URL方案类型。

sip:使用SIP格式的URL方案类型。缺省情况下,URL方案类型为SIP。

sips:使用SIPS格式的URL方案类型。

【描述】

address命令用来添加SIP服务器组,并配置该SIP服务器信息。undo address命令用来删除已有配置。

缺省情况下,在SIP服务器组中不存在任何服务器信息。

地址索引代表服务器的优先级,索引值越小优先级越高。同一个SIP服务器组下可以配置最多5条服务器信息。若索引已存在,则新配置将直接覆盖原有配置。

相关配置可参考命令group-name

【举例】

# 在SIP服务器组1中添加SIP服务器1,该SIP服务器的IPv4地址为192.168.1.1,端口号为20000,SIP Trunk设备和SIP服务器之间采用TCP协议。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group1] address 1 ipv4 192.168.1.1 port 20000 transport tcp

3.1.2  address-hiding enable

【命令】

address-hiding enable

undo address-hiding enable

【视图】

SIP视图

【缺省级别】

2:系统级

【参数】

【描述】

address-hiding enable命令用来配置SIP到SIP呼叫的地址隐藏功能,即转发报文时隐藏原始报文携带的信令和媒体地址。undo address-hiding enable命令用来恢复缺省情况。

缺省情况下,SIP到SIP呼叫的地址隐藏功能处于关闭状态。

对于呼叫两端来说,设备是信令和媒体报文的唯一入口点。该功能常在设备作为会话边界网关时使用。

需要注意的是,如果在语音实体下配置了媒体旁路功能,信令报文中携带的媒体流地址不会被隐藏。相关配置可参考命令media flow-around

【举例】

# 在SIP视图下配置SIP到SIP呼叫的地址隐藏功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] address-hiding enable

3.1.3  address sip server-group

【命令】

address sip server-group group-number

undo address sip server-group

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

group-number:配置VoIP语音实体绑定的SIP服务器组索引,取值范围为1~10

【描述】

address sip server-group命令用来配置VoIP语音实体绑定的SIP服务器组。undo address sip server-group命令用来删除VoIP语音实体和SIP服务器组的绑定关系。

缺省情况下,在VoIP语音实体下没有绑定任何SIP服务器组。

VoIP语音实体下只能绑定一个已存在的SIP服务器组。

关于address sip命令的其他参数可参考命令address sip

【举例】

# 配置VoIP语音实体绑定的SIP服务器组索引为1。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] address sip server-group 1

3.1.4  assign

【命令】

assign { contact-user user-name | host-name host-name }

undo assign { contact-user | host-name }

【视图】

账户视图

【缺省级别】

2:系统级

【参数】

contact-user user-name:配置主机用户名,为1~31个字符的字符串,不可以包含‘”’和‘\’字符,区分大小写,不可以包含空格。

host-name host-name:配置主机名,为1~255个字符的字符串,可以包含字母、数字、“-”和“_”,不区分大小写,不可以包含空格。

【描述】

assign命令用来配置ITSP为SIP Trunk账户分配的主机用户名或主机名。undo assign命令用来删除主机用户名或主机名。

缺省情况下,没有指定主机用户名或主机名。

需要注意的是:

·     在SIP Trunk账户注册处于使能状态的情况下,不能修改或删除主机用户名。

·     没有配置主机用户名的情况下,无法使能SIP Trunk账户注册。

相关配置可参考命令register enable

【举例】

# 为账户2指定主机名为news.com.cn。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account-2] assign host-name news.com.cn

# 为账户2指定主机用户名为123。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account-2] assign contact-user 123

3.1.5  account enable

【命令】

account enable

undo account enable

【视图】

账户视图

【缺省级别】

2:系统级

【参数】

【描述】

account enable命令用来启用SIP Trunk账户。undo account enable命令用来停用SIP Trunk账户。

缺省情况下,SIP Trunk账户处于启用状态。

需要注意的是,禁用SIP Trunk账户时,如果该账户已经建立连接,则不会删除该账户对应的连接,即该配置只会对该账户的下次呼叫生效。

【举例】

# 停用SIP Trunk账户2。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account-2] undo account enable

3.1.6  bind sip-trunk account

【命令】

bind sip-trunk account account-index

undo bind sip-trunk account

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

account-index:配置VoIP语音实体绑定的SIP Trunk账户索引,取值范围为1~16。

【描述】

bind sip-trunk account命令用来配置VoIP语音实体绑定的SIP Trunk账户。undo bind sip-trunk account命令用来删除VoIP语音实体与SIP Trunk账户的绑定关系。

缺省情况下,VoIP语音实体没有绑定任何SIP Trunk账户。

需要注意的是:

·     VoIP语音实体下只能绑定已存在的SIP Trunk账户。

·     删除VoIP语音实体与SIP Trunk账户的绑定关系时,如果该账户已经建立连接,则不会删除该账户对应的连接,即该配置只会对该账户的下次呼叫生效。

【举例】

# 配置VoIP语音实体绑定的SIP Trunk账户索引为1。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] bind sip-trunk account 1

3.1.7  codec transcoding

【命令】

codec transcoding

undo codec transcoding

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

codec transcoding命令用来在语音实体下开启SIP Trunk设备的编解码转换功能。undo codec transcoding命令用来恢复缺省情况。

缺省情况下,语音实体下SIP Trunk设备的编解码转换功能处于关闭状态。

需要注意的是:

·     如果启用了编解码转换功能,但呼叫时没有空闲的编解码转换DSP资源可用,则呼叫无法建立。

·     如果在语音实体下配置了编解码透传功能,则最终呼叫将采用编解码透传方式建立,相关配置可参考命令codec transparent

·     如果在实体下配置了媒体流不经过设备进行转发功能,则最终呼叫将采用媒体流旁路功能,相关配置可参考命令media flow-around

【举例】

# 在SIP Trunk设备上开启编解码转换功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] codec transcoding

3.1.8  codec transparent

【命令】

codec transparent

undo codec transparent

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

codec transparent命令用来开启SIP Trunk设备的编解码透传功能。undo codec transparent命令用来恢复缺省情况。

缺省情况下,SIP Trunk设备的编解码透传功能处于关闭状态,SIP Trunk设备参与呼叫双方的媒体协商。

如果要在SIP Trunk设备上开启编解码透传功能,建议用户在内外网的VoIP语音实体上同时使能编解码透传命令。

【举例】

# 在SIP Trunk设备上开启编解码透传功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] codec transparent

3.1.9  description

【命令】

description text

undo description

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

text:SIP服务器组的描述信息,为1~80个字符的字符串,区分大小写。

【描述】

description命令用来配置SIP服务器组的描述信息。undo description命令用来删除SIP服务器组的描述信息。

缺省情况下,SIP服务器组没有描述信息。

【举例】

# 为服务器组1添加描述信息“ITSPA”。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group-1] description ITSPA

3.1.10  display voice sip-trunk account

【命令】

display voice sip-trunk account [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice sip-trunk account命令用来查看SIP Trunk账户状态。

【举例】

# 查看SIP Trunk账户状态。

<Sysname> display voice sip-trunk account

ID         User          Group        Server                 Exp                Status

1          1000          1            202.10.22.188:5060    120                Online

2          2000          1            abc.com:5060           400                Online

表3-1 display voice sip-trunk account命令显示信息描述表

字段

描述

ID

SIP Trunk账户索引

User

主机用户名

Group

SIP服务器组索引

Server

注册服务器地址或域名

Exp

SIP Trunk账户老化时间,单位为秒

Status

SIP Trunk账户的注册状态:

·     Disabled:SIP Trunk账户处于停用状态

·     Offline:SIP Trunk账户注册失败或已注销

·     Online:SIP Trunk账户注册成功

·     Login:SIP Trunk账户正在注册

·     Logout:SIP Trunk账户正在注销

·     Dnsin: SIP Trunk账户注册前进行DNS查询

·     Dnsout:SIP Trunk账户注销前进行DNS查询

 

3.1.11  display voice server-group

【命令】

display voice server-group [ group-number ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

group-number:SIP服务器组索引,取值范围为1~10。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display voice server-group命令用来查看指定或全部SIP服务器组的详细信息。

【举例】

# 查看服务器组1的详细信息。

<Sysname> display voice server-group 1

The information of server group 1

  Group name: ITSPA

  Description: ITSP A’s Proxy Server list

  Server list:

    Index 1: sip:192.169.0.1:5060;transport=udp

    Index 2: sips:abc.com:5061;transport=tls

  Current server index: 1

  Keepalive mode: Disabled

  Hot swap mode: Disabled

表3-2 display voice server-group命令显示信息描述表

字段

描述

Group name

SIP服务器组名

Description

SIP服务器组的描述信息

Server list

SIP服务器组列表

Index

SIP服务器组索引:SIP-URI/SIPS URI;传输层协议

Current server index

当前使用的SIP服务器组索引

Keepalive mode

SIP服务器组的保活模式:

·     Disabled:保活功能处于关闭状态

·     REGISTER:采用REGISTER保活模式

·     OPTIONS:采用OPTIONS保活模式

Hot swap mode

SIP服务器组的实时切换:

·     Disabled:实时切换功能处于关闭状态

·     Enabled:实时切换功能处于开启状态

 

3.1.12  early-offer forced

【命令】

early-offer forced

undo early-offer forced

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

early-offer forced命令用来开启SIP Trunk设备的DO-EO转换功能(delayed offer到early offer的INVITE消息的转换功能)。undo early-offer forced命令用来恢复缺省情况。

缺省情况下,SIP Trunk设备的DO-EO转换功能处于关闭状态。

需要注意的是,如果启用了SIP Trunk设备的编解码透传功能或媒体旁路功能,则该命令无效。

相关配置可参考命令codec transparentmedia flow-around

【举例】

# 在SIP Trunk设备上开启DO-EO转换功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] early-offer forced

3.1.13  group-name

【命令】

group-name group-name

undo group-name

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

group-name:SIP服务器组名称,为1~127个字符的字符串,可以包含字母、数字、“-”、“_”和“.”,区分大小写。

【描述】

group-name命令用来配置SIP服务器组的名称。undo group-name命令用来删除SIP服务器组的名称。

缺省情况下,没有配置SIP服务器组的名称。

SIP服务器组的名称用于标识SIP服务器组,通常使用运营商的服务器域名作为SIP服务器组的名称。如果没有配置SIP服务器组名称,则使用assign命令配置的host-name作为主机名。如果没有使用assign命令配置主机名,则使用SIP服务器组中当前服务器的IP地址或域名标识SIP服务器组。

相关配置可参考命令addressassign

【举例】

# 配置SIP服务器组1的名称为“ITSP-A”。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group-1] group-name ITSP-A

3.1.14  hot-swap enable

【命令】

hot-swap enable

undo hot-swap enable

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

【描述】

hot-swap enable命令用来使能SIP服务器组的实时切换功能。undo hot-swap enable命令用来关闭该SIP服务器组的实时切换功能。

缺省情况下,SIP服务器组的实时切换功能处于关闭状态。

【举例】

# 启用SIP服务器组1的实时切换功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group-1] hot-swap enable

3.1.15  keepalive

【命令】

keepalive { options [ interval seconds ] | register }

undo keepalive

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

options:配置使用OPTIONS保活模式。

interval seconds:发送OPTIONS保活报文的时间间隔,取值范围为5~65535,单位为秒。缺省值为60秒。

register:配置使用REGISTER保活模式。

【描述】

keepalive命令用来配置SIP服务器组的保活模式。undo keepalive命令用来关闭保活模式。

缺省情况下,不启用保活功能。

启用保活功能后,SIP Trunk设备会根据保活结果和配置的备份模式选择当前服务器。如果不启用保活功能,当前服务器一直为SIP服务器组中优先级最高的SIP服务器。

相关配置可参考命令redundancy mode

【举例】

# 配置SIP服务器组1的保活模式为register

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group-1] keepalive register

3.1.16  match source host-prefix

【命令】

match source host-prefix host-prefix

undo match source host-prefix

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

host-prefix:源主机名前缀,为1~31个字符的字符串,可以包含字母、数字、“-”、“_”、“.”或“*”,不区分大小写。其中“*”代表任意长度的字符串,例如t*m可以匹配tom、tim等源主机名。

【描述】

match source host-prefix命令用来指定匹配VoIP语音实体的源主机名前缀。undo match source host-prefix命令用来删除已配置的源主机名前缀。

缺省情况下,没有指定匹配该VoIP语音实体的源主机名前缀,即可以匹配所有源主机名。

·     在选择呼叫路由时,源主机名前缀用来和源主机名匹配。如果SIP Trunk设备接收到的INVITE消息中携带了Remote-Party-ID头域,则主叫信息需要从该头域中提取;如果INVITE消息中携带了Privacy头域,那么主叫信息需要从P-Asserted-Identity头域或者P-Preferred-Identity头域中提取;如果INVITE消息没有携带P-Asserted-Identity/P-Preferred-Identity和Remote-Party-ID头域,源主机名取自INVITE请求中From头域的主机名。

·     在VoIP语音实体下,只能配置一条源主机名前缀。如果多次执行该命令,新的配置会覆盖已有配置。

【举例】

# 指定匹配VoIP语音实体1的源主机名前缀为Bil。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] match source host-prefix bil

3.1.17  match destination host-prefix

【命令】

match destination host-prefix host-prefix

undo match destination host-prefix

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

host-prefix:目的主机名前缀,为1~31个字符的字符串,可以包含字母、数字、“-”、“_”、“.”或“*”,不区分大小写。其中“*”代表任意长度的字符串,例如b*y可以匹配boy、boundry等目的主机名。

【描述】

match destination host-prefix命令指定匹配VoIP语音实体的目的主机名前缀。undo match destination host-prefix命令用来删除已配置的目的主机名前缀。

缺省情况下,没有指定匹配该VoIP语音实体的目的主机名前缀,即可以匹配所有目的主机名。

·     在选择呼叫路由时,目的主机名前缀用来和目的主机名匹配。目的主机名取自SIP Trunk设备接收到的INVITE请求中To头域中的主机名。

·     在VoIP语音实体下,只能配置一条目的主机名前缀。如果多次执行该命令,新的配置会覆盖已有配置。

【举例】

# 指定匹配VoIP语音实体3的目的主机名前缀为ali。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 3 voip

[Sysname-voice-dial-entity3] match destination host-prefix ali

3.1.18  match source address

【命令】

match source address { ipv4 ip-address | dns dns-name | server-group group-number }

undo match source address

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

ipv4 ip-address:源IP地址,可以包含“.”、“x”、“*”和数字,必须使用点分形式。可以使用模糊匹配,x代表0~9之间任意一位数字,*代表0~255之间的任意一个数字,x和*均可多次出现。例如100.1.x.3可以匹配100.1.0.3~100.1.9.3之间的任意IP地址;192.*.*.*可以匹配192.0.0.1~192.255.255.255之间任意IP地址。

dns dns-name:域名,为1~255个字符的字符串,可以包含字母、数字、“-”、“_”、“.” 或“*”,不区分大小写。配置匹配源地址为域名时,为全字匹配,不能通过前缀匹配,例如配置为sohu,则不能匹配sohu.com。但可以使用模糊匹配,用“*” 代表任意长度的字符串,例如i*n可以匹配ilison、iverson、inn等。

server-group group-number:SIP服务器组索引,取值范围为1~10。

【描述】

match source address命令用来指定匹配VoIP语音实体的源地址。undo match source address命令用来删除已配置的源地址。

缺省情况下,没有指定匹配该VoIP语音实体的源地址,即可以匹配所有源地址。

·     在选择路由时,配置匹配VoIP语音实体的源地址。

·     在VoIP语音实体下,只能配置一条源地址。如果多次执行该命令,新的配置会覆盖已有配置。

【举例】

# 指定匹配语音实体3的源地址为100.1.1.*,即100.1.1.1~100.1.1.255均可匹配。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 3 voip

[Sysname-voice-dial-entity3] match source address ipv4 100.1.1.*

3.1.19  media flow-around

【命令】

media flow-around

undo media flow-around

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

media flow-around命令用来开启SIP Trunk设备的媒体旁路功能,使媒体流在呼叫的两个SIP端点间直接传输。undo media flow-around命令用来恢复缺省情况。

缺省情况下,SIP Trunk设备作为RTP中继代理,媒体流经过SIP Trunk设备进行中继转发。

需要注意的是,当不需要设备进行编解码转换也不需要设备对呼叫端点隐藏彼此网络地址时,从提升性能的角度考虑,设备并不需要干预呼叫端点两侧的媒体流传输,也就不需要对媒体流进行中继转发。

【举例】

# 在SIP Trunk设备上开启媒体旁路功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] media flow-around

3.1.20  midcall-signal passthrough

【命令】

midcall-signal passthrough

undo midcall-signal passthrough

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

midcall-signal passthrough命令用来配置SIP到SIP呼叫的会话更新信令消息的透传功能。undo midcall-signal passthrough用来恢复缺省情况。

缺省情况下,SIP到SIP呼叫的会话更新信令消息的透传功能处于关闭状态,设备将直接处理会话更新信令消息而不会透传到另一侧。

【举例】

# 配置SIP到SIP呼叫的会话更新信令消息的透传功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] midcall-signal passthrough

3.1.21  proxy server-group

【命令】

proxy server-group group-number

undo proxy server-group

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

group-number:SIP服务器组索引,取值范围为1~10。

【描述】

proxy server-group命令用来配置SIP代理服务器使用的SIP服务器组。undo proxy server-group命令用来删除指定的SIP服务器组。

缺省情况下,没有配置使用代理服务器。

【举例】

# 配置SIP代理服务器使用的SIP服务器组5。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] proxy server-group 5

3.1.22  registrar server-group

【命令】

registrar server-group group-number [ expires seconds ]

undo registrar server-group

【视图】

账户视图

【缺省级别】

2:系统级

【参数】

group-number:SIP Trunk账户使用的注册服务器组的索引,取值范围为1~10。

expires seconds:SIP Trunk账户的注册老化时长,取值范围为60~3600,单位为秒。如果没有配置该值,则使用SIP客户端视图下timer registration expires配置的全局注册老化时长。

【描述】

registrar server-group命令用来指定该SIP Trunk账户使用的注册服务器组。undo registrar server-group命令用来删除指定注册服务器组的索引。

缺省情况下,没有指定SIP Trunk账户使用的注册服务器组的索引。

需要注意的是:

·     指定的SIP服务器组必须存在,且一个SIP Trunk账户只能使用一个目的SIP注册服务器组。

·     如果SIP Trunk账户没有绑定SIP服务器组索引,SIP Trunk账户注册将无法使能。

相关配置可参考命令timer registration expiresregister enable

【举例】

# 指定账户1使用的注册服务器组为SIP服务器组2,设置该账户的注册老化时长为300秒。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 1

[Sysname-voice-account-1] registrar server-group 2 expires 300

3.1.23  register enable

【命令】

register enable

undo register enable

【视图】

账户视图

【缺省级别】

2:系统级

【参数】

【描述】

register enable命令用来使能SIP Trunk账户注册功能。undo register enable命令用来取消SIP Trunk账户注册功能。

缺省情况下,SIP Trunk账户注册功能处于关闭状态。

需要注意的是:

·     在没有指定主机用户名、或没有绑定SIP服务器组的情况下,无法使用register enable命令使能注册。

·     在SIP Trunk账户注册使能的情况下,不能修改该账户下已配置的主机用户名、目的注册SIP服务器组信息。

相关配置可参考命令assignregistrar server-group

【举例】

# SIP Trunk账户2已经完成主机用户名、指定SIP服务器组等配置后,使能该账户的注册功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account-2] assign contact-user 123

[Sysname-voice-account-2] registrar server-group 2 expires 300

[Sysname-voice-account-2] register enable

3.1.24  redundancy mode

【命令】

redundancy mode { homing | parking }

undo redundancy mode

【视图】

SIP客户端视图

【缺省级别】

2:系统级

【参数】

homing:选用homing备份模式。

parking:选用parking备份模式。

【描述】

redundancy mode命令配置SIP服务器组的备份模式。undo redundancy mode命令用来恢复缺省情况。

缺省情况下,SIP服务器组采用parking备份模式。

相关配置可参考命令keepalive

【举例】

# 配置SIP服务器组的注册备份模式为homing模式。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip

[Sysname-voice-sip] redundancy mode homing

3.1.25  server-group

【命令】

server-group group-number

undo server-group { group-number | all }

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

group-number:SIP服务器组索引,取值范围为1~10。

all:删除所有的SIP服务器组。

【描述】

server-group命令创建一个SIP服务器组,并进入服务器组视图。如果该服务器组已存在,则直接进入服务器组视图。undo server-group命令删除一个或全部SIP服务器组。

需要注意的是:

·     不能删除被绑定的SIP服务器组;

·     只有当所有SIP服务器组都没有被绑定时,undo server-group all命令才能执行成功。

【举例】

# 创建SIP服务器组1,并进入SIP服务器组1视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice-group-1]

3.1.26  sip-trunk account

【命令】

sip-trunk account account-index

undo sip-trunk account { account-index | all }

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

account account-index:SIP Trunk账户索引,取值范围为1~16。

all:删除所有的SIP Trunk账户。

【描述】

sip-trunk account命令用来创建一个账户,并进入账户视图。如果该账户已存在,则直接进入账户视图。undo sip-trunk account命令用来删除一个或全部账户。

需要注意的是:

·     不能删除被绑定的SIP Trunk账户。

·     只有当所有SIP Trunk账户都没有被绑定时,undo sip-trunk account all命令才能执行成功。

相关配置可参考命令bind sip-trunk account

【举例】

# 创建账户2,并进入账户2视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account-2]

3.1.27  sip-trunk enable

【命令】

sip-trunk enable

undo sip-trunk enable

【视图】

语音视图

【缺省级别】

2:系统级

【参数】

【描述】

sip-trunk enable命令用来使能SIP Trunk功能。undo sip-trunk enable命令用来取消SIP Trunk功能。

缺省情况下,SIP Trunk功能处于关闭状态。

需要注意的是,开启SIP Trunk功能后,不推荐将设备作为SIP UA使用。

【举例】

# 使能SIP Trunk功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk enable

3.1.28  source-bind

【命令】

source-bind { media | signal } { interface-type interface-number | ipv4 ip-address }

undo source-bind { media | signal }

【视图】

服务器组视图

【缺省级别】

2:系统级

【参数】

media:媒体流。

signal:信令流。

interface-type interface-number:指定接口类型和编号类型,目前只支持三层以太网接口、三层千兆以太网接口和拨号接口。

ipv4 ip-address:绑定的IPv4地址。

【描述】

source-bind命令用来配置SIP服务器组支持源地址或接口绑定。undo source-bind命令用来删除已有的绑定配置。

缺省情况下,SIP服务器组没有配置源地址绑定。

【举例】

# 配置SIP到SIP呼叫的源地址绑定为接口模式。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] server-group 1

[Sysname-voice- server-group-1] source-bind signal GigabitEthernet 1/0

3.1.29  supplementary-service sip call-forwarding

【命令】

supplementary−service sip call-forwarding

undo supplementary−service sip call-forwarding

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

supplementary−service sip call-forwarding命令用来配置SIP到SIP呼叫的呼叫前转功能。undo supplementary−service sip call-forwarding命令用来恢复缺省情况。

缺省情况下,SIP到SIP呼叫的呼叫前转功能处于关闭状态。

开启SIP到SIP呼叫的呼叫前转功能后,设备可以在主叫方并不感知的情况下处理前转消息,代替主叫方完成呼叫前转操作。

关闭SIP到SIP呼叫的呼叫前转功能后,设备通过透传由被叫方发送的前转消息到主叫方,告知其呼叫目的端的信息,从而使主叫方重新向新的被叫方发送会话请求。

【举例】

# 在语音实体视图下配置SIP到SIP呼叫的呼叫前转功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] supplementary−service sip call-forwarding

3.1.30  supplementary-service sip call-transfer

【命令】

supplementary−service sip call-transfer

undo supplementary−service sip call-transfer

【视图】

VoIP语音实体视图

【缺省级别】

2:系统级

【参数】

【描述】

supplementary−service sip call-transfer令用来配置SIP到SIP呼叫的呼叫转接功能。undo supplementary−service sip call-transfer命令用来恢复缺省情况。

缺省情况下,SIP到SIP呼叫的对呼叫转接功能处于关闭状态。

开启SIP到SIP呼叫的呼叫转接功能后,设备不会自己处理收到的呼叫业务相关消息,而是在主叫方并不感知的情况下直接透传给另一侧,代替主叫方完成呼叫转接操作。

【举例】

# 在语音实体视图下配置SIP到SIP呼叫的呼叫转接功能。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] dial-program

[Sysname-voice-dial] entity 1 voip

[Sysname-voice-dial-entity1] supplementary−service sip call-refer

3.1.31  user

【命令】

user username password { cipher | simple } password

undo user

【视图】

账户视图

【缺省级别】

2:系统级

【参数】

username:SIP Trunk账户注册鉴权时使用的用户名,为1~63个字符的字符串,区分大小写,‘”’和‘\’为无效字符。

cipher:以密文方式设置账户的密码。

simple:以明文方式设置账户的密码。

password:设置鉴权使用的明文密码或密文密码,区分大小写。明文密码的长度范围是1~16;密文密码的长度范围是1~53。

【描述】

user命令用来配置SIP Trunk账户的认证用户名和密码信息。undo user命令用来删除SIP Trunk账户的认证用户名和密码信息。

缺省情况下,没有SIP Trunk账户的认证用户名和密码信息。

以明文或密文方式设置的密码,均以密文的方式保存在配置文件中。

【举例】

# 配置账户2的认证用户名和密码。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] sip-trunk account 2

[Sysname-voice-account2] user telA password simple 12345

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!