Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Verwaltung von YANG-Paketen, Modulen und Skripten auf Junos-Geräten

ZUSAMMENFASSUNG Laden Sie benutzerdefinierte YANG-Pakete auf Junos-Geräten, um dem Gerät Ihre eigenen Remote Procedure Calls (RPCs) und Datenmodelle hinzuzufügen.

Sie können benutzerdefinierte YANG-Module auf Junos-Geräten laden, um RPCs und Datenmodelle hinzuzufügen, die nicht nativ vom Betriebssystem unterstützt werden, aber durch Übersetzung unterstützt werden können. Wenn Sie nichtnative YANG-Datenmodelle auf das Gerät laden, müssen Sie auch alle Übersetzungsskripte, Aktionsskripte und Abweichungenmodule laden, die für diese Datenmodelle erforderlich sind.

Hinweis:

Ab Junos OS Version 17.3R1 müssen Sie beim Laden benutzerdefinierter YANG-Datenmodelle auf das Gerät keine erforderlichen Junos OS-Erweiterungsmodule explizit laden. In früheren Versionen müssen Sie die Junos OS-Erweiterungsmodule für alle Pakete laden, die die Module verwenden.

Junos-Geräte verwenden Pakete, um eine Sammlung verwandter YANG-Module, Übersetzungsskripte und Aktionsskripte zu identifizieren. Jedes Paket hat eine eindeutige Kennung. Wenn Sie dem Gerät YANG-Module und -Skripte hinzufügen, müssen Sie diese einem neuen oder vorhandenen Paket zuordnen. In diesem Thema wird das Erstellen, Aktualisieren und Löschen von YANG-Paketen sowie das Hinzufügen oder Aktualisieren der zugehörigen Module und Skripte erläutert.

Hinweis:

Um CLI-bezogene Oder Konfigurationsdatenbankfehler zu vermeiden, empfehlen wir, dass Sie keine CLI-Vorgänge durchführen, die Konfiguration ändern oder den Vorgang beenden, während ein Gerät gerade ein YANG-Paket hinzufügen, aktualisieren oder löschen und das Schema ändert.

Erstellen eines YANG-Pakets und Hinzufügen von Modulen und Skripten

So validieren Sie YANG-Module und -Skripte und fügen sie einem neuen Paket hinzu:

  1. Laden Sie die YANG-Module und alle erforderlichen Skripte in ein beliebiges Verzeichnis auf dem Gerät herunter.
  2. Stellen Sie sicher, dass alle nicht signierten Python-Aktionsskripte entweder root oder einem Benutzer in der Junos OS-Anmeldeklasse super-user gehören und dass nur der Dateibesitzer schreibberechtigungen für die Datei hat.
    Hinweis:

    Benutzer können nicht signierte Python-Skripte nur auf Junos-Geräten ausführen, wenn die Dateiberechtigungen des Skripts Leseberechtigungen für die erste Klasse enthalten, in der der Benutzer in der Reihenfolge von Benutzer, Gruppe oder anderen gehört.

  3. (Optional) Validieren Sie die Syntax der Module und Skripte.
  4. Erstellen Sie ein YANG-Paket mit einer eindeutigen Kennung, und geben Sie die Dateipfade für die Module und Skripte, die Teil dieses Pakets sind, sowie für alle Abweichungenmodule, die Abweichungen für die Module in diesem Paket identifizieren.
    Hinweis:

    Sie können den absoluten oder relativen Pfad zu einer einzelnen Datei angeben, oder Sie können mehrere Dateien hinzufügen, indem Sie eine durch Leerzeichen getrennte Liste von Dateipfaden angeben, die in Klammern eingeschlossen sind.

    Hinweis:

    Verwenden Sie den request system software add Befehl, um OpenConfig-Module zu installieren, die als komprimierte TAR-Datei gepackt werden. OpenConfig-Module und -Skripte, die durch Ausgabe des request system software add Befehls installiert werden, sind immer mit der Paketkennung openconfigverknüpft.

    Hinweis:

    Ab Junos OS Version 18.3R1 wird das Hinzufügen, Löschen oder Aktualisieren von YANG-Paketen im Konfigurationsmodus mit dem run Befehl nicht unterstützt.

  5. Wenn Sie vom System aufgefordert werden, junos OS CLI neu zu starten, drücken Enter Sie, um den Standardwert von yes.
  6. Stellen Sie sicher, dass das Paket erstellt wurde und die richtigen Module und Skripte enthält.
  7. Wenn das Paket Übersetzungsskripte oder Aktionsskripte enthält, die in Python geschrieben wurden, aktivieren Sie das Gerät, nichtsignierte Python-Skripte auszuführen, indem Sie die language python language python3 oder Anweisung konfigurieren, die für die Junos OS-Version geeignet ist.
    Hinweis:

    Ab Junos OS Version 20.2R1 und Junos OS Evolved Version 22.3R1 verwendet das Gerät Python 3, um YANG-Aktions- und Übersetzungsskripte auszuführen. In früheren Versionen verwendet Junos OS nur Python 2.7, um diese Skripte auszuführen, und Junos OS Evolved verwendet standardmäßig Python 2.7, um die Skripte auszuführen.

  8. Wiederholen Sie in Multi-Chassis-Systemen die Schritte 1 bis 7 an jedem Knoten im System.

Wenn Sie ein neues Paket erstellen, speichert das Gerät Kopien des Moduls und Skriptdateien an einem neuen Speicherort. Das Gerät speichert auch Kopien des Aktionsskripts und der Übersetzungsskriptdateien unter den Verzeichnissen /var/db/scripts/action bzw. /var/db/scripts/translation . Nachdem die Module und Skripte validiert und dem Gerät hinzugefügt wurden, erstellt Junos OS sein Schema neu, um die neuen Datenmodelle einzubeziehen, und validiert dann die aktive Konfiguration anhand dieses Schemas. Neu hinzugefügte RPCs und Konfigurationshierarchien stehen sofort zur Verfügung.

Hinweis:

Geräte, die die kurzlebige Konfigurationsdatenbank verwenden, löschen bei der Wiederherstellung des Schemas alle kurzlebigen Konfigurationsdaten.

Hinweis:

Junos OS unterstützt die Verwendung des configure private Modus zur Konfiguration von Anweisungen, die zu YANG-Datenmodellen von Drittanbietern, z. B. OpenConfig oder benutzerdefinierten YANG-Datenmodellen, entsprechen.

Aktualisieren eines YANG-Pakets mit neuen oder modifizierten Modulen und Skripten

Sie erstellen ein neues YANG-Paket, indem Sie den request system yang add Befehl ausführen. Um ein vorhandenes Paket zu aktualisieren, um dem Paket entweder neue Module und Skripte hinzuzufügen oder vorhandene Module und Skripte im Paket zu aktualisieren, müssen Sie den request system yang update Befehl verwenden.

So aktualisieren Sie ein YANG-Paket mit neuen oder geänderten Modulen und Skripten:

  1. Laden Sie die Module und Skripte in ein beliebiges Verzeichnis auf dem Gerät herunter.
  2. Stellen Sie sicher, dass alle nicht signierten Python-Aktionsskripte entweder root oder einem Benutzer in der Junos OS-Anmeldeklasse super-user gehören und dass nur der Dateibesitzer schreibberechtigungen für die Datei hat.
    Hinweis:

    Benutzer können nicht signierte Python-Skripte nur auf Junos-Geräten ausführen, wenn die Dateiberechtigungen des Skripts Leseberechtigungen für die erste Klasse enthalten, in der der Benutzer in der Reihenfolge von Benutzer, Gruppe oder anderen gehört.

  3. (Optional) Validieren Sie die Syntax der Module und Skripte.
  4. Aktualisieren Sie das YANG-Paket durch Ausgabe des request system yang update Befehls, und geben Sie die Dateipfade für die neuen und geänderten Module und Skripte an.
    Hinweis:

    Sie können den absoluten oder relativen Pfad zu einer einzelnen Datei angeben oder mehrere Dateien aktualisieren, indem Sie eine durch Leerzeichen getrennte Liste von Dateipfaden angeben, die in Klammern eingeschlossen sind.

    Hinweis:

    Ab Junos OS Version 18.3R1 wird das Hinzufügen, Löschen oder Aktualisieren von YANG-Paketen im Konfigurationsmodus mit dem run Befehl nicht unterstützt.

  5. Wenn Sie vom System aufgefordert werden, junos OS CLI neu zu starten, drücken Enter Sie, um den Standardwert von yes.
  6. Wenn das Paket Übersetzungsskripte oder Aktionsskripte enthält, die in Python geschrieben wurden, aktivieren Sie das Gerät, unsignierte Python-Skripte auszuführen, indem Sie die language python language python3 oder Anweisung konfigurieren, die für die Junos OS-Version geeignet ist, wenn sie nicht bereits konfiguriert ist.
    Hinweis:

    Ab Junos OS Version 20.2R1 und Junos OS Evolved Version 22.3R1 verwendet das Gerät Python 3, um YANG-Aktions- und Übersetzungsskripte auszuführen. In früheren Versionen verwendet Junos OS nur Python 2.7, um diese Skripte auszuführen, und Junos OS Evolved verwendet standardmäßig Python 2.7, um die Skripte auszuführen.

  7. Wiederholen Sie auf Multi-Chassis-Systemen die Schritte 1 bis 6 an jedem Knoten im System.

Wenn Sie ein Paket aktualisieren, speichert das Gerät Kopien des neuen und geänderten Moduls sowie Skriptdateien. Junos OS erstellt dann sein Schema neu, um alle Änderungen an den Datenmodellen einzubeziehen, die mit diesem Paket verknüpft sind, und validiert die aktive Konfiguration anhand dieses Schemas.

Hinweis:

Geräte, die die kurzlebige Konfigurationsdatenbank verwenden, löschen bei der Wiederherstellung des Schemas alle kurzlebigen Konfigurationsdaten.

Löschen eines YANG-Pakets

VORSICHT:

Bevor Sie ein YANG-Paket von einem Junos-Gerät löschen, stellen Sie sicher, dass die aktive Konfiguration keine Konfigurationsdaten enthält, die abhängigkeiten von den Datenmodellen sind, die von diesem Paket hinzugefügt wurden.

So löschen Sie ein YANG-Paket und alle Module und Skripte, die diesem Paket zugeordnet sind, von einem Junos-Gerät:

  1. Überprüfen Sie die aktive Konfiguration, um festzustellen, ob Abhängigkeiten von den YANG-Modulen bestehen, die gelöscht werden.
  2. Wenn die Konfiguration Abhängigkeiten von den Modulen enthält, aktualisieren Sie die Konfiguration, um die Abhängigkeiten zu entfernen.
  3. Löschen Sie das Paket und die zugehörigen Module und Skripte, indem Sie den request system yang delete Befehl mit der entsprechenden Paketkennung ausstellen.
    Hinweis:

    Sie müssen den request system software delete Befehl verwenden, um installierte OpenConfig-Pakete aus einer komprimierten TAR-Datei zu entfernen, indem Sie den request system software add Befehl ausstellen.

    Hinweis:

    Ab Junos OS Version 18.3R1 wird das Hinzufügen, Löschen oder Aktualisieren von YANG-Paketen im Konfigurationsmodus mit dem run Befehl nicht unterstützt.

  4. Wenn Sie vom System aufgefordert werden, junos OS CLI neu zu starten, drücken Enter Sie, um den Standardwert von yes.

Wenn Sie ein Paket löschen, erstellt Junos OS sein Schema neu, um die diesem Paket zugeordneten Datenmodelle zu entfernen, und validiert dann die aktive Konfiguration anhand dieses Schemas. Das Gerät entfernt die Kopien des Moduls und die Skriptdateien, die beim Erstellen des Pakets generiert wurden. Das Gerät entfernt auch die Kopien der Aktionsskript- und Übersetzungsskriptdateien des Pakets, die in den Verzeichnissen /var/db/scripts/action und /var/db/scripts/translation gespeichert sind. Wenn Sie das originale Modul und die Skriptdateien an einen anderen Speicherort heruntergeladen haben, bleiben die Originaldateien unverändert.

Hinweis:

Geräte, die die kurzlebige Konfigurationsdatenbank verwenden, löschen bei der Wiederherstellung des Schemas alle kurzlebigen Konfigurationsdaten.

Tabelle "Versionshistorie"
Release
Beschreibung
22.3R1-EVO
Ab Junos OS Evolved Version 22.3R1 verwendet Junos OS Evolved Python 3, um YANG-Aktions- und Übersetzungsskripte auszuführen.
20.2R1
Ab Junos OS Version 20.2R1 verwendet Junos OS Python 3, um YANG-Aktions- und Übersetzungsskripte auszuführen. In früheren Versionen verwendet Junos OS Python 2.7, um diese Skripte auszuführen.
18.3R1
Ab Junos OS Version 18.3R1 wird das Hinzufügen, Löschen oder Aktualisieren von YANG-Paketen im Konfigurationsmodus mit dem run Befehl nicht unterstützt.
17.3R1
Ab Junos OS Version 17.3R1 müssen Sie beim Laden benutzerdefinierter YANG-Datenmodelle auf das Gerät keine erforderlichen Junos OS-Erweiterungsmodule explizit laden.