Commit the Candidate Configuration Using NETCONF
Wenn Sie die Kandidatenkonfiguration auf einem Gerät mit Junos OS festlegen, wird sie zur aktiven Konfiguration auf der Routing-, Switching- oder Sicherheitsplattform. Ausführlichere Informationen über Commit-Operationen, einschließlich einer Diskussion über die Interaktion zwischen verschiedenen Betriebsvarianten, finden Sie im CLI-Benutzerhandbuch.
In einer NETCONF-Sitzung mit einem Gerät, auf dem Junos OS ausgeführt wird, um die Kandidatenkonfiguration zu bestätigen, schließt eine Clientanwendung das <commit/>
Tag in ein Tag-Element ein <rpc>
.
<rpc> <commit/> </rpc> ]]>]]>
Wir empfehlen, dass die Clientanwendung die Kandidatenkonfiguration vor dem Ändern sperrt und das <commit/>
Tag ausgibt, während die Konfiguration noch gesperrt ist. Dieser Prozess vermeidet unbeabsichtigte Änderungen von anderen Benutzern oder Anwendungen. Nach dem Festlegen der Konfiguration muss die Anwendung sie freischalten, damit andere Benutzer und Anwendungen Änderungen vornehmen können.
Der NETCONF-Server bestätigt, dass der Commit-Vorgang erfolgreich war, indem er das <ok/>
Tag im <rpc-reply>
Tag-Element zurücksendet.
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
Wenn der Commit-Vorgang fehlschlägt, gibt der Server das Element und <rpc-error>
das <rpc-reply>
untergeordnete Element zurück, was den Grund für den Fehler erklärt. Die häufigsten Ursachen sind semantische oder syntaktische Fehler in der Kandidatenkonfiguration.
Sie können die rfc-compliant
Anweisung auf Hierarchieebene [edit system services netconf]
konfigurieren, um bestimmte Verhaltensweisen durch den NETCONF-Server durchzusetzen, was Änderungen in der Reaktion des NETCONF-Servers auf <commit>
Vorgänge umfasst. Tabelle 1 beschreibt die Änderungen in RFC-konformen Sitzungen.
Commit-RPC-Antwort | Standardantwort | RFC-konforme Sitzungsantwort |
---|---|---|
Bei einem erfolgreichen <commit> Vorgang wird eine Antwort mit Warnungen zurückgegeben. |
Der NETCONF-Server gibt ein <ok/> Element zurück und kann auch ein oder mehrere <rpc-error> Elemente mit einer Warnungsstufe für den Schweregrad zurückgeben. |
Ab Junos OS Version 17.4R3, 18.2R2, 18.3R2 und 18.4R1 gibt der NETCONF-Server ein <ok/> Element zurück, verzichtet jedoch auf Warnungen. In Junos OS Version 21.2R1 und höher werden die Warnungen auch zur Systemprotokolldatei umgeleitet. |
Eine <commit> Betriebsantwort gibt ein <rpc-error> Element zurück, das ein <source-daemon> Element enthält. |
Die NETCONF-Serverantwort emittiert das <source-daemon> Element als untergeordnetes element von <rpc-error> . |
Ab Junos OS Version 21.2R1 emittiert die NETCONF-Serverantwort das <source-daemon> Element als untergeordnetes element von <error-info> . |
Eine <commit> Betriebsreaktion umfasst ein <commit-results> Element. |
Der NETCONF-Server enthält den <commit-results> XML-Teilbaum zusätzlich zu einem Element oder <rpc-error> untergeordneten <ok/> Element. |
Wenn Sie die flatten-commit-results Anweisung auch auf Hierarchieebene [edit system services netconf] konfigurieren, unterdrückt der NETCONF-Server den <commit-results> XML-Teilbaum und gibt nur ein <ok/> <rpc-error> Element in seiner Antwort aus. |