eMDI Management
This section describes the configuration model of eMDI management and provides examples of XML packets.
Data Model
The configuration model file matching eMDI management is huawei-emdi.yang.
Object |
Description |
Value | Remarks |
---|---|---|---|
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-enable |
Enables eMDI. |
The value is enable. |
Before disabling eMDI, stop the running eMDI instance first. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:emdi-instance-id |
Creates an eMDI instance. |
The value is an integer in the range from 1 to 4096. |
Before deleting an eMDI instance, stop it first. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:monitor-period |
Specifies an eMDI monitoring interval. |
The value is an integer, which can be 10, 30, or 60, in seconds. |
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:rtplr-threshold |
Specifies the alarm threshold of the packet loss rate for RTP packets transported over UDP. |
The value is an integer in the range from 1 to 100000. |
Before specifying this parameter, configure a target flow whose protocol type is UDP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:rtpser-threshold |
Specifies the alarm threshold of the out-of-order rate for RTP packets transported over UDP. |
The value is an integer in the range from 1 to 100000. |
Before specifying this parameter, configure a target flow whose protocol type is UDP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:uplr-threshold |
Specifies the alarm threshold of the upstream TCP packet loss rate. |
The value is an integer in the range from 1 to 100000. |
Before specifying this parameter, configure a target flow whose protocol type is TCP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:dplr-threshold |
Specifies the alarm threshold of the downstream TCP packet loss rate. |
The value is an integer in the range from 1 to 100000. |
Before specifying this parameter, configure a target flow whose protocol type is TCP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:source-ip-address |
Specifies the source IP address of a target flow. |
The value is in dotted decimal notation. |
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:destination-ip-address |
Specifies the destination IP address of a target flow. |
The value is in dotted decimal notation. |
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:ip-protocol-id |
Specifies the protocol type of a target flow. |
The value is of the enumerated type:
|
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:source-port |
Specifies the source port number of a target flow. |
The value is an integer in the range from 1 to 65535. |
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:destination-port |
Specifies the destination port number of a target flow. |
The value is an integer in the range from 1 to 65535. |
NA |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:vlan-id |
Specifies the VLAN ID of a target flow. |
The value is an integer in the range from 1 to 4094. |
N/A |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:pt-value |
Specifies the payload type of a target flow. |
The value is an integer in the range from 25 to 127. |
This parameter can be configured only for target flows transported over UDP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:clock-rate |
Specifies the clock rate of a target flow. |
The value is of the enumerated type:
|
This parameter can be configured only for target flows transported over UDP. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:duration |
Specifies the lifetime of an eMDI instance. |
The value is an integer in the range from 300 to 604800. |
An eMDI instance automatically stops when its lifetime expires. |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance/emdi:auto-start |
Specifies whether to start the current eMDI instance. |
The value is of the Boolean type:
|
N/A |
/huawei-emdi:flow-switch/input/instance-id |
Specifies the eMDI instance started in RPC messages. |
The value is an integer in the range from 1 to 4096. |
The value must be an existing eMDI instance. |
/huawei-emdi:flow-switch/input/start |
Starts an eMDI instance. |
- |
Before starting an eMDI instance, you must configure a target flow. |
/huawei-emdi:flow-switch/input/stop |
Stops an eMDI instance. |
- |
N/A |
Configuring the eMDI Function
This section provides a sample of configuring the eMDI function using the edit-config method.
Operation |
XPATH |
---|---|
edit-config:config |
/emdi:emdi/emdi:emdi-enables/emdi:emdi-enable/emdi:emdi-instances/emdi:emdi-instance |
RPC |
/huawei-emdi:flow-switch |
Data Requirement 1
Item |
Data |
Description |
---|---|---|
emdi-enable |
enable |
Enable eMDI and display the eMDI view. |
emdi-instance-id |
11 |
Create an eMDI instance and display the eMDI instance view. |
source-ip-address |
10.10.10.10 |
Set the source IP address of a target flow. |
destination-ip-address |
10.10.10.20 |
Set the destination IP address of a target flow. |
ip-protocol-id |
6 |
Set the protocol type of a target flow. |
source-port |
65535 |
Set the source port number of a target flow. |
destination-port |
65535 |
Set the destination port number of a target flow. |
uplr-threshold |
100000 |
Set the alarm threshold of the upstream TCP packet loss rate. |
dplr-threshold |
100000 |
Set the alarm threshold of the downstream TCP packet loss rate. |
duration |
300 |
Set the lifetime of the eMDI instance. |
monitor-period |
10 |
Set an eMDI monitoring interval. |
auto-start |
true |
Starts the eMDI instance. |
Request Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <edit-config> <target> <running/> </target> <config> <emdi:emdi xmlns:emdi="urn:huawei:yang:huawei-emdi"> <emdi:emdi-enables> <emdi:emdi-enable> <emdi:emdi-enable>enable</emdi:emdi-enable> <emdi:emdi-instances> <emdi:emdi-instance> <emdi:emdi-instance-id>11</emdi:emdi-instance-id> <emdi:monitor-period>second-10s</emdi:monitor-period> <emdi:uplr-threshold>100000</emdi:uplr-threshold> <emdi:dplr-threshold>100000</emdi:dplr-threshold> <emdi:source-ip-address>10.10.10.10</emdi:source-ip-address> <emdi:destination-ip-address>10.10.10.20</emdi:destination-ip-address> <emdi:ip-protocol-id>6</emdi:ip-protocol-id> <emdi:source-port>65535</emdi:source-port> <emdi:destination-port>65535</emdi:destination-port> <emdi:duration>300</emdi:duration> <emdi:auto-start>true</emdi:auto-start> </emdi:emdi-instance> </emdi:emdi-instances> </emdi:emdi-enable> </emdi:emdi-enables> </emdi:emdi> </config> </edit-config> </rpc>
Response Example
# Sample of successful response.
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <ok/> </rpc-reply>
# Sample of failed response.
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <rpc-error> <error-path>/huawei-emdi:flow-switch/instance-id/huawei-emdi:flow-switch/instance-id> <error-message>error-message>Leafref "/emdi/emdi-enables/emdi-enable/emdi-instances/emdi-instance/emdi-instance-id" of value "12" points to a non-existing leaf.</error-message> </rpc-error> </rpc-reply>
Data Requirement 2
Item |
Data |
Description |
---|---|---|
instance-id |
11 |
Set the ID of the eMDI instance. |
start |
[spaces] |
Start the eMDI instance. Spaces indicate to start an eMDI instance. |
Start Request Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <emdi:flow-switch xmlns:emdi="urn:huawei:yang:huawei-emdi"> <emdi:instance-id>11</emdi:instance-id> <emdi:start> <emdi:start> </emdi:flow-switch> </rpc>
Response Example
# Sample of successful response.
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <ok/> </rpc-reply>
# Sample of failed response.
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <rpc-error> <error-path>/huawei-emdi:flow-switch/instance-id/huawei-emdi:flow-switch/instance-id> <error-message>error-message>Leafref "/emdi/emdi-enables/emdi-enable/emdi-instances/emdi-instance/emdi-instance-id" of value "12" points to a non-existing leaf.</error-message> </rpc-error> </rpc-reply>
Data Requirement 3
Item |
Data |
Description |
---|---|---|
instance-id |
11 |
Specify the ID of the eMDI instance. |
Deletion Request Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <edit-config> <target> <running/> </target> <config> <emdi:emdi xmlns:emdi="urn:huawei:yang:huawei-emdi"> <emdi:emdi-enables> <emdi:emdi-enable> <emdi:emdi-enable>enable</emdi:emdi-enable> <emdi:emdi-instances> <emdi:emdi-instance nc:operation="delete" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <emdi:emdi-instance-id>11</emdi:emdi-instance-id> </emdi:emdi-instance> <emdi:emdi-instance nc:operation="delete" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> </emdi:emdi-instances> </emdi:emdi-enable> </emdi:emdi-enables> </emdi:emdi> </config> </edit-config> </rpc>
Response Example
# Sample of successful response.
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <ok/> </rpc-reply>
# Sample of failed response.
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <rpc-error> <error-path>/huawei-emdi:flow-switch/instance-id/huawei-emdi:flow-switch/instance-id> <error-message>error-message>Leafref "/emdi/emdi-enables/emdi-enable/emdi-instances/emdi-instance/emdi-instance-id" of value "12" points to a non-existing leaf.</error-message> </rpc-error> </rpc-reply>