Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<load-configuration>

Verwendung

Beschreibung

Fordern Sie an, dass der NETCONF- oder Junos XML-Protokollserver Konfigurationsdaten in die Kandidatenkonfigurations- oder offene Konfigurationsdatenbank lädt.

Wenn eine Clientanwendung den Junos XML-Protokollvorgang <open-configuration> ausgibt, um eine bestimmte Konfigurationsdatenbank zu öffnen, bevor der Vorgang ausgeführt wird, lädt der <load-configuration> Server die Konfigurationsdaten in die geöffnete Konfigurationsdatenbank. Andernfalls lädt der Server die Konfigurationsdaten in die Kandidatenkonfiguration.

Geben Sie die zu ladenden Daten auf eine der folgenden Arten an:

  • Setzen Sie das Attribut des leeren <load-configuration/> configuration-revision Tags auf die Konfigurationsrevisions-ID einer zuvor festgeschriebenen Konfiguration. Die angegebene Konfiguration ersetzt die Kandidatenkonfiguration vollständig.

  • Setzen Sie das Attribut des leeren <load-configuration/> rescue Tags auf den Wert rescue. Die Rescue-Konfiguration ersetzt die Kandidatenkonfiguration vollständig.

  • Legen Sie das Attribut des leeren <load-configuration/> rollback Tags auf den Rollback-Index einer zuvor festgeschriebenen Konfiguration fest. Auf dem Gerät werden eine Kopie der zuletzt festgeschriebenen Konfiguration und bis zu 49 vorherige Konfigurationen gespeichert. Die angegebene Konfiguration ersetzt die Kandidatenkonfiguration vollständig.

  • Setzen Sie das Attribut des leeren <load-configuration/> url Tags auf den Pfadnamen einer Datei, die die zu ladenden Konfigurationsdaten enthält. Legen Sie das format Attribut auf json, textoder zum Laden einer Konfiguration im entsprechenden JSON-Format (JavaScript Object Notation), formatiertem ASCII-Text oder xml Junos XML-Tag-Elementen (Standardeinstellung) fest. Um die Konfigurationsdaten als Konfigurationsmodusbefehle bereitzustellen, schließen Sie das Attribut ein und lassen Sie das action="set" format Attribut entweder weg oder legen Sie den Wert auf textfest.

    Im folgenden Beispiel gibt das url Attribut an, dass die Konfigurationsdaten aus der Datei / tmp/add.conf geladen werden sollen.

  • Schließen Sie die Konfigurationsdaten als Datenstrom in ein öffnendes und schließendes <load-configuration> </load-configuration> Tag ein. Wenn Sie die Konfigurationsdaten als formatierten ASCII-Text bereitstellen, schließen Sie die Daten in ein <configuration-text> Tag-Element ein, und legen Sie das format Attribut auf textfest. Wenn Sie die Konfigurationsdaten als Junos XML-Tag-Elemente bereitstellen, schließen Sie die Daten in ein <configuration> Tag-Element ein und lassen Sie das format Attribut entweder weg oder legen Sie den Wert auf xmlfest. Wenn Sie die Konfigurationsdaten als Konfigurationsmodusbefehle bereitstellen, schließen Sie die Daten in ein <configuration-set> Tag-Element ein, legen Sie das Attribut auf fest, und lassen Sie das format action Attribut entweder weg oder legen Sie den Wert auf settextfest. Wenn Sie die Konfigurationsdaten in JSON bereitstellen, schließen Sie die Daten in ein Tag-Element ein<configuration-json>, und legen Sie das format Attribut auf jsonfest.

Attribute

action

Geben Sie an, wie die Konfigurationsdaten geladen werden sollen, insbesondere wenn die Zielkonfigurationsdatenbank und die geladene Konfiguration widersprüchliche Anweisungen enthalten.

Die kurzlebige Konfigurationsdatenbank unterstützt die folgenden action Attributwerte auf unterstützten Geräten in den angegebenen Versionen:

  • merge und – unterstützt in Junos OS Version 16.2R2 und sethöher

  • override und – unterstützt in Junos OS Version 18.1R1 und replacehöher

  • update– unterstützt in Junos OS Version 21.1R1 und höher

Die folgenden Werte sind zulässig:

  • merge: Kombinieren Sie die Daten in der geladenen Konfiguration mit den Daten in der Zielkonfiguration. Wenn Anweisungen in der geladenen Konfiguration mit Anweisungen in der Zielkonfiguration in Konflikt stehen, ersetzen die geladenen Anweisungen die Anweisungen in der Zielkonfiguration. Dies ist das Standardverhalten, wenn das action Attribut weggelassen wird.

  • override– Verwerfen Sie die gesamte Kandidatenkonfiguration und ersetzen Sie sie durch die geladene Konfiguration. Wenn die Konfiguration später festgeschrieben wird, analysieren alle Systemprozesse die neue Konfiguration.

  • replace– Ersetzen Sie jede Hierarchieebene oder jedes Konfigurationsobjekt, das in der geladenen Konfiguration definiert ist, durch die entsprechende Ebene oder jedes Objekt in der Kandidatenkonfiguration.

    Wenn Sie die Konfigurationsdaten als formatierten ASCII-Text bereitstellen (entweder in der Datei, die durch das url Attribut benannt oder in ein <configuration-text> Tag-Element eingeschlossen ist), platzieren Sie die Anweisung auch in der Zeile direkt vor den Anweisungen, die die replace: zu ersetzende Hierarchieebene oder das zu ersetzende Objekt darstellen. Weitere Informationen finden Sie in der Erläuterung zum Laden einer Datei mit Konfigurationsdaten im CLI-Benutzerhandbuch.

    Wenn Sie die Konfigurationsdaten als Junos XML-Tag-Elemente bereitstellen, fügen Sie das replace="replace" Attribut in die öffnenden Tags der Elemente ein, die die zu ersetzenden Hierarchieebenen oder Objekte darstellen.

  • set– Laden Sie Konfigurationsdaten, die als Befehle für den Junos OS-Konfigurationsmodus formatiert sind. Diese Option führt die Konfigurationsanweisungen Zeile für Zeile aus, wie sie in einer Datei gespeichert sind, die nach dem url Attribut benannt oder in ein <configuration-set> Tag-Element eingeschlossen ist. Die Anweisungen können beliebige Konfigurationsmodusbefehle enthalten, z. Bset. , , deleteeditoder deactivate. Wenn Sie die Konfigurationsdaten als eine Reihe von Befehlen bereitstellen, ist der einzige akzeptable Wert für das format Attribut "text". Wenn der action Attributwert "set" ist und das Attribut weggelassen wird, wird das format format Attribut automatisch standardmäßig auf "text" und nicht xmlauf ".

  • update: Vergleichen Sie eine vollständig geladene Konfiguration mit der Kandidatenkonfiguration. Für jede Hierarchieebene oder jedes Konfigurationsobjekt, das sich in den beiden Konfigurationen unterscheidet, ersetzt die Version in der geladenen Konfiguration die Version in der Kandidatenkonfiguration. Wenn die Konfiguration später festgeschrieben wird, analysieren nur Systemprozesse, die von den geänderten Konfigurationselementen betroffen sind, die neue Konfiguration.

configuration-revision

Laden Sie eine zuvor festgeschriebene Konfiguration, indem Sie auf ihre Konfigurationsrevisions-ID verweisen. Die angegebene Konfiguration ersetzt die Kandidatenkonfiguration vollständig.

format

Geben Sie das Format an, das für die Konfigurationsdaten verwendet wird. Zulässige Werte sind:

  • json–Geben Sie an, dass die Konfigurationsdaten mit JavaScript Object Notation (JSON) formatiert sind.

  • text: Gibt an, dass die Konfigurationsdaten als ASCII-Text oder als eine Reihe von Befehlen für den Konfigurationsmodus formatiert sind.

    Das ASCII-Textformat verwendet das Zeilenumbruchzeichen, Tabulatoren und andere Leerzeichen, geschweifte Klammern und eckige Klammern, um die hierarchischen Beziehungen zwischen den Anweisungen anzugeben. Dies ist das Format, das in Konfigurationsdateien verwendet wird, die auf der Routing-Plattform gespeichert sind, und ist das Format, das vom CLI-Befehl show configuration angezeigt wird. Das set Befehlsformat besteht aus einer Reihe von Befehlen für den Junos OS-Konfigurationsmodus und wird durch den show configuration | display set CLI-Befehl angezeigt. Um eine Reihe von Befehlen für den Konfigurationsmodus zu laden, müssen Sie das action Attribut auf "set" setzen.

  • xml– Geben Sie an, dass die Konfigurationsdaten mit Junos XML-Tag-Elementen formatiert sind. Wenn das Attribut weggelassen wird, ist "xml" das Standardformat für alle Werte des action Attributs mit Ausnahme von "set", das format standardmäßig das Format "text" hat.

rescue

Geben Sie an, dass die Rettungskonfiguration die aktuelle Kandidatenkonfiguration ersetzen soll. Der einzige gültige Wert ist "rescue".

Hinweis:

Ab Junos OS Version 18.1R1 können Sie den RPC auch verwenden <rollback-config> , um eine zuvor festgeschriebene Konfiguration zu laden, was für Anwendungen nützlich ist, die die Ausführung von RPCs mit XML-Attributen nicht unterstützen.

rollback

Laden Sie eine zuvor festgeschriebene Konfiguration, indem Sie auf ihren numerischen Rollback-Index verweisen. Gültige Werte sind 0 (Null für die Konfiguration mit dem letzten Commit) bis eins kleiner als die Anzahl der gespeicherten vorherigen Konfigurationen (maximal ist 49).

Hinweis:

Ab Junos OS Version 18.1R1 können Sie den RPC auch verwenden <rollback-config> , um eine zuvor festgeschriebene Konfiguration zu laden, was für Anwendungen nützlich ist, die die Ausführung von RPCs mit XML-Attributen nicht unterstützen.

url

Geben Sie den vollständigen Pfadnamen der Datei an, die die zu ladenden Konfigurationsdaten enthält. Der Wert kann ein lokaler Dateipfad, ein FTP-Speicherort oder eine HTTP-URL (Hypertext Transfer Protocol) sein:

  • Ein lokaler Dateiname kann eine der folgenden Formen haben:

    • //pathfilenameDatei auf einem bereitgestellten Dateisystem, entweder auf der lokalen Flash-Disk oder auf der Festplatte.

    • Eine:filename oder a:/filename:path Datei auf dem lokalen Laufwerk. Der Standardpfad ist / (das Verzeichnis auf Stammebene). Die Wechselmedien können im MS-DOS- oder UNIX-Format (UFS) vorliegen.

  • Ein Dateiname auf einem FTP-Server hat die folgende Form:

  • Ein Dateiname auf einem HTTP-Server hat die folgende Form:

In jedem Fall ist der Standardwert für die Variable path das Home-Verzeichnis für den Benutzernamen. Um einen absoluten Pfad anzugeben, beginnt die Anwendung den Pfad mit den Zeichen %2F; Beispiel: ftp://username:password@hostname/%2Fpath/filename.

Informationen zur Veröffentlichung

Hierbei handelt es sich um einen Vorgang des Junos XML-Verwaltungsprotokolls. Sie wird in Junos XML-Protokollsitzungen und als proprietäre Erweiterung von Juniper Networks in NETCONF-Sitzungen auf Geräten mit Junos OS unterstützt, die den URI http://xml.juniper.net/netconf/junos/1.0 im Funktionsaustausch identifizieren.

action Attributwert, set der in Junos OS Version 11.4 hinzugefügt wurde.

format Attributwert, json der in Junos OS Version 16.1 hinzugefügt wurde.

configuration-revision Attribut in Junos OS Version 20.4R1 und Junos OS Evolved Version 20.4R1 hinzugefügt.