
Junos OS 13.1 Junos XML Management Protocol Guide
Copyright and Trademark Information
Table of Contents
List of Tables
About This Guide
Overview
Introduction to the Junos XML Management Protocol and Junos
XML API
Using Junos XML Management Protocol and Junos XML Tag Elements
XML and Junos XML Management Protocol Conventions Overview
Mapping Commands to Junos XML Tag Elements
Mapping Configuration Statements to Junos XML Tag Elements
Mapping for Hierarchy Levels and Container Statements
Mapping for Objects That Have an Identifier
Mapping for Single-Value and Fixed-Form Leaf Statements
Mapping for Leaf Statements with Multiple Values
Mapping for Multiple Options on One or More Lines
Mapping for Comments About Configuration Statements
Using the Same Configuration Tag Elements in Requests and Responses
Using the Junos XML Management Protocol
Controlling the Junos XML Management Protocol Session
Client Application’s Role in a Junos XML Protocol Session
Establishing a Junos XML Management Protocol Session
Exchanging Information with the Junos XML Protocol Server
Locking and Unlocking the Candidate Configuration or Creating
a Private Copy
Ending a Junos XML Protocol Session and Closing the Connection
Displaying CLI Output as XML Tag Elements
Displaying
the RPC Tags for a Command
Example of a Junos XML Protocol Session
Requesting
Information
Overview
of the Request Procedure
Requesting
Operational Information
Specifying the Output Format for Operational Information Requests
in a Junos XML Protocol Session
Requesting
Configuration Information
Specifying
the Source and Output Format of Configuration Information
Requesting
Information from the Committed or Candidate Configuration
Requesting
Output as Formatted ASCII Text or Junos XML Tag Elements
Requesting
an Indicator for Identifiers
Requesting
a Change Indicator for Configuration Elements
Displaying
Commit-Script-Style XML Data
Specifying
the Output Format for Configuration Groups and Interface Ranges
Comparing
Configuration Changes with a Prior Version
Specifying
the Scope of Configuration Information to Return
Requesting
the Complete Configuration
Requesting
a Hierarchy Level or Container Object Without an Identifier
Requesting
All Configuration Objects of a Specified Type
Requesting
a Specified Number of Configuration Objects
Requesting
Identifiers Only
Requesting
One Configuration Object
Requesting
a Subset of Objects by Using Regular Expressions
Requesting
Multiple Configuration Elements Simultaneously
Requesting
an XML Schema for the Configuration Hierarchy
Requesting
a Previous (Rollback) Configuration
Comparing
Two Previous (Rollback) Configurations
Requesting
the Rescue Configuration
Changing Configuration Information
Overview of Configuration Changes
Specifying the Source and Format of New Configuration Data
Replacing the Entire Configuration
Creating, Modifying, or Deleting Configuration Elements
Reordering Elements in Configuration Objects
Renaming a Configuration Object
Protecting or Unprotecting a Configuration
Object
Changing a Configuration Element’s Activation State
Changing a Configuration Element’s Activation State Simultaneously with Other Changes
Committing
a Configuration
Verifying
a Configuration Before Committing It
Committing
the Candidate Configuration
Committing
a Private Copy of the Configuration
Committing
a Configuration at a Specified Time
Committing
the Candidate Configuration Only After Confirmation
Committing
and Synchronizing a Configuration on Redundant Control Planes
Logging
a Message About a Commit Operation
Summary of Junos XML Protocol Tag Elements
<abort/>
<abort-acknowledgement/>
<authentication-response>
<challenge>
<checksum-information>
<close-configuration/>
<commit-configuration>
<commit-results>
<database-status>
<database-status-information>
<end-session/>
<get-checksum-information>
<get-configuration>
<junoscript>
<kill-session>
<load-configuration>
<load-configuration-results>
<lock-configuration/>
<open-configuration>
<reason>
<request-end-session/>
<request-login>
<routing-engine>
<rpc>
<rpc-reply>
<unlock-configuration/>
<?xml?>
<xnm:error>
<xnm:warning>
Summary of Attributes in Junos XML Tags
Writing Junos XML Protocol Client Applications
Writing
Junos XML Protocol Perl Client Applications
Writing Junos XML Protocol C Client Applications
IndexSymbols
- #, comments in configuration statements
- $
- regular expression operator
- ( ), in syntax descriptions
- *
- regular expression operator
- +
- regular expression operator
- . (period)
- regular expression operator
- < >, in syntax descriptions
- <?xml?> tag (Junos XML protocol) 1
- <checksum-information> (Junos XML protocol)
- <checksum> attribute
- <computation-method> attribute
- <file-checksum> attribute
- <input-file> attribute
- ?
- regular expression operator
- [ ], in configuration statements
- ^
- regular expression operator
- { }, in configuration statements
- | (pipe)
- regular expression operator
- | (pipe), in syntax descriptions
A
- abort tag (Junos XML protocol) 1
- abort-acknowledgement tag (Junos XML protocol) 1
- access
- protocols for Junos XML management protocol
- protocols for Junos XML protocol
- action attribute (Junos XML protocol)
- active attribute (Junos XML with Junos XML protocol) 1
- ASCII, formatted, in Junos XML protocol
- at-time tag (Junos XML protocol) 1
- attributes
- Junos XML protocol tags Junos XML protocol tags See Index of Tag Elements and Attributes for list See names of individual attributes for usage guidelines
- Junos XML tags See Index of Tag Elements and Attributes for list See names of individual attributes for usage guidelines
- authentication
- Junos XML protocol
- authentication-response tag (Junos XML protocol) 1
B
C
- C-language Junos XML protocol client applications
- candidate (Junos XML protocol 'database' attribute)
- challenge tag (Junos XML protocol) 1, 2
- challenge-response tag (Junos XML protocol) 1
- changed attribute (Junos XML protocol)
- check tag (Junos XML protocol)
- child tags See tags (XML)
- clear-text (Junos XML protocol-specific access protocol)
- CLI
- client applications, sample JUNOS XML Protocol
- Perl See Perl client applications
- client applications, sample Junos XML protocol
- close-configuration tag (Junos XML protocol) 1
- column tag (Junos XML protocol) 1, 2
- command output
- commands
- Junos XML equivalents
- Junos XML protocol See Junos XML protocol command
- mapping options to Junos XML tags
- comments
- comments, in configuration statements
- commit tag (Junos XML protocol)
- commit-at tag (Junos XML protocol)
- commit-check tag (Junos XML protocol)
- usage guidelines
- commit-check-success tag (Junos XML protocol) 1
- usage guidelines
- commit-configuration tag (Junos XML protocol) 1
- commit-information tag (Junos XML)
- commit-results tag (Junos XML protocol) 1
- commit-scripts attribute (Junos XML protocol)
- commit-success tag (Junos XML protocol) 1
- committed (Junos XML protocol 'database' attribute)
- compare attribute (Junos XML protocol)
- compare tag (Junos XML)
- comparing
- compatibility
- configuration
- adding comments
- changing
- committing
- confirmation required (Junos XML protocol)
- force-synchronizing on Routing Engines (Junos XML protocol)
- immediately (Junos XML protocol)
- logging message about (Junos XML protocol)
- private copy (Junos XML protocol)]
- scheduling for later (Junos XML protocol)
- synchronizing on Routing Engines (Junos XML protocol)
- comparing to prior version
- comparing with previous
- creating
- deactivating statement or identifier
- deleting
- discarding changes
- displaying
- candidate or committed (Junos XML protocol)
- changed elements (Junos XML protocol)
- commit-scripts-style XML (Junos XML protocol)
- comparison(Junos XML protocol)
- entire (Junos XML protocol)
- group data as inherited (Junos XML protocol)
- hierarchy level (Junos XML protocol)
- identifier indicator (Junos XML protocol)
- identifiers (Junos XML protocol)
- interface-range data as inherited (Junos XML protocol)
- multiple elements at once (Junos XML protocol)
- objects of specific type (Junos XML protocol)
- overview (Junos XML protocol)
- rescue (Junos XML protocol)
- rollback (Junos XML protocol)
- single object (Junos XML protocol)
- source group for inherited statements (Junos XML protocol)
- source interface range for inherited statements (Junos XML protocol)
- specified number of objects (Junos XML protocol)
- tags or formatted ASCII (Junos XML protocol)
- using regular expressions (Junos XML protocol)
- XML schema for
- groups See configuration groups
- interface ranges See interface ranges
- Junos XML management protocol operations on
- loading
- locking, with Junos XML protocol
- merging current and new, with Junos XML protocol
- modifying, with Junos XML protocol
- overriding, with Junos XML protocol
- protecting elements, with Junos XML protocol
- reactivating statement or identifier
- renaming elements, with Junos XML protocol
- reordering elements, with Junos XML protocol
- replacing
- rescue
- rolling back to previous, with Junos XML protocol
- statements See configuration statements
- unlocking, with Junos XML protocol
- unprotecting elements, with Junos XML protocol
- verifying, with Junos XML protocol
- configuration groups
- configuration mode commands, in Junos XML protocol
- configuration statements
- adding comments about
- deactivating
- mapping to Junos XML tags
- reactivating
- configuration tag (Junos XML) 1
- configuration-information tag (Junos XML)
- configuration-output tag (Junos XML)
- configuration-set tag (Junos XML)
- configuration-text tag (Junos XML)
- configure-exclusive tag (Junos XML protocol)
- confirm-timeout tag (Junos XML protocol) 1
- Junos XML protocol
- confirmed tag (Junos XML protocol) 1
- Junos XML protocol
- conventions
- Junos XML management protocol
- text and syntax
- count attribute (Junos XML with Junos XML protocol) 1
- curly braces, in configuration statements
- customer support 1
D
- daemon tag (Junos XML protocol)
- database attribute (Junos XML protocol)
- database-status tag (Junos XML protocol)
- database-status-information tag (Junos XML protocol)
- defaults (Junos XML protocol 'inherit' attribute)
- delete attribute (Junos XML with Junos XML protocol) 1
- devices
- configuration See configuration
- display xml command
- display xml filter 1, 2
- display xml rpc command
- Document Object Model See DOM
- document type definition See DTD
- documentation
- DOM
- DTD
E
- echo attribute (Junos XML protocol)
- edit-path tag (Junos XML protocol) 1, 2, 3
- encoding attribute (Junos XML protocol)
- encoding attribute (Junos XML protocol))
- end-session tag (Junos XML protocol) 1
- entity references, predefined (Junos XML)
- error messages
- examples, Junos XML
- mapping of configuration statement to tag
- examples, Junos XML protocol
- client applications
- committing configuration
- comparing configurations
- creating private copy of configuration
- deactivating
- deleting
- force-synchronizing configuration
- logging message for commit
- merging in new configuration element
- overriding current configuration
- renaming configuration elements
- reordering configuration elements
- replacing configuration elements
- requesting
- candidate configuration
- change indicator
- committed configuration
- configuration as formatted ASCII text
- identifier indicator
- identifiers only
- objects identified by regular expression
- one configuration object
- one hierarchy level
- previous (rollback) configuration
- specific number of configuration objects
- XML schema
- scheduling commit operation
- synchronizing configuration
- viewing commit log
- exclusive tag (Junos XML protocol)
F
- fail tag (Junos XML protocol)
- false (Junos XML protocol 'recurse' attribute)
- filename tag (Junos XML protocol) 1, 2
- files
- font conventions
- force-synchronize tag (Junos XML protocol) 1
- format attribute (Junos XML protocol)
- format tag (Junos XML)
G
- get-checksum-information tag (Junos XML protocol)
- get-commit-information tag (Junos XML)
- get-configuration tag (Junos XML protocol) 1
- attributes, usage guidelines
- overview
- usage guidelines for requesting
- get-rescue-information tag (Junos XML)
- get-rollback-information tag (Junos XML)
- get-xnm-information tag (Junos XML)
- groups See configuration groups
- groups attribute (Junos XML protocol)
H
- hostname attribute (Junos XML protocol)
- junoscript tag
- usage guidelines
I
- icons defined, notice
- identifiers
- idle-time tag (Junos XML protocol)
- inactive attribute (Junos XML with Junos XML protocol) 1
- usage guidelines for setting
- inherit attribute (Junos XML protocol)
- insert attribute (Junos XML with Junos XML protocol) 1
- usage guidelines
- interface ranges 1
- interface-range attribute (Junos XML protocol)
- interface-ranges attribute (Junos XML protocol)
J
- Junos OS
- Junos XML API
- advantages of
- overview
- predefined entity references
- tags Junos XML tags See Junos XML tags
- Junos XML management protocol
- Junos XML management protocol session
- Junos XML management protocol tags
- Junos XML protocol command
- JUNOS XML protocol Perl client
- Junos XML protocol server 1
- Junos XML protocol session
- authentication and security
- ending
- establishing
- example
- terminating another
- Junos XML protocol tag
- usage guidelines
- Junos XML tags
- commit-information tag
- compare tag
- configuration
- configuration tag
- configuration-information tag
- configuration-output tag
- configuration-text tag
- displaying CLI output as 1, 2
- format tag
- get-commit-information tag
- get-rescue-information
- get-rollback-information tag
- get-xnm-information tag
- junos:comment tag
- loading configuration as
- mapping
- namespace tag
- notational conventions
- output tag
- rollback tag
- rollback-information
- rollback-information tag
- type tag
- undocumented tag
- xsd:import tag
- xsd:schema tag
- junos.xsd file
- JUNOS::Device module
- junos:changed attribute (Junos XML with Junos XML protocol)
- junos:changed attribute (Junos XML)
- junos:changed-localtime attribute (Junos XML) 1
- junos:changed-seconds attribute (Junos XML) 1
- junos:comment tag (Junos XML)
- junos:commit-localtime attribute (Junos XML) 1
- junos:commit-seconds attribute (Junos XML) 1
- junos:commit-user attribute (Junos XML) 1
- junos:defaults group,
- junos:group attribute (Junos XML with Junos XML protocol)
- junos:groups attribute (Junos XML with Junos XML protocol)
- junos:interface-range attribute (Junos XML with Junos XML protocol) 1
- junos:key attribute (JUNO XML with Junos XML protocol)
- junos:key attribute (Junos XML with Junos XML protocol)
- junos:key attribute(Junos XML protocol)
- junos:position attribute (JUNO XML with Junos XML protocol)
- junos:position attribute (Junos XML with Junos XML protocol)
- junos:total attribute (Junos XML with Junos XML protocol) 1
- junoscript tag (Junos XML protocol)
K
- keyword in configuration statement, Junos XML mapping
- kill-session tag (Junos XML protocol) 1
L
- leaf statement
- line-number tag (Junos XML protocol) 1, 2
- load-configuration tag (Junos XML protocol) 1
- attributes, usage guidelines
- usage guidelines
- load-configuration-results tag (Junos XML protocol) 1
- load-error-count tag (Junos XML protocol) 1
- usage guidelines
- load-success tag (Junos XML protocol) 1, 2
- lock-configuration tag (Junos XML protocol) 1
- log tag (Junos XML protocol) 1
- log-in tag (Junos XML protocol)
- login-name tag (Junos XML protocol)
M
N
- name tag (Junos XML protocol) 1
- usage guidelines
- namespace tag (Junos XML)
- namespaces See XML namespaces
- newline character in XML tag sequences
- notice icons defined
O
- open-configuration tag (Junos XML protocol) 1
- operational mode, CLI
- Junos XML mapping
- operational request
- operators, regular expression
- options in configuration statements, Junos XML mapping
- os attribute (Junos XML protocol)
- outbound-ssh tag
- output from Junos XML protocol server, parsing
- output tag (Junos XML)
- override (value of Junos XML protocol 'action' attribute)
- overview
P
- parentheses, in syntax descriptions
- parse tag (Junos XML protocol)
- path attribute (Junos XML protocol)
- Perl client applications (Junos XML Protocol)
- Perl client applications (Junos XML protocol)
- pid tag (Junos XML protocol)
- PIs, XML See XML PIs
- predefined entity references (Junos XML)
- prerequisites
- private tag (Junos XML protocol)
- process-disabled tag (Junos XML protocol)
- process-not-configured tag (Junos XML protocol)
- process-not-running tag (Junos XML protocol)
- processing instructions, XML
- protect attribute (Junos XML with Junos XML protocol) 1
- usage guidelines
R
- re-name tag (Junos XML protocol)
- reason tag (Junos XML protocol)
- recurse attribute (Junos XML with Junos XML protocol) 1
- regular expression operators
- release attribute (Junos XML protocol)
- junoscript tag
- usage guidelines
- rename attribute (Junos XML with Junos XML protocol) 1
- usage guidelines
- replace (value of Junos XML protocol 'action' attribute)
- usage guidelines
- replace attribute (Junos XML with Junos XML protocol) 1
- request tags (XML) See tags (XML)
- request-end-session tag (Junos XML protocol) 1
- request-login tag (Junos XML protocol) 1
- rescue attribute (Junos XML protocol)
- rescue configuration
- response tags (XML) See tags (XML)
- rollback attribute (Junos XML protocol)
- rollback tag (Junos XML)
- rollback-information tag (Junos XML)
- routing-engine tag (Junos XML protocol) 1, 2
- RPC
- rpc tag (Junos XML protocol) 1
- rpc-error tag (Junos XML protocol)
- rpc-reply tag (Junos XML protocol) 1
S
- SAX
- schema See XML schema
- schemaLocation attribute (Junos XML protocol)
- security
- server See Junos XML protocol server
- session See Junos XML management protocol session
- session-id tag (Junos XML protocol)
- terminating session 1
- Simple API for XML See SAX
- software versions
- source-daemon tag (Junos XML protocol) 1, 2
- space character in XML tag sequences
- ssh service
- SSH service, outbound
- SSL (Junos XML protocol access protocol)
- start attribute (Junos XML with Junos XML protocol) 1
- start-time tag (Junos XML protocol)
- statement tag (Junos XML protocol) 1, 2
- status tag (Junos XML protocol) 1
- success tag (Junos XML protocol)
- support, technical See technical support
- supported Junos XML protocol software versions
- synchronize tag (Junos XML protocol) 1
- syntax conventions
T
- tags See Junos XML tags, Junos XML management protocol tags
- tags (XML)
- TCP
- as Junos XML protocol-specific access protocol See clear-text
- technical support
- Telnet
- terminal tag (Junos XML protocol)
- text
- formatted ASCII in Junos XML protocol
- token tag (Junos XML protocol) 1, 2
- type tag (Junos XML)
U
- undocumented tag (Junos XML)
- unlock-configuration tag (Junos XML protocol) 1
- unprotect attribute (Junos XML with Junos XML protocol) 1
- usage guidelines
- update (value of Junos XML protocol 'action' attribute)
- url attribute (Junos XML protocol)
- user tag (Junos XML protocol)
- username tag (Junos XML protocol) 1
V
- version attribute (Junos XML protocol)
- <?xml?> tag 1
- Junos XML protocol tag
- junoscript tag
W
X
- XML
- attributes See Junos XML tags, Junos XML management protocol tags
- namespaces 1, namespaces See Junos XML tags, Junos XML management protocol tags
- overview
- PIs See XML PIs
- schema, requesting
- tags See Junos XML tags, Junos XML management protocol tags
- xml (Junos XML protocol 'format' attribute)
- get-configuration tag
- load-configuration tag
- XML PIs
- <?xml?> tag (Junos XML protocol)
- usage guidelines
- xmlns attribute (Junos XML protocol) 1
- configuration tag
- junoscript tag
- usage guidelines
- xmlns:junos attribute (Junos XML protocol)
- Junos XML protocol tag
- junoscript tag
- rpc-reply tag 1
- xmn:error tag (Junos XML protocol)
- xnm-clear-text statement
- xnm-ssl statement
- xnm:error tag (Junos XML protocol)
- xnm:warning tag (Junos XML protocol) 1
- xsd:import tag (Junos XML)
- xsd:schema tag (Junos XML)