This page describe how to execute <get> and <edit-config> operations about "target-output-power" XML node.
Environment Requirement
- Docker container that runs a Netconf server. This container is considered as simulated equipment and supports some OpenConfig models.
- netconf-console tool that is a simulation tool for Netconf client.
- "target-output-power" node defined in "openconfig-terminal-device.yang" as the operation target node.
Assume that we have started a Netconf server in docker as follows:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 00d7151855dc emulator_openconfig_cassini_2 "./entry.sh" 9 days ago Up 20 hours 0.0.0.0:11003->830/tcp emulator_openconfig_cassini_2_1
So we use the command listed below to send RPC request to the container:
netconf-console --host=127.0.0.1 --port=11003 -u admin -p admin --rpc={XML_FILE_NAME}
The root node of "openconfig-platform.yang" is "<components>" and its sublist "<component>" contains "<name>" node as its identity. Besides, "openconfig-terminal-device.yang" adds node "<optical-channel>" into "<component>" node. "<target-power-config>" is defined as a child node of "<optical-channel>".
<get> operation
- If you want to get the whole components, the content of XML_FILE_NAME file is:
<get> <filter> <components xmlns='http://openconfig.net/yang/platform'/> </filter> </get>
- If you want to get only the "<optical-channel>" of "<component>", the content is:
<get> <filter> <components xmlns="http://openconfig.net/yang/platform"> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device" /> </component> </components> </filter> </get>
The output is :
- If you want to get the "<config>" nodes only where the frequency is 0 and the line-port is oe1:
<?xml version="1.0"?> <get> <filter> <components xmlns="http://openconfig.net/yang/platform"> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <line-port>oe1</line-port> <frequency>0</frequency> </config> </optical-channel> </component> </components> </filter> </get>
The output is:
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:190d45b0-29e8-44a7-8b6a-71f87c35f740"> <data> <components xmlns="http://openconfig.net/yang/platform"> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <frequency>0</frequency> <target-output-power>-10.0</target-output-power> <line-port>oe1</line-port> </config> </optical-channel> </component> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <frequency>0</frequency> <target-output-power>-10.0</target-output-power> <line-port>oe1</line-port> </config> </optical-channel> </component> </components> </data> </rpc-reply>
<edit-config> operation
- If you want to change the target-output-power value as 0dBm instead of the default -10.0 dBm where "<name>" ID is "oe1/2":
<?xml version="1.0"?> <edit-config> <target><running/></target> <config> <components xmlns="http://openconfig.net/yang/platform"> <component> <name>oe1/2</name> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <target-output-power>0</target-output-power> </config> </optical-channel> </component> </components> </config> </edit-config>
The output is:
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:3b4de76f-74f0-4f06-808d-64320a6c47ed"> <ok/> </rpc-reply>
Then we request the "<config>" nodes again to check this operation, where the frequency is 0 and the line-port is oe1. The output is changed:
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:190d45b0-29e8-44a7-8b6a-71f87c35f740"> <data> <components xmlns="http://openconfig.net/yang/platform"> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <frequency>0</frequency> <target-output-power>-10.0</target-output-power> <line-port>oe1</line-port> </config> </optical-channel> </component> <component> <optical-channel xmlns="http://openconfig.net/yang/terminal-device"> <config> <frequency>0</frequency> <target-output-power>0.0</target-output-power> <line-port>oe1</line-port> </config> </optical-channel> </component> </components> </data> </rpc-reply>