Hochladen und Formatieren von Konfigurationsdaten in einer NETCONF-Sitzung
In einer NETCONF-Sitzung mit einem Gerät, auf dem Junos OS ausgeführt wird, kann eine Clientanwendung den Bereitstellungsmechanismus und das Format der Konfigurationsdaten angeben, die bei der Übermittlung von Konfigurationsänderungen an das Gerät verwendet werden. Clientanwendungen können eine Textdatei oder Streaming-Daten verwenden, um Konfigurationsdaten in einem der akzeptierten Formate in die Kandidatenkonfiguration oder offene Konfigurationsdatenbank hochzuladen.
Ein Client kann auswählen, ob Konfigurationsänderungen innerhalb der Sitzung gestreamt werden oder Referenzdatendateien, die die gewünschten Konfigurationsänderungen enthalten. Jede Methode hat Vor- und Nachteile. Streaming-Daten ermöglichen es Ihnen, Ihre Konfigurationsänderungsdaten über Ihre NETCONF-Verbindung in line zu senden. Dies ist nützlich, wenn sich das Gerät hinter einer Firewall befindet und Sie keine weitere Verbindung herstellen können, um eine Datendatei hochzuladen. Mit Textdateien können Sie die Befehle zur Bearbeitung der Konfiguration einfach halten; bei Datendateien ist es nicht erforderlich, den möglicherweise komplexen Konfigurationsdatenstrom einzubeziehen.
<edit-config> Die <copy-config> Betriebsabläufe akzeptieren eines von zwei Formaten für die Junos OS-Konfigurationsdaten: Junos XML- oder CLI-Konfigurationsanweisungen. Die Wahl zwischen einem Datenformat und dem anderen ist die persönliche Präferenz.
Bei der Verwaltung von Geräten, auf denen Junos OS ausgeführt wird, kann eine Clientanwendung den Junos XML-Protokollvorgang <load-configuration> in einer NETCONF-Sitzung verwenden, um zusätzlich zum Junos XML- oder CLI-Anweisungsformat Konfigurationsdaten hochzuladen, die mithilfe von JSON- oder Konfigurationsmodus-Befehlen set formatiert sind.
Der Bereitstellungsmechanismus und das Format werden in den folgenden Abschnitten ausführlich besprochen:
Referenzierung von Konfigurationsdatendateien
Um In einer Datei gespeicherte Konfigurationsdaten hochzuladen, gibt eine Client-Anwendung den Dateispeicherort zwischen den <url> Tags innerhalb des Tags und den <rpc> <edit-config> Tag-Elementen aus <copy-config> .
<rpc> <copy-config> <target> <candidate/> </target> <source> <url> <!-- location and name of file containing configuration data --> </url> </source> </copy-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <url> <!-- location and name of file containing configuration data --> </url> </edit-config> </rpc> ]]>]]>
Die Daten in diesen Dateien können als Junos XML-Elemente oder CLI-Konfigurationsanweisungen formatiert werden. Wenn die Konfigurationsdaten als CLI-Konfigurationsanweisungen formatiert sind, schließen Sie das format="text" Attribut in das <url> Tag ein.
<url format="text">
<!-- location and name of file containing configuration data -->
</url>
Die Konfigurationsdatei kann lokal oder als Netzwerkressource platziert werden.
-
Wenn er lokal platziert wird, kann der Konfigurationsdateipfad relativ oder absolut sein:
-
Relativer Dateipfad: Der Dateispeicherort basiert auf dem Homeverzeichnis des Benutzers.
-
Absoluter Dateipfad: Der Dateispeicherort basiert beispielsweise auf der Verzeichnisstruktur des Geräts <drive>:filename oder /filename, wenn<drive>/:path Sie Wechselmedien verwenden, kann das Laufwerk im FORMAT MS-DOS oder UNIX (UFS) vorliegen.
-
-
Wenn sie sich im Netzwerk befindet, kann auf die Konfigurationsdatei über FTP oder HTTP zugegriffen werden:
-
FTP-Beispiel:
ftp://username:password@hostname/path/filename
Hinweis:Der Standardwert für die FTP-Variable path ist das Homeverzeichnis des Benutzers. Daher ist der Dateipfad zur Konfigurationsdatei standardmäßig relativ zum Benutzerverzeichnis. Um bei Verwendung von FTP einen absoluten Pfad anzugeben, starten Sie den Pfad mit den Zeichen %2F; zum Beispiel: ftp://username:password@hostname/%2Fpath/filename.
-
HTTP-Beispiel:
http://username:password@hostname/path/filename
-
Vor dem Laden der Datei speichert die Clientanwendung oder ein Administrator Junos XML-Tag-Elemente oder CLI-Konfigurationsanweisungen als Inhalt der Datei. Die Datei enthält die Tag-Elemente oder Konfigurationsanweisungen, die alle Ebenen der Konfigurationshierarchie darstellen, vom Stamm (dargestellt durch das <configuration> Tag-Element) bis hin zu jedem zu ändernden Element. Die Notation ist dieselbe wie für die Anforderung von Konfigurationsinformationen. Ausführlichere Informationen zur Junos XML-Darstellung von Junos OS-Konfigurationsanweisungen finden Sie unter Zuordnen von Konfigurationsanweisungen zu Junos XML-Tag-Elementen.
Das folgende Beispiel zeigt, wie Sie Konfigurationsdaten integrieren, die in der Datei /var/tmp/configFile auf dem FTP-Server namens ftp.myco.com gespeichert sind:
Streaming-Konfigurationsdaten
Um Konfigurationsdaten als Datenstrom bereitzustellen, emittiert eine Clientanwendung die <config> <config-text> Oder Tag-Elemente in den <rpc> Und <edit-config> Tag-Elementen. Um die zu ändernden Konfigurationselemente anzugeben, gibt die Anwendung Junos XML- oder CLI-Konfigurationsanweisungen aus, die alle Ebenen der Konfigurationshierarchie darstellen, vom Stamm (dargestellt durch das <configuration> Tag-Element <configuration-text> ) bis hin zu jedem zu ändernden Element. Die Junos XML-Notation ist die gleiche wie für die Anforderung von Konfigurationsinformationen.
<rpc> <edit-config> <target> <candidate/> </target> <config> <configuration> <!-- configuration changes --> </configuration> </config> </edit-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <config-text> <configuration-text> <!-- configuration changes --> </configuration-text> </config-text> </edit-config> </rpc> ]]>]]>
Ausführlichere Informationen zu den Zuordnungen zwischen Junos OS-Konfigurationselementen und Junos XML-Tag-Elementen finden Sie unter Konfigurationsanweisungen zu Junos XML-Tag-Elementen zuordnen. Die Notation der CLI-Konfigurationsaussage wird weiter im CLI-Benutzerhandbuch beschrieben.
Das folgende Beispiel zeigt, wie Junos XML-Konfigurationsdaten in einem Datenstrom bereitgestellt werden, um die Nachrichtensystemprotokolldatei zu konfigurieren:
Formatieren von Daten: Junos XML versus CLI-Konfigurationsanweisungen
NETCONF <copy-config> und <edit-config> Betriebsabläufe akzeptieren eines von zwei Formaten für Junos OS-Konfigurationsdaten: Junos XML- oder CLI-Konfigurationsanweisungen. Die Wahl zwischen einem Datenformat und dem anderen ist die persönliche Präferenz.
Bei der Verwaltung von Geräten, auf denen Junos OS ausgeführt wird, kann eine Clientanwendung den Junos XML-Protokollvorgang <load-configuration> in einer NETCONF-Sitzung verwenden, um zusätzlich zum Junos XML- oder CLI-Anweisungsformat Konfigurationsdaten hochzuladen, die mithilfe von JSON- oder Konfigurationsmodus-Befehlen set formatiert sind.
Wenn Sie die Konfigurationsänderungen in Form von Datendateien bereitstellen, schließen Sie den Namen der Datendatei und den Pfad in Tags ein <url> . Standardmäßig geben diese Tags an, dass die Datendateien, auf die verwiesen wird, Konfigurationsdaten im JUNOS-XML-Format enthalten. Daher erklärt der folgende Code, dass es sich bei den Daten in der Datei um Junos XML-Elemente handelt:
<url>dataFile</url>
Um anzugeben, dass die Datendatei CLI-Konfigurationsanweisungen enthält, schließen Sie das format="text" Attribut in das <url> Tag ein.
<url format="text">dataFile</url>
Beim Datenstreaming geben Sie das Datenformat an, indem Sie einen von zwei Tags auswählen: <config> für Junos XML-Elemente und <config-text> für CLI-Konfigurationsanweisungen.
Im folgenden Beispiel umfasst das <configuration> Element Konfigurationsdaten im JUNOS-XML-Format:
<config>
<configuration>
<system>
<services>
<ssh>
<protocol-version>v2</protocol-version>
</ssh>
</services>
</system>
</configuration>
</config>
Im folgenden Beispiel umfasst das <configuration-text> Element die gleichen Daten, die wie CLI-Konfigurationsanweisungen formatiert sind:
<config-text>
<configuration-text>
system {
services {
ssh {
protocol-version v2;
}
}
}
</configuration-text>
</config-text>