Siemens RUGGEDCOM MX5000RE, Reference Manual

Page: 41 / 148

RUGGEDCOM NETCONF
Reference Guide
Chapter 4
Getting Data
Using the <get> Command 29
Getting Data
This section describes how to use NETCONF to retrieve configuration data from RUGGEDCOM ROX II.
NETCONF features two get commands to retrieve data from the device:
•
<get> retrieves device state data and information from the running configuration. For more information, refer
to Section 4.1, “Using the <get> Command” .
•
<get-config>
retrieves information from a either the candidate or running configuration. For more
information, refer to Section 4.2, “Using the <get-config> Command” .
When getting information, you specify the information to retrieve by stating the path through the RUGGEDCOM
ROX II data model. You can specify the path with a series of hierarchical XML elements, or with an XPath to the
desired content.
To determine the path to the desired data, you can retrieve XML files containing the RUGGEDCOM ROX II data
model from the device.
The RUGGEDCOM ROX II database is modelled using YANG, an IETF standard for NETCONF data modelling. The
data model for RUGGEDCOM ROX II is defined in several YANG files. Typically, each RUGGEDCOM namespace is
defined in a single YANG file. YANG files contain structured content, but they are not in XML.
YIN files are XML versions of YANG data model files. YIN files are well-formed XML files, making them easily
parseable and able to be programmatically traversed and manipulated. You can use YIN files to find the path to
every data element in the RUGGEDCOM ROX II data model.
For more information on the YANG data modelling language, see
Internet Engineering Task Force RFC 6020
[http://tools.ietf.org/html/rfc6020].
CONTENTS
• Section 4.1, “Using the <get> Command”
• Section 4.2, “Using the <get-config> Command”
• Section 4.3, “Using XPaths with <get> and <get-config>”
• Section 4.4, “Getting Information for a Specific Object”
• Section 4.5, “Getting Default Values”
• Section 4.6, “Getting Data Models from the Device”
Section 4.1
Using the <get> Command
Use the
<get>
command to retrieve information from the running configuration.
The <filter> element contains the path to the information to retrieve. You can specify the path with
hierarchical XML elements, or with an XPath.
When using hierarchical elements, do the following: