Juniper JUNOS OS 10.3 - XML MANAGEMENT PROTOCOL GUIDE 6-30-2010 Manual page 11

Chapter 4
Chapter 5
Copyright © 2010, Juniper Networks, Inc.
Example of a Junos XML Protocol Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Exchanging Initialization PIs and Tag Elements . . . . . . . . . . . . . . . . . . . . . . . . 57
Sending an Operational Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Locking the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Changing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Committing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Unlocking the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Closing the Junos XML Protocol Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Requesting Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Overview of the Request Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Requesting Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Parsing the <output> Tag Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Requesting Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Specifying the Source and Output Format of Configuration Information . . . . . . . 65
Requesting Information from the Committed or Candidate
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Requesting Output as Formatted ASCII Text or Junos XML Tag
Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Requesting a Change Indicator for Configuration Elements . . . . . . . . . . . . . . 70
Requesting an Indicator for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Specifying the Output Format for Configuration Groups . . . . . . . . . . . . . . . . 74
Specifying Whether Configuration Groups Are Displayed Separately . . . 75
Displaying the Source Group for Inherited Configuration Elements . . . . . 76
Examples: Specifying Output Format for Configuration Groups . . . . . . . 78
Specifying the Scope of Configuration Information to Return . . . . . . . . . . . . . . . . 81
Requesting the Complete Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Requesting a Hierarchy Level or Container Object Without an Identifier . . . . 82
Requesting All Configuration Objects of a Specified Type . . . . . . . . . . . . . . . 83
Requesting a Specified Number of Configuration Objects . . . . . . . . . . . . . . . 84
Requesting Identifiers Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Requesting One Configuration Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Requesting a Subset of Objects by Using Regular Expressions . . . . . . . . . . . 90
Requesting Multiple Configuration Elements Simultaneously . . . . . . . . . . . . 93
Requesting an XML Schema for the Configuration Hierarchy . . . . . . . . . . . . . . . . 94
Creating the junos.xsd File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Example: Requesting an XML Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Requesting a Previous (Rollback) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Comparing Two Previous (Rollback) Configurations . . . . . . . . . . . . . . . . . . . . . . . 99
Requesting the Rescue Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Changing Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Overview of Configuration Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Specifying the Source and Format of New Configuration Data . . . . . . . . . . . . . . 105
Providing Configuration Data in a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Providing Configuration Data as a Data Stream . . . . . . . . . . . . . . . . . . . . . . 106
Defining Configuration Data as Formatted ASCII Text or Junos XML Tag
Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Table of Contents
xi