Ersetzen der Kandidatenkonfiguration mithilfe von NETCONF
In einer NETCONF-Sitzung mit einem Gerät, auf dem Junos OS ausgeführt wird, kann eine Clientanwendung die gesamte Kandidatenkonfiguration oder alle Daten in der offenen Konfigurationsdatenbank ersetzen, entweder durch neue Daten oder durch ein Roll back zu einer vorherigen Konfiguration oder einer Wiederherstellungskonfiguration.
Wenn eine Clientanwendung den Junos XML-Protokollvorgang <open-configuration>
ausrichtet, um vor dem Laden der Konfigurationsdaten eine bestimmte Konfigurationsdatenbank zu öffnen, führt Junos OS den angeforderten Vorgang in der offenen Konfigurationsdatenbank aus. Andernfalls wird der Vorgang in der Kandidatenkonfiguration durchgeführt.
In den folgenden Abschnitten wird erläutert, wie Sie Konfigurationsdaten in der Kandidatenkonfiguration oder der offenen Konfigurationsdatenbank ersetzen können. Die Clientanwendung muss die Konfiguration nach dem Ersetzen der Daten festlegen, damit sie zur aktiven Konfiguration auf dem Gerät wird.
Ersetzen der Konfiguration mithilfe von <Copy-config>
Eine Methode zum Ersetzen der gesamten Kandidatenkonfiguration oder aller Daten in der offenen Konfigurationsdatenbank ist die Verwendung des Vorgangs<copy-config>
. Das <target>
Tag schließt das <candidate/>
Tag um, um anzugeben, dass die neuen Konfigurationsdaten entweder die Daten in der offenen Konfigurationsdatenbank ersetzen (wenn die Clientanwendung vor der Ausführung des Vorgangs den <copy-config>
Junos XML-Protokollvorgang <open-configuration>
ausgestellt hat) oder wenn keine offene Datenbank vorhanden ist, die Daten in der Kandidatenkonfiguration.
Das <source>
Element schließt das <url>
Element um, das den Dateinamen angibt, der die neuen Konfigurationsdaten enthält. Wenn die Konfigurationsdaten als Junos XML-Tagelemente formatiert sind, legen Sie das <url>
format
Attribut auf xml
das Attribut fest oder lassen es aus. Wenn die Konfigurationsdaten als CLI-Konfigurationsanweisungen formatiert werden, legen Sie das <url>
format-Attribut auf text
.
<rpc> <copy-config> <target> <candidate/> </target> <source> <url format="(xml | text)"> <!-- location specifier for file containing the new configuration --> </url> </source> </copy-config> </rpc> ]]>]]>
Ersetzen der Konfiguration mithilfe von <edit-config>
Eine weitere Methode zum Ersetzen der gesamten Kandidatenkonfiguration oder aller Daten in der offenen Konfigurationsdatenbank besteht darin, den <edit-config>
Vorgang zu verwenden und den Konfigurationsbearbeitungsmodus als globale Variable festzulegenreplace
. Die Anwendung enthält das <default-operation>
Tag-Element mit dem Wert replace
im <edit-config>
Tag-Element, wie unter Festlegen des Konfigurationsmodus für die Bearbeitung in einer NETCONF-Sitzung beschrieben. Das <target>
Tag schließt das <candidate/>
Tag um, um anzugeben, dass die neuen Konfigurationsdaten entweder die Daten in der offenen Konfigurationsdatenbank ersetzen (wenn die Clientanwendung vor der Ausführung des Vorgangs den <edit-config>
Junos XML-Protokollvorgang <open-configuration>
ausgestellt hat) oder wenn keine offene Datenbank vorhanden ist, die Daten in der Kandidatenkonfiguration.
Um die neuen Konfigurationsdaten anzugeben, enthält die Anwendung ein Oder ein <config>
Tag-Element, das die Daten enthält, oder sie enthält ein <url>
Tag-Element, das die Datei mit den Daten benennt, wie in Upload and Format Configuration Data in einer NETCONF-Sitzung<config-text>
beschrieben.
<rpc> <edit-config> <target> <candidate/> </target> <default-operation>replace</default-operation> <!-- EITHER --> <config> <configuration> <!-- Junos XML configuration data --> </configuration> </config> <!-- OR --> <config-text> <configuration-text> <!-- configuration data in text format --> </configuration-text> </config-text> <!-- OR --> <url> <!-- location specifier for file containing changes --> </url> </edit-config> </rpc> ]]>]]>
Roll Back zu einer zuvor gebundenen Konfiguration
Geräte mit Junos OS speichern je nach Plattform eine Kopie der zuletzt vorgenommenen Konfiguration und bis zu 49 vorherige Konfigurationen. Sie können zu jeder der gespeicherten Konfigurationen zurückkehren. Dies ist nützlich, wenn Konfigurationsänderungen zu unerwünschten Ergebnissen führen und Sie zu einer bekannten Arbeitskonfiguration zurückkehren möchten. Das Rollback der Konfiguration ähnelt dem Prozess für Konfigurationsänderungen auf dem Gerät, aber anstatt Konfigurationsdaten zu laden, führen Sie ein Rollback durch, bei dem die gesamte Kandidatenkonfiguration durch eine zuvor festgelegte Konfiguration ersetzt wird.
Ab Junos OS Version 18.1R1 kann eine NETCONF-Anwendung den <rollback-config>
RPC ausführen, um entweder die Kandidatenkonfiguration oder alle Daten in der offenen Konfigurationsdatenbank durch eine zuvor festgelegte Konfiguration zu ersetzen. Um die Konfiguration zurück zu setzen, emittiert die Anwendung das <rollback-config>
Element mit dem <index>
untergeordneten Element, das den numerischen Index der vorherigen Konfiguration zum Laden angibt. Gültige Werte sind 0 (Null, für die zuletzt festgelegte Konfiguration) bis eines weniger als die Anzahl der gespeicherten vorherigen Konfigurationen (maximal 49).
NETCONF-Anwendungen können auch den Junos XML-Protokollvorgang <load-configuration>
mit dem rollback
Attribut verwenden, um die Konfiguration zurück zu setzen.
Zum Laden der Konfiguration mit einem Rollback-Index von 1 gibt die Clientanwendung beispielsweise den folgenden RPC aus:
<rpc> <rollback-config> <index>1</index> </rollback-config> </rpc> ]]>]]>
Der NETCONF-Server zeigt an, dass der Load-Vorgang erfolgreich war, indem er die <rollback-config-results>
und-Elemente <ok/>
in seiner RPC-Antwort zurückgibt.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
Wenn der Lastvorgang erfolgreich ist, muss die Clientanwendung die Konfiguration festlegen, um sie zur aktiven Konfiguration auf dem Gerät zu machen. Wenn beim Laden der Rollback-Konfiguration ein Fehler auftritt, gibt er ein <rpc-error>
Element mit Informationen über den Fehler zurück.
Ersetzen der Kandidatenkonfiguration durch die Rescue-Konfiguration
Mit einer Wiederherstellungskonfiguration können Sie eine bekannte Arbeitskonfiguration oder eine Konfiguration mit einem bekannten Zustand definieren, den Sie jederzeit wiederherstellen können. Sie verwenden die Wiederherstellungskonfiguration, wenn Sie zu einer bekannten Konfiguration wiederherstellen müssen, oder als letzter Ausweg, wenn die Gerätekonfiguration und die Backup-Konfigurationsdateien ohne Reparatur beschädigt werden. Wenn Sie eine Wiederherstellungskonfiguration erstellen, speichert das Gerät die zuletzt festgelegte Konfiguration als Wiederherstellungskonfiguration.
Ab Junos OS Version 18.1R1 kann eine NETCONF-Anwendung den <rollback-config>
RPC ausführen, um entweder die Kandidatenkonfiguration oder alle Daten in der offenen Konfigurationsdatenbank durch die Wiederherstellungskonfiguration des Geräts zu ersetzen. Zum Laden der Wiederherstellungskonfiguration gibt die Anwendung das Element und <rescue/>
das <rollback-config>
untergeordnete Tag aus. Die Wiederherstellungskonfiguration muss auf dem Gerät vorhanden sein, bevor Sie sie laden können.
NETCONF-Anwendungen können auch den Junos XML-Protokollvorgang <load-configuration>
mit dem rescue
Attribut verwenden, um die Wiederherstellungskonfiguration zu laden.
Zum Laden der Wiederherstellungskonfiguration gibt die Clientanwendung beispielsweise den folgenden RPC aus:
<rpc> <rollback-config> <rescue/> </rollback-config> </rpc> ]]>]]>
Der NETCONF-Server zeigt an, dass der Load-Vorgang erfolgreich war, indem er die <rollback-config-results>
und-Elemente <ok/>
in seiner RPC-Antwort zurückgibt.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
Wenn der Lastvorgang erfolgreich ist, muss die Clientanwendung die Konfiguration festlegen, um sie zur aktiven Konfiguration auf dem Gerät zu machen. Wenn die Wiederherstellungskonfiguration nicht vorhanden ist oder der Server beim Laden der Konfigurationsdaten auf einen anderen Fehler stößt, gibt er ein <rpc-error>
Element mit Informationen über den Fehler zurück.