Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Commit Script Overview

 

Understanding Commit Scripts

Junos OS commit scripts enable users to customize the validation process of their configurations in accordance with their own practices and policies and enforce custom configuration rules during the commit process. When a candidate configuration is committed, it is inspected by each active commit script. If a configuration violates your custom rules, the script can instruct Junos OS to take appropriate action. A commit script can:

  • Generate and display custom warning messages to the user

  • Generate and log custom system log (syslog) messages

  • Change the configuration to conform to the custom business rules

  • Generate a commit error and halt the commit operation

Commit scripts are based on the Junos XML management protocol and the Junos XML API. The Junos XML management protocol is an XML based RPC mechanism, and the Junos XML API is an XML representation of Junos OS configuration statements and operational mode commands.

Commit scripts can be written in Python, Extensible Stylesheet Language Transformations (XSLT), or Stylesheet Language Alternative syntaX (SLAX). The Junos XML API defines an XML equivalent for all statements in the Junos configuration hierarchy . Commit scripts use XML Path Language (XPath) to locate the configuration objects to be inspected and automation script constructs to specify the actions to perform on the configuration objects. The actions can change the configuration or generate messages about it.

Additionally, you can create macros, which allow you to create custom configuration syntax that simplifies the task of configuring a device running Junos OS. By itself, your custom syntax has no operational impact on the device. A corresponding commit script macro uses your custom syntax as input data for generating standard Junos OS configuration statements that execute your intended operational impact.

To view the device's current configuration in Extensible Markup Language (XML) in the command-line interface (CLI), issue the show configuration | display xml command in operational mode. To view your configuration in commit-script-style XML, issue the show configuration | display commit-scripts view command. Commit-script-style XML view displays the configuration in the format that would be input to a commit script.

Benefits of Commit Scripts

Commit scripts provide the following benefits:

  • Enable the enforcement of custom configuration rules

  • Improve network reliability and uptime by minimizing human error

  • Automatically correct configuration mistakes during a commit operation

  • Abstract and simplify complex configurations

  • Enforce scaling limits for critical settings