Grundlegendes zu den YANG-Modulen, die die Junos OS-Konfiguration definieren
Juniper Networks veröffentlicht das Junos OS-Konfigurationsschema mithilfe von YANG-Modellen. In Junos OS Version 17.3 und früher wird das Junos OS-Konfigurationsschema in einem einzigen YANG-Modul veröffentlicht. Ab Junos OS Version 17.4R1 wird das Junos OS-Konfigurationsschema mithilfe eines Root-Konfigurationsmoduls veröffentlicht, das durch mehrere, kleinere Module ergänzt wird. Auf diese Weise können Benutzer des Schemas nur die module importieren, die für ihre Aufgaben erforderlich sind.
Ab Junos OS Version 17.4R1 verwenden junos OS YANG-Module eine neue Namenskonvention für den Namen, den Dateinamen und den Namespace des Moduls. Weitere Informationen finden Sie unter Grundlegendes zu Junos YANG-Modulen.
Das Root-Konfigurationsmodul umfasst den Konfigurationsknoten der obersten Ebene und alle Knoten, die nicht als separate Module ausgegeben werden. Separate, kleinere Module ergänzen das Root-Konfigurationsmodul für die verschiedenen Konfigurationsaussagenhierarchien. Die Konfigurationsmodule, die das Root-Modul ergänzen, enthalten das Schema für die Hierarchieebene der Konfigurationsanweisung, das im Namen, Dateinamen und Namespace des Moduls angegeben ist.
Das folgende Beispiel zeigt einen Teil des Moduls, der das YANG-Modell für die [edit interfaces] Hierarchie enthält:
/*
* Copyright (c) 2017 Juniper Networks, Inc.
* All rights reserved.
*/
module junos-conf-interfaces {
namespace "http://yang.juniper.net/junos/conf/interfaces";
prefix jc-interfaces;
import junos-common-types {
prefix jt;
}
import junos-conf-root {
prefix jc;
}
organization "Juniper Networks, Inc.";
contact "yang-support@juniper.net";
description "Junos interfaces configuration module";
revision 2017-01-01 {
description "Junos: 17.4R1.17";
}
augment /jc:configuration {
uses interfaces-group;
}
augment /jc:configuration/jc:groups {
uses interfaces-group;
}
...
YANG-Versorgungsunternehmen müssen nur die Module importieren, die für die jeweilige Konfigurationsaufgabe erforderlich sind. Infolgedessen benötigen Tools, die die Konfigurationsmodule nutzen, weniger Zeit für die Kompilierung, Validierung oder Ausführung anderer Funktionen auf den Modulen als beim Importieren eines einzelnen, großen Moduls.
Um das YANG-Modul der Konfiguration zu einem bestimmten Bereich der Konfiguration zu bestimmen, erteilen Sie den show | display detail Konfigurationsmodus-Befehl. Im folgenden Beispiel ist das Schema für die [edit protocols ospf] Hierarchieebene im Modul junos-conf-protocols@2017-01-01.yang enthalten.
user@host# show protocols ospf | display detail ## ## ospf: OSPF configuration ## YANG module: junos-conf-protocols@2017-01-01.yang ## lsa-refresh-interval: LSA refresh interval (minutes) ## range: 25 .. 50 ## ## default: 50 ## ...
Sie können die Junos OS YANG-Module von der Download-Website von Juniper Networks oder dem GitHub-Repository von Juniper Networks für YANG herunterladen, oder Sie können die Module auf dem lokalen Gerät generieren. Um die Konfigurationsmodule auf dem lokalen Gerät zu generieren, erteilen Sie den show system schema format yang module module Befehl. Die Junos OS-Version bestimmt die verfügbaren Befehlsoptionen.
-
Geben Sie in Junos OS Version 17.3 und früher das Modul an
configuration.user@host> show system schema format yang module configuration
-
Geben Sie in Junos OS Version 17.4 und höher einen einzelnen Modulnamen an, um ein einzelnes Konfigurationsmodul zurückzugeben, oder geben Sie an
all-conf, dass alle Konfigurationsmodule zurückgegeben werden sollen.user@host> show system schema format yang module all-conf output-directory /var/tmp/yang
Ab Junos OS Version 19.1R2 und 19.2R1 muss der Befehl die
show system schemaoutput-directoryBefehlsoption enthalten und das Verzeichnis angeben, in dem die Datei oder Dateien generiert werden sollen. In früheren Versionen können Sie dieoutput-directoryOption auslassen, wenn Sie ein einzelnes Modul zur Anzeige des Moduls in der Standardausgabe anfordern.
Um die Module aus einer Remotesitzung zu generieren, führen Sie den <get-yang-schema> Junos OS RPC- oder NETCONF-Vorgang <get-schema> (Network Configuration Protocol) mit den entsprechenden Optionen aus.
Wenn Sie oder module all-confangebenmodule configuration, enthalten die Ausgabedateien sowohl native Junos OS-Konfigurationsmodule als auch alle Standard- oder benutzerdefinierten Konfigurationsmodule, die dem Gerät hinzugefügt wurden.
Ab Junos OS Version 17.4R1 enthalten die auf einem lokalen Gerät generierten nativen YANG-Module familienspezifische Schemata, die auf allen Geräten in der jeweiligen Gerätefamilie identisch sind. In früheren Versionen enthalten die generierten Module gerätespezifische Schemata. Um gerätespezifische Module in Junos OS Version 17.4R1 und höher zu generieren, konfigurieren Sie die device-specific Konfigurationsaussage auf [edit system services netconf yang-modules] Hierarchieebene.
show system schema
output-directory Befehlsoption enthalten und das Verzeichnis angeben, in dem die Datei oder Dateien generiert werden sollen.