Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

Overview of the NETCONF <rpc-error> message

For any problem where you have already established basic connectivity, you should receive a NETCONF <rpc-error> message that contains some combination of fields that give you further information.

Note: There may be multiple errors — but NETCONF only requires that the system report the first error that it encounters. Also, some clients do not display the full content of RPC errors.

The message contains information fields that should help you to find the source of the problem.

The RPC error message format

A summary of the information fields that you may see in an <rpc-error> response.

Mandatory fields
<error-type>
Defines the conceptual layer in which the error occurred. One of:
  • transport (layer: Secure Transport)
  • rpc (layer: Messages)
  • protocol (layer: Operations)
  • application (layer: Content)
<error-tag>
For a list of valid values, see RFC 6241, Appendix A NETCONF Error List.
<error-severity>

Contains a string identifying the error severity, as determined by the device. One of:

  • error
  • warning

Though note that at the time of writing, warning is not enumerated — it is reserved for future use.

Optional fields
<error-app-tag>
Data model or implementation specific error.
<error-path>
Contains an XPath expression that states the absolute path to the node that the error relates to.
<error-message>
Contains a human-readable message that relates to the error.
<error-info>
Contains error content that is specific to the protocol or data model.
Note: For more detail on specific errors and their mandatory content, see RFC 6241, Appendix A NETCONF Error List.