Grundlegendes zu Junos YANG-Modulen

Übersicht über Junos YANG-Module

Juniper Networks stellt YANG-Module bereit, die die Konfigurationshierarchien, Betriebsbefehle und Statusdaten sowie YANG-Erweiterungen und -Typen für Geräte mit Junos OS und Geräte mit Junos OS Evolved definieren. Ab Junos OS Version 17.2 sind die YANG-Module spezifisch für eine Gerätefamilie. Tabelle 1 gibt einen Überblick über die Identifikatoren für die verschiedenen Gerätefamilien und gibt an, welche Plattformen in jeder Produktfamilie enthalten sind. Ab Junos OS Evolved Version 23.4R2 verwenden alle Junos OS Evolved-Plattformen die junos Gerätefamilienkennung.

Ab Junos OS Version 17.4R1 wird das Konfigurations-YANG-Modul in ein Stammmodul aufgeteilt, das durch mehrere kleinere Module ergänzt wird. Darüber hinaus verwenden die nativen Junos YANG-Module eine neue Namenskonvention für den Namen, den Dateinamen und den Namespace des Moduls. Der Modulname und der Dateiname enthalten die Gerätefamilie und den Bereich der Konfigurations- oder Befehlshierarchie, zu dem das Schema im Modul gehört. Der Dateiname des Moduls enthält auch ein Revisionsdatum. Tabelle 2 fasst die nativen YANG-Module auf Junos-Geräten zusammen und gibt die Version an, in der die verschiedenen Modulnamen verwendet werden.

Um YANG-Module für verschiedene Gerätefamilien in verschiedenen Versionen zu unterstützen, sind die heruntergeladenen Module nach Gerätefamilie organisiert, und der Name, der Dateiname und der Namespace jedes Moduls spiegeln die Gerätefamilie wider, zu der das Schema im Modul gehört.

Weitere Informationen zum Abrufen der Module finden Sie unter Herunterladen und Generieren von Junos YANG-Modulen.

Weitere Informationen zu den Modul-Namespaces finden Sie unter Grundlegendes zu Junos YANG-Modul-Namespaces und -Präfixen.

Herunterladen und Generieren von Junos YANG-Modulen

Sie können die YANG-Module Junos OS und Junos OS Evolved wie folgt abrufen:

• Herunterladen der Module von der Juniper Networks-Website unter https://www.juniper.net/support/downloads

• Herunterladen der Module aus dem GitHub-Repository von Juniper/yang

• Generieren der Module auf einem Gerät von Juniper Networks

In Junos OS Version 17.1 und früher definieren die YANG-Module für die Junos OS-Konfigurations- und Befehlshierarchien, die auf der Juniper Networks-Website und in GitHub veröffentlicht werden, das Schema für alle Geräte, auf denen diese Junos OS-Version ausgeführt wird. Im Gegensatz dazu definieren die auf dem lokalen Gerät generierten YANG-Module das für dieses Gerät spezifische Schema. Das gerätespezifische Schema umfasst Knoten sowohl aus nativen Modulen als auch aus Standard- oder benutzerdefinierten Modulen, die dem Gerät hinzugefügt wurden.

Ab Junos OS Version 17.2 sind Junos YANG-Module spezifisch für eine Gerätefamilie, und der Namespace jedes Moduls spiegelt die Gerätefamilie wider, zu der das Schema im Modul gehört. Daher enthalten das Downloadpaket und das GitHub-Repository ein separates Verzeichnis für die Module jeder Gerätefamilie und ein gemeinsames Verzeichnis für die Module, die allen Gerätefamilien gemeinsam sind. Jedes familienspezifische Verzeichnis verwendet seine Gerätefamilienkennung als Verzeichnisnamen und enthält die Konfigurations- und Betriebsbefehlsmodule, die auf den Plattformen dieser Familie unterstützt werden. Die Kennungen der Gerätefamilie sind in Tabelle 1 definiert. Die YANG-Module, die auf einem lokalen Gerät mit Junos OS Version 17.2 generiert werden, definieren weiterhin das für dieses Gerät spezifische Schema.

