目  錄

1 NETCONF

1.1 NETCONF配置命令

1.1.1 netconf idle-timeout

1.1.2 netconf log

1.1.3 netconf soap domain

1.1.4 netconf soap http acl

1.1.5 netconf soap http enable

1.1.6 netconf soap https acl

1.1.7 netconf soap https enable

1.1.8 netconf ssh server enable

1.1.9 netconf ssh server port

1.1.10 xml

 

1 NETCONF

1.1  NETCONF配置命令

1.1.1  netconf idle-timeout

netconf idle-timeout命令用來配置NETCONF會話超時時間。

undo netconf idle-timeout命令用來恢複缺省情況。

【命令】

netconf { soap | agent } idle-timeout minute

undo netconf { soap | agent } idle-timeout

【缺省情況】

基於NETCONF over SOAP over HTTP/HTTPS的會話超時時間為10分鍾。

基於NETCONF over SSH/Telnet/Console的會話超時時間為0，即不超時。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

soap：用來配置基於NETCONF over SOAP over HTTP/HTTPS的會話超時時間。

agent：用來配置基於NETCONF over SSH/Telnet/Console的會話超時時間。

minute：表示超時時間，單位為分鍾，取值範圍為：

·     對於基於NETCONF over SOAP over HTTP/HTTPS的會話，取值範圍為1～999。

·     對於基於NETCONF over SSH/Telnet/Console的會話，取值範圍為0～999，0表示不超時。

【使用指導】

用戶通過Telnet、SSH、Console、或配置工具與設備建立NETCONF連接，如果在超時時間內，用戶與設備無任何NETCONF報文交互，達到超時時間後，設備將斷開與用戶配置端的NETCONF連接。

【舉例】

# 配置基於NETCONF over SOAP over HTTP/HTTPS的會話超時時間為20分鍾。

<Sysname> system-view

[Sysname] netconf soap idle-timeout 20

1.1.2  netconf log

netconf log命令用來配置NETCONF日誌功能。

undo netconf log命令用來取消指定類型的NETCONF日誌配置。

【命令】

netconf log source { all | { agent | soap | web } * } { { protocol-operation { all | { action | config | get | set | session | syntax | others } * } } | verbose }

undo netconf log source { all | { agent | soap | web } * } { { protocol-operation { all | { action | config | get | set | session | syntax | others } * } } | verbose }

【缺省情況】

未配置NETCONF日誌功能。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

source：表示需要輸出日誌的NETCONF操作來源：

·     agent：表示輸出源自Telnet/SSH/NETCONF over SSH/Console類型的NETCONF日誌。

·     all：表示輸出所有來源的NETCONF日誌。

·     soap：表示輸出源自SOAP over HTTP和SOAP over HTTPS類型的NETCONF日誌。

·     web：表示輸出源自本設備Web類型的NETCONF日誌。

protocol-operation：表示需要輸出日誌的NETCONF操作：

·     action：表示action操作。

·     all：表示所有NETCONF操作。

·     config：表示配置類的NETCONF操作，包括CLI、save、load、rollback、save-point、lock、unlock。

·     get：表示獲取數據的NETCONF操作，包括get、get-bulk、get-config、get-bulk-config、get-sessions。

·     others：表示除action、config、get、set、session、set、syntax外，其他類型的NETCONF操作。

·     session：表示與會話相關的NETCONF操作，包括kill-session、close-session、hello。

·     set：表示所有edit-config操作。

·     syntax：表示包含xml和schema的格式錯誤的請求。

verbose：表示輸出NETCONF日誌的詳細信息。

【使用指導】

NETCONF日誌命令可以按照NETCONF操作來源（source）和NETCONF操作類型（protocol-operation）配置設備輸出不同類型的NETCONF操作日誌。係統先將NETCONF日誌發送到信息中心，根據信息中心的輸出規則將日誌信息輸出到不同方向。信息中心的相關配置請參見“網絡管理和監控配置指導”中的“信息中心”。

配置verbose參數後，設備輸出NETCONF日誌的詳細信息：

·     對於請求類型的日誌：當請求報文格式正確時，設備在簡要日誌後輸出源報文的內容。

·     對於處理結果類型的日誌：僅支持輸出set的詳細日誌信息。即，當edit-config操作的單個行執行錯誤時輸出詳細錯誤信息。

【舉例】

# 配置設備輸出源自agent的edit-config類型的操作日誌。

<Sysname> system-view

[sysname] netconf log source agent protocol-operation set

1.1.3  netconf soap domain

netconf soap domain命令用來配置NETCONF用戶的強製認證域。

undo netconf soap domain命令用來恢複缺省情況。

【命令】

netconf soap domain domain-name

undo netconf soap domain domain-name

【缺省情況】

未配置NETCONF用戶的強製認證域。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

domain-name：ISP域名，為1～255個字符的字符串，不區分大小寫。關於ISP域的詳細介紹請參見“安全配置指導”中的“AAA”。

【使用指導】

多次執行本命令，最後一次執行的命令生效。

NETCONF支持使用如下方式指定認證域：

·     通過netconf soap domain命令配置強製認證域。配置該命令後，所有用戶都會使用強製認證域進行認證。

·     在SOAP請求的<UserName>中攜帶認證域信息。SOAP請求中攜帶的認證域僅對當前請求生效。通過netconf soap domain命令配置強製認證域後，SOAP請求中攜帶的認證域不生效。

【舉例】

# 配置NETCONF用戶的強製認證域為my-domain。

<Sysname> system-view

[Sysname] netconf soap domain my-domain

1.1.4  netconf soap http acl

netconf soap http acl命令用來配置基於HTTP的NETCONF over SOAP功能關聯的ACL。

undo netconf soap http acl命令用來恢複缺省情況。

【命令】

netconf soap http acl { acl-number | name acl-name }

undo netconf soap http acl

【缺省情況】

未配置基於HTTP的NETCONF over SOAP功能關聯的ACL。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

acl-number：ACL的編號，取值範圍為2000～2999。

name acl-name：指定ACL的名稱。acl-name表示ACL的名稱，為1～63個字符的字符串，不區分大小寫，必須以英文字母a～z或A～Z開頭。為避免混淆，ACL的名稱不允許使用英文單詞all。僅當指定名稱的ACL存在且為基本IPv4 ACL時生效。

【使用指導】

配置SOAP服務與ACL關聯後，隻有ACL允許通過的NETCONF客戶端能夠通過SOAP方式登錄設備。不匹配ACL或ACL拒絕通過的NETCONF客戶端將不能通過SOAP方式登錄設備。

多次執行本命令，最後一次執行的命令生效。

【舉例】

# 配置基於HTTP的NETCONF over SOAP功能與ACL 2001關聯，隻允許10.10.0.0/16網段的客戶端訪問設備。

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule permit source 10.10.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] netconf soap http acl 2001

1.1.5  netconf soap http enable

netconf soap http enable命令用來開啟基於HTTP的SOAP功能。

undo netconf soap http enable命令用來關閉基於HTTP的SOAP功能。

【命令】

netconf soap http enable

undo netconf soap http enable

【缺省情況】

基於HTTP的SOAP功能處於關閉狀態。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【使用指導】

配置該命令後，表示設備能夠解析這樣的HTTP報文，報文中的數據為SOAP封裝過的NETCONF指令。

【舉例】

# 開啟基於HTTP的SOAP功能。

<Sysname> system-view

[Sysname] netconf soap http enable

1.1.6  netconf soap https acl

netconf soap https acl命令用來配置基於HTTPS的NETCONF over SOAP功能關聯的ACL。

undo netconf soap https acl命令用來恢複缺省情況。

【命令】

netconf soap https acl { acl-number | name acl-name }

undo netconf soap https acl

【缺省情況】

未配置基於HTTPS的NETCONF over SOAP功能關聯的ACL。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

acl-number：ACL的編號，取值範圍為2000～2999。

name acl-name：指定ACL的名稱。acl-name表示ACL的名稱，為1～63個字符的字符串，不區分大小寫，必須以英文字母a～z或A～Z開頭。為避免混淆，ACL的名稱不允許使用英文單詞all。僅當指定名稱的ACL存在且為基本IPv4 ACL時生效。

【使用指導】

配置SOAP服務與ACL關聯後，隻有ACL允許通過的NETCONF 客戶端能夠通過SOAP方式登錄設備。不匹配ACL或ACL拒絕通過的NETCONF客戶端將不能通過SOAP方式登錄設備。

多次執行本命令，最後一次執行的命令生效。

【舉例】

# 配置基於HTTPS的NETCONF over SOAP功能與ACL 2001關聯，隻允許10.10.0.0/16網段的客戶端訪問設備。

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule permit source 10.10.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] netconf soap https acl 2001

1.1.7  netconf soap https enable

netconf soap https enable命令用來開啟基於HTTPS的SOAP功能。

undo netconf soap https enable命令用來關閉基於HTTPS的SOAP功能。

【命令】

netconf soap https enable

undo netconf soap https enable

【缺省情況】

基於HTTPS的SOAP功能處於關閉狀態。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【使用指導】

配置該命令後，表示設備能夠解析這樣的HTTPS報文，報文中的數據為SOAP封裝過的NETCONF指令。

【舉例】

# 開啟基於HTTPS的SOAP功能。

<Sysname> system-view

[Sysname] netconf soap https enable

1.1.8  netconf ssh server enable

netconf ssh server enable命令用來開啟NETCONF Over SSH的接入方式。

undo netconf ssh server enable命令用來關閉NETCONF Over SSH的接入方式。

【命令】

netconf ssh server enable

undo netconf ssh server enable

【缺省情況】

NETCONF Over SSH的接入方式處於關閉狀態。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【使用指導】

用戶配置該命令後，可以利用SSH客戶端通過SSH子係統的方式接入設備的NETCONF係統，然後直接進入NETCONF配置模式，而不用手工輸入XML命令。

配置該命令前必須在設備上把SSH連接終端的認證方式設置為scheme，支持NETCONF over SSH的客戶端才能連接到NETCONF係統，目前隻支持用urn:ietf:params:netconf:base:1.0（設備與終端共同支持的能力集）連接係統。

【舉例】

# 開啟NETCONF Over SSH的接入方式。

<Sysname> system-view

[Sysname] netconf ssh server enable

1.1.9  netconf ssh server port

netconf ssh server port命令用來設置NETCONF Over SSH接入方式的監聽端口號。

undo netconf ssh server port命令用來恢複缺省情況。

【命令】

netconf ssh server port port-number

undo netconf ssh server port

【缺省情況】

NETCONF Over SSH接入方式的監聽端口為830。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

context-admin

【參數】

port-number：基於NETCONF Over SSH的接入方式的監聽端口，取值範圍為1～65535，缺省值為830。

【使用指導】

用戶可以在必要時使用此命令來重新配置一個端口作為NETCONF子係統的監聽端口，但由於SSH服務使用共享端口的方式來分配監聽端口，為了正常使用，必須保證分配的端口不和其他使用的端口衝突。

【舉例】

# 配置NETCONF Over SSH接入方式的監聽端口為800。

<sysname> system-view

[sysname] netconf ssh server port 800

1.1.10  xml

xml命令用來進入XML視圖。

【命令】

xml

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

network-operator

context-admin

context-operator

【使用指導】

進入XML視圖後可以輸入NETCONF指令來配置或者獲取係統數據。用戶登錄時使用的角色不同，可執行的NETCONF操作也不同：

·     network-admin和context-admin可執行全部操作。

·     network-operator和context-operator可執行get、get-bulk、get-config、get-bulk-config、get-sessions、close-session操作。

進入XML視圖後，用戶需要嚴格按照NETCONF報文格式將報文拷貝、粘貼到XML視圖中。在NETCONF配置過程中，請勿進行其他任何操作（例如手工輸入NETCONF報文），否則可能導致NETCONF配置失敗。

在XML視圖下進行NETCONF配置時，XML報文最後需要添加“]]>]]>”，否則設備無法識別。

進入XML視圖後，設備將自動向客戶端發送自身支持的NETCONF能力集，此時，客戶端需要向設備發送自身支持的NETCONF能力集，完成能力交換後，用戶即可使用客戶端對設備進行配置。

用戶輸入的NETCONF指令必須符合XML語言格式要求和《NETCONF XML API手冊》中的語法、語義要求。建議使用第三方軟件來協助生成NETCONF指令，命令行手工輸入方式通常用於研發和測試環境。

退出XML視圖時需要使用相關的NETCONF指令，不能使用quit。

在XML模式下終止當前任務的快捷鍵有重置緩存的功能，快捷鍵之前的內容都會被清除掉。如果在用戶線/用戶線類視圖下使用escape-key命令配置了終止當前任務的快捷鍵（缺省為Ctrl+C），可能會影響XML視圖下相關配置。例如：在用戶線視圖下配置了escape-key a，當NETCONF指令中含有字符‘a’時，其實隻有NETCONF指令最後一個‘a’之後的內容能夠得到處理；當NETCONF指令中不含有字符‘a’時，則對XML視圖下的配置沒有影響。

【舉例】

# 進入XML視圖。

<Sysname> xml

<?xml version="1.0" encoding="UTF-8"?><hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"><capabilities><capability>urn:ietf:params:netconf:base:1.1</capability><capability>urn:ietf:params:netconf:writable-running</capability><capability>urn:ietf:params:netconf:capability:notification:1.0</capability><capability>urn:ietf:params:netconf:capability:validate:1.1</capability><capability>urn:ietf:params:netconf:capability:interleave:1.0</capability><capability>urn:h3c:params:netconf:capability:h3c-netconf-ext:1.0</capability></capabilities><session-id>1</session-id></hello>]]>]]>

# 進行能力交換。

<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

  <capabilities>

    <capability>

            urn:ietf:params:netconf:base:1.0

    </capability>

  </capabilities>

</hello>]]>]]>

# 退出XML視圖。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

  <close-session>

  </close-session>

</rpc>]]>]]>

<Sysname>