Tracert
本章节介绍tracert命令的配置模型，以及配置的XML报文示例。
数据模型
tracert命令的配置模型文件名为huawei-traceroute.yang。
节点 |
说明 |
取值范围 |
备注 |
|---|---|---|---|
| /huawei-traceroute:tracert/test-name | tracert命令实例名称。 |
字符串形式，区分大小写，长度范围是1～32。 |
唯一标识一条tracert命令，由于tracert命令是异步执行，该节点供控制器关联tracert命令和Notification消息。 |
| /huawei-traceroute:tracert/ipv4-tracert/destination | 目的主机的域名或IPv4地址。 |
|
NA |
| /huawei-traceroute:tracert/ipv4-tracert/source-ip-address | ICMP请求报文的源IPv4地址。 |
点分十进制格式，必须是交换机上存在的IPv4地址。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/first-ttl | ICMP请求报文的初始TTL。 |
整数形式，取值范围是1～255，缺省值是1。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/max-ttl | ICMP请求报文的最大TTL。 |
整数形式，取值范围是1～255，缺省值是30。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/probe-count | 每次发送的ICMP请求报文个数。 |
整数形式，取值范围是1～5，缺省值是3。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/timeout | 等待ICMP响应报文的超时时间。 |
整数形式，取值范围是0～10000，单位是毫秒，缺省值是2000。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/vpn-instance-name | 目的主机所属的VPN实例名称。 |
字符串形式，长度范围是1～31，必须是已存在的VPN实例名称。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/udp-port | 目的主机的UDP端口号。 |
整数形式，取值范围是0～65535，缺省值是33434。 |
NA |
| /huawei-traceroute:tracert/ipv4-tracert/packet-size | ICMP请求报文长度，不包括IPv4和ICMP报文头。 |
整数形式，取值范围是12～9600，单位是字节，缺省值是12字节。 |
NA |
| /huawei-traceroute:tracert/ipv6-tracert/destination | 目的主机的域名或IPv6地址。 |
|
NA |
| /huawei-traceroute:tracert/ipv6-tracert/udp-port | 目的主机的UDP端口号。 | 整数形式，取值范围是1～65535，缺省值是33434。 | NA |
| /huawei-traceroute:tracert/ipv6-tracert/packet-size | ICMPv6请求报文长度，不包括IPv6和ICMPv6报文头。 | 整数形式，取值范围是20～9600，单位是字节，缺省值是20。 | NA |
由于tracert命令的执行需要时间，交换机在收到控制器要求交换机执行tracert命令的RPC请求之后先返回RPC响应。当tracert命令执行完成，获取到回显信息后，再通过Notification消息通告控制器tracert命令的执行结果。
项目 |
说明 |
|---|---|
test-name |
tracert命令实例名称，与/huawei-traceroute:tracert/test-name节点对应。 |
destination |
目的主机的域名、IPv4地址或IPv6地址。 |
max-hops |
ICMP请求报文最大跳数。 |
| packet-size | ICMP请求报文的长度。 |
| hop-index | 下一跳的序号。 |
| hop-address | 下一跳的IPv4地址或IPv6地址。 |
| probe-index | ICMP请求报文的索引。 |
| result | 探测结果。 |
| delta-time | 探测时长，单位是毫秒。 |
| complete | 该Notification消息是否是最后一条：
|
执行tracert命令示例
本章节主要介绍通过rpc方法执行tracert命令。
操作 |
XPATH |
|---|---|
rpc |
|
数据需求
项目 |
数据 |
描述 |
|---|---|---|
tracert命令实例名称 |
aabb |
tracert命令实例名称为aabb。 |
目的主机 |
192.168.20.1 |
目的主机IPv4地址为192.168.20.1。 |
请求示例
<?xml version="1.0" encoding="UTF-8"?>
<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<hw-tracert:tracert xmlns:hw-tracert="urn:huawei:params:xml:ns:yang:huawei-traceroute">
<hw-tracert:test-name>aabb</hw-tracert:test-name>
<hw-tracert:ipv4-tracert>
<hw-tracert:destination>192.168.20.1</hw-tracert:destination>
</hw-tracert:ipv4-tracert>
</hw-tracert:tracert>
</rpc>
响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <ok/> </rpc-reply>
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <error/> </rpc-reply>
Notification上报结果
# 交换机通过Notification消息上报控制器tracert命令的执行结果。
<notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2017-06-12T16:54:03Z</eventTime>
<tracert-case-result xmlns="urn:huawei:params:xml:ns:yang:huawei-traceroute">
<test-name>aabb</test-name>
<destination>192.168.20.1</destination>
<max-hops>30</max-hops>
<packet-size>12</packet-size>
<hops>
<hop-index>1</hop-index>
<hop-address>192.168.20.2</hop-address>
<probes>
<probe-index>1</probe-index>
<result>succeed</result>
<delta-time>5</delta-time>
</probes>
<probes>
<probe-index>2</probe-index>
<result>succeed</result>
<delta-time>4</delta-time>
</probes>
<probes>
<probe-index>3</probe-index>
<result>succeed</result>
<delta-time>4</delta-time>
</probes>
</hops>
<complete>true</complete>
</tracert-case-result>
</notification>