Ab Junos OS Version 17.4R1 enthalten die auf einem lokalen Gerät generierten YANG-Module standardmäßig familienspezifische Schemas, die auf allen Geräten der jeweiligen Gerätefamilie identisch sind. Um gerätespezifische Module zu generieren, konfigurieren Sie die device-specific Konfigurationsanweisung auf Hierarchieebene [edit system services netconf yang-modules] .

Tabelle 3 fasst den Umfang des Schemas in den heruntergeladenen und generierten YANG-Modulen für verschiedene Junos OS-Versionen zusammen.

Ab Junos OS Evolved Version 23.4R1 veröffentlichen wir die Junos OS Evolved YANG-Module auf der Download-Site von Juniper Networks und auf GitHub. In früheren Versionen mussten Sie die Module auf dem Gerät generieren.

Darüber hinaus stellen wir ab Junos OS Version 23.4R1 und Junos OS Evolved Version 23.4R1 alle YANG-Datenmodelle für ein bestimmtes Betriebssystem und eine bestimmte Version in einem einzigen Downloadpaket und GitHub-Repository-Ordner bereit. Der Paket- und Repository-Ordner enthält:

• Native Konfigurations-, Status- und RPC-Datenmodelle

• OpenConfig-Konfigurations- und Zustandsmodelle, die von diesem Betriebssystem unterstützt werden

• IETF-Modelle, die von diesem Betriebssystem unterstützt werden

Weitere Informationen zum Herunterladen oder Generieren der Junos OS YANG-Module finden Sie unter Verwenden der YANG-Module von Juniper Networks.

Grundlegendes zu Junos YANG-Modul-Namespaces und -Präfixen

In Junos OS Version 17.1 und früher verwenden Junos YANG-Module eine eindeutige Kennung, um den Namespace für jedes Modul zu unterscheiden.

Ab Junos OS Version 17.2R1 sind die Junos YANG-Module spezifisch für eine Gerätefamilie. Um unterschiedliche YANG-Module für verschiedene Gerätefamilien in einer bestimmten Version zu unterstützen, verwenden die YANG-Module einen Namespace, der neben der Kennung auch den Modulnamen, die Gerätefamilie und die Junos OS-Versionszeichenfolge enthält. Zum Beispiel:

Ab Junos OS Version 17.4R1 wird der Namespace vereinfacht und enthält nun die Gerätefamilie, den Modultyp und eine Kennung, die für jedes Modul eindeutig ist und den Namespace des Moduls von dem anderer Module unterscheidet.

Die folgenden Definitionen gelten für alle Versionen des Namespaces, in dem diese Variable angezeigt wird:

In Tabelle 4 sind die Namespace-URI und das Präfix (wie in der prefix Modulanweisung definiert) der einzelnen Module in den verschiedenen Versionen aufgeführt. Ab Junos OS Version 17.2 gibt das Präfix für jedes Betriebsbefehlsmodul den Befehlshierarchiebereich der RPCs an, die in diesem Modul enthalten sind. In ähnlicher Weise spiegelt ab Junos OS Version 17.4R1 das Präfix für jedes Konfigurations-YANG-Modul die Konfigurationsanweisungshierarchie wider, die in diesem Modul enthalten ist. Die Junos YANG-Erweiterungs- und -Typmodule verwenden die junos Gerätefamilien-ID im Namespace, die Module sind jedoch für alle Gerätefamilien gleich.

Ab Junos OS Version 17.2 legt der Server den Standardnamespace für das <configuration> Element auf denselben Namespace wie im entsprechenden YANG-Modell fest, wenn Sie die rfc-compliant Anweisung auf Hierarchieebene [edit system services netconf] konfigurieren und Konfigurationsdaten in einer NETCONF-Sitzung anfordern. Zum Beispiel: