- 產品與解決方案
- 行業解決方案
- 服務
- 支持
- 合作夥伴
- 關於我們
04-SIP命令
本章節下載： 04-SIP命令 (514.23 KB)
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.11 display voice sip register-state
1.1.28 reset voice sip connection
1.1.29 reset voice sip dns-record
1.1.30 reset voice sip statistics
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.50 wildcard-register enable
2.1.6 display voice sip-server register-user
2.1.7 display voice sip-server resource-statistic
3.1.3 address sip server-group
3.1.10 display voice sip-trunk account
3.1.11 display voice server-group
3.1.16 match source host-prefix
3.1.17 match destination host-prefix
3.1.20 midcall-signal passthrough
3.1.29 supplementary-service sip call-forwarding
MSR800、MSR 900、MSR900-E、MSR 930、MSR 2600、MSR 30-11、MSR 30-11E、MSR 30-11F和MSR3600-51F路由器不支持語音功能。
【命令】
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
【命令】
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
【命令】
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
【命令】
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中事務超時的統計信息 |
【命令】
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表示連接已經建立 |
【命令】
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號碼變換規則組中的變換規則 |
【命令】
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地址信息 |
【命令】
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釋放原因值 |
【命令】
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： 呼叫轉接業務 |
【命令】
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 sip、proxy，以及“語音命令參考/語音業務”中的命令mwi-server。
【舉例】
# 配置使用SRV方式進行DNS查詢。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] dns-type srv
【命令】
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注冊的狀態信息。
【舉例】
<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查詢狀態 |
【命令】
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
【命令】
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]
【命令】
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
【命令】
line-check enable
undo line-check
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
line-check enable命令用來配置檢查POTS語音實體下語音用戶線的狀態。undo line-check命令用來取消檢查。
缺省情況下，在注冊POTS語音實體下的號碼時，需要檢查與POTS語音實體綁定的語音用戶線狀態，隻有配置語音用戶線並且該語音用戶線處於Up狀態時，設備才能為號碼發起注冊請求。
相關配置可參考“語音命令參考/語音用戶線”中的命令line、shutdown（Voice subscriber-line view）。
【舉例】
# 取消檢查POTS語音實體下語音用戶線的狀態。也就是說，隻要配置了語音用戶線，即使語音用戶線處於shutdown狀態，設備也可以為號碼發起注冊請求。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] undo line-check
【命令】
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命令會刪除當前已經建立的連接。
相關配置可參考命令transport和registrar。
【舉例】
# 配置接收SIP呼叫時使用的傳輸協議為TLS。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] listen transport tls
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
reset voice sip dns-record
【視圖】
用戶視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
reset voice sip dns-record命令用來清除SIP的DNS查詢記錄。
【舉例】
# 清除SIP的DNS查詢記錄。
<Sysname> reset voice sip dns-record
【命令】
reset voice sip statistics
【視圖】
用戶視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
reset voice sip statistics命令用來清除SIP客戶端所有的統計信息。
【舉例】
# 清除SIP客戶端所有的統計信息。
<Sysname> reset voice sip statistics
【命令】
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
【命令】
sip
【視圖】
語音視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
sip命令用來進入SIP客戶端視圖。
【舉例】
# 進入SIP客戶端視圖。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip]
【命令】
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
【命令】
sip-comp agent product-name product-version
undo sip-comp agent
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
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。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] sip-comp agent company 1.0
【命令】
sip-comp server product-name product-version
undo sip-comp server
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
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。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] sip-comp server company 1.1
【命令】
sip-domain domain-name
undo sip-domain
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
domain-name：SIP設備的域名，取值範圍為：0～９，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
【命令】
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
【命令】
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
【命令】
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
【命令】
timer registration expires seconds
undo timer registration expires
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
seconds：注冊老化時長，取值範圍為60～3600，單位為秒。
【描述】
timer registration expires命令用來配置注冊老化時長。undo timer registration expires命令用來恢複缺省情況。
缺省情況下，注冊老化時長為3600秒。
相關配置可參考命令registrar server-group、registrar、timer registration threshold和timer registration divider。
【舉例】
# 配置注冊老化時長為600秒。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] timer registration expires 600
【命令】
timer registration divider percentage
undo timer registration divider
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
percentage：注冊老化時長的百分比，取值範圍為50～100。
【描述】
timer registration divider命令用來配置注冊老化時長的百分比。undo timer registration divider命令用來恢複缺省情況。
缺省情況下，注冊老化時長的百分比為80。
相關配置可參考命令timer registration expires和timer registration threshold。
【舉例】
# 配置注冊老化時長的百分比為50%。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] timer registration divider 50
【命令】
timer registration threshold seconds
undo timer registration threshold
【視圖】
SIP客戶端視圖
【缺省級別】
2：係統級
【參數】
seconds：注冊老化時長的提前量，取值範圍為0～3600，單位為秒。
【描述】
timer registration threshold命令用來配置注冊老化時長的提前量。undo timer registration-threshold命令用來恢複缺省情況。
缺省情況下，注冊老化時長的提前量為0秒。
相關配置可參考命令timer registration expires和timer registration divider。
【舉例】
# 配置注冊老化時長的提前量為100秒。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip
[Sysname-voice-sip] timer registration threshold 100
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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協議的語音服務綁定的VPN為vpn-voice。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] vpn-instance vpn-voice
【命令】
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
【命令】
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
【命令】
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
【命令】
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]
【命令】
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]
【命令】
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
【命令】
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地址及端口號 |
【命令】
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訂閱模塊 |
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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]
【命令】
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....
【命令】
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]
【命令】
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
【命令】
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
【命令】
sip-server
【視圖】
語音視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
sip-server命令用來進入sip-server視圖。
【舉例】
# 進入sip-server視圖。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] sip-server
[Sysname-voice-server]
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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查詢 |
【命令】
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：實時切換功能處於開啟狀態 |
【命令】
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 transparent和media 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
【命令】
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服務器組。
相關配置可參考命令address和assign。
【舉例】
# 配置SIP服務器組1的名稱為“ITSP-A”。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] server-group 1
[Sysname-voice-group-1] group-name ITSP-A
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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.*
【命令】
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
【命令】
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
【命令】
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
【命令】
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 expires和register 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
【命令】
register enable
undo register enable
【視圖】
賬戶視圖
【缺省級別】
2：係統級
【參數】
無
【描述】
register enable命令用來使能SIP Trunk賬戶注冊功能。undo register enable命令用來取消SIP Trunk賬戶注冊功能。
缺省情況下，SIP Trunk賬戶注冊功能處於關閉狀態。
需要注意的是：
· 在沒有指定主機用戶名、或沒有綁定SIP服務器組的情況下，無法使用register enable命令使能注冊。
· 在SIP Trunk賬戶注冊使能的情況下，不能修改該賬戶下已配置的主機用戶名、目的注冊SIP服務器組信息。
相關配置可參考命令assign和registrar 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
【命令】
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
【命令】
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]
【命令】
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]
【命令】
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
【命令】
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
【命令】
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
【命令】
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
【命令】
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保留在沒有任何通知或提示的情況下對資料內容進行修改的權利!
支持
