Brocade Network OS NETCONF Operations Guide v4.1.1 - Manual (Page 42)

10 Network OS NETCONF Operations Guide
53-1003231-02
Establishing a NETCONF session
2
The following example shows a <hello> element from the NETCONF server.
<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<capabilities>
<capability>urn:ietf:params:netconf:base:1.0</capability>
<capability>urn:ietf:params:netconf:capability:writable-running:1.0
</capability>
<capability>urn:ietf:params:netconf:capability:startup:1.0</capability>
<capability>urn:ietf:params:netconf:capability:xpath:1.0</capability>
<capability>urn:ietf:params:netconf:capability:validate:1.0</capability>
<capability>http://tail-f.com/ns/netconf/actions/1.0</capability>
<capability>http://tail-f.com/ns/aaa/1.1?revision=2010-06-17&module=tailf-
aaa</capability>
<capability>urn:brocade.com:mgmt:brocade-aaa?revision=2010-10-21&module=br
ocade-aaa</capability>
<capability>urn:brocade.com:mgmt:brocade-aaa-ext?revision=2010-09-21&modul
e=brocade-aaa-ext</capability>
<capability>urn:brocade.com:mgmt:brocade-cdp?revision=2010-08-17&module=br
ocade-cdp</capability>
<capability>urn:brocade.com:mgmt:brocade-cee-map?revision=2011-04-18&modul
e=brocade-cee-map</capability>
<capability>
urn:brocade.com:mgmt:brocade-chassis?revision=2011-04-11&module=brocade-chassis
</capability>
</capabilities>
(output truncated)
<session-id>4</session-id>
</hello>
Server capabilities
A NETCONF capability is a set of protocol extensions that supplements the base NETCONF
specification. A NETCONF capability is identified with a Uniform Resource Identifier (URI).
Capabilities augment the base operations of the NETCONF server, describing both the additional
operations and the contents allowed inside the operations. To support a capability, the NETCONF
server must support all the dependent capabilities.
The following capabilities are supported on Network OS switches:
• Base capability—The set of operations and contents that any NETCONF implementation must
support. The URI for the base capability is urn:ietf:param:xml:ns:netconf:base:1.0. Both the
NETCONF client and server must support the base capability.
• Writable-running capability—Indicates that the device supports <edit-config> and
<copy-config> operations where the <running> configuration is the target. The URI is
urn:ietf:params:netconf:capability:writable-running:1.0.
• Startup capability—Supports separate datastores for the running and startup configuration.
Operations performed on the running-config datastore do not affect the startup configuration
until a <copy-config> operation is performed to explicitly copy the running configuration to the
startup configuration. The URI for the startup capability is
urn:ietf:params:netconf:capability:startup:1.0.
• Xpath capability—Supports XPath expressions in <filter> elements. <filter> elements are used
in <get> and <get-config> operations to limit the scope of the retrieved data. The URI for the
xpath capability is urn:ietf:params:netconf:capability:xpath:1.0.
• Validate capability—Allows validation to be performed on a configuration. The URI for the
validate capability is urn:ietf:params:netconf:capability:validate:1.0.