<commit-configuration>

Usage

<rpc>
    <commit-configuration/>

    <commit-configuration>
        <check/>
    </commit-configuration>

    <commit-configuration>
        <log>log-message</log>
    </commit-configuration>

<commit-configuration>
        <at-time>time-specification</at-time>
        <log>log-message</log>
    </commit-configuration>

    <commit-configuration>
        <confirmed/>
        <confirm-timeout>rollback-delay</confirm-timeout>
        <log>log-message</log>
    </commit-configuration>

    <commit-configuration>
        <synchronize/>
        <log>log-message</log>
    </commit-configuration>

    <commit-configuration>
        <synchronize/>
        <at-time>time-specification</at-time>
        <log>log-message</log>
    </commit-configuration>

    <commit-configuration>
        <synchronize/>
        <check/>
        <log>log-message</log>
    </commit-configuration>

    <commit-configuration>
        <synchronize/>
        <confirmed/>
        <confirm-timeout>rollback-delay</confirm-timeout>
        <log>log-message</log>
    </commit-configuration>
</rpc>

Description

Request that the JUNOScript server perform one of the following actions, depending on the tag element's contents:

• Commit the current candidate configuration immediately, making it the active configuration on the routing platform. Emit the empty <commit-configuration/> tag.
• Verify the syntactic correctness of the current candidate configuration without actually committing it. Enclose the <check/> tag in the <commit-configuration> tag element.
• Record a message in the /var/log/commits file when the associated commit operation succeeds. Define the log message string in the <log> tag element and enclose the tag element in the <commit-configuration> tag element. The <log> tag element can be combined with any other tag element. When the <log> tag element is emitted alone, the associated commit operation begins immediately.
• Schedule the current candidate configuration for commit at a future time. Enclose the <at-time> tag element in the <commit-configuration> tag element. There are three valid types of time specifiers:

• The string reboot, to commit the configuration the next time the routing platform reboots.
• A time value of the form hh:mm[:ss] (hours, minutes, and, optionally, seconds), to commit the configuration at the specified time, which must be in the future but before 11:59:59 PM on the day the <commit-configuration> tag element is emitted. Use 24-hour time for the hh value; for example, 04:30:00 means 4:30:00 AM and 20:00 means 8:00 PM. The time is interpreted with respect to the clock and time zone settings on the routing platform.
• A date and time value of the form yyyy-mm-dd hh:mm[:ss] (year, month, date, hours, minutes, and, optionally, seconds), to commit the configuration at the specified date and time, which must be after the <commit-configuration> tag element is emitted. Use 24-hour time for the hh value. For example, 2003-08-21 12:30:00 means 12:30 PM on August 21, 2003. The time is interpreted with respect to the clock and time zone settings on the routing platform.

The configuration is checked immediately for syntactic correctness. If the check succeeds, the configuration is scheduled for commit at the specified time. If the check fails, the commit operation is not scheduled.

• Commit the current candidate configuration but roll back to the previous configuration after a short time. Enclose the <confirmed/> tag in the <commit-configuration> tag element. By default, the rollback occurs after 10 minutes; to set a different rollback delay, also emit the optional <confirm-timeout> tag element.

To delay the rollback again (past the original rollback deadline), emit the <confirmed/> tag (enclosed in the <commit-configuration> tag element) again before the deadline passes. Include the <confirm-timeout> tag element to specify how long to delay the next rollback, or omit that tag element to use the default of 10 minutes. The rollback can be delayed repeatedly in this way.

To commit the configuration immediately and permanently after emitting the <confirmed/> tag, emit the empty <commit-configuration/> tag before the rollback deadline passes. The JUNOScript server commits the current candidate configuration and cancels the rollback. If the candidate configuration is still the same as the current committed configuration, the effect is the same as recommitting the current committed configuration.

• On a routing platform with two Routing Engines, commit the candidate configuration stored on the local Routing Engine on both Routing Engines. Combine tag elements as indicated in the following:

• To copy the candidate configuration stored on the local Routing Engine to the other Routing Engine, verify the candidate's syntactic correctness, and commit it immediately on both Routing Engines, enclose the <synchronize/> tag in the <commit-configuration> tag element.
• To copy the candidate configuration stored on the local Routing Engine to the other Routing Engine, verify the candidate's syntactic correctness, and commit it on both Routing Engines at a defined future time, enclose the <synchronize/> tag and <at-time> tag element in the <commit-configuration> tag element. Set the value in the <at-time> tag element as previously described for use of the <at-time> tag element alone.
• To copy the candidate configuration stored on the local Routing Engine to the other Routing Engine and verify the candidate's syntactic correctness on each Routing Engine, enclose the <synchronize/> and <check/> tags in the <commit-configuration> tag element.
• To copy the candidate configuration stored on the local Routing Engine to the other Routing Engine, verify the candidate's syntactic correctness, and commit it on both Routing Engines but require confirmation, enclose the <synchronize/> tag and <confirmed/> tags, and optionally the <confirm-timeout> tag element, in the <commit-configuration> tag element. Set the value in the <confirm-timeout> tag element as previously described for use of the <confirmed/> tag and <confirm-timeout> tag element alone.

Contents

at-time—Schedules the commit operation for a specified future time.

check—Requests verification that the configuration is syntactically correct, but does not actually commit it.

confirmed—Requests a commit of the current candidate configuration and a rollback to the previous configuration after a short time, 10 minutes by default. Use the <confirm-timeout> tag element to specify a different amount of time.

confirm-timeout—Specifies the number of minutes for which the configuration remains active when the <confirmed/> tag is enclosed in the <commit-configuration> tag element.

log—Records a message in the file /var/log/commits when the commit operation succeeds.

synchronize—Requests that the candidate configuration on the local Routing Engine be copied to the other Routing Engine, checked for correct syntax, and committed on both Routing Engines.

See Also

<commit-results>, <rpc>