Verwenden von Junos PyEZ zum Installieren von Software auf Junos-Geräten

Wenn Sie Junos PyEZ verwenden, um Software auf Junos-Geräten zu installieren, können Sie das Software-Image auf den Konfigurationsmanagement-Server herunterladen, und die install() Methode kopiert es standardmäßig auf das Zielgerät, bevor Sie die Installation durchführen. Sie können die install() Methode auch anweisen, ein Image zu installieren, das sich bereits auf dem Zielgerät oder unter einer URL befindet, die vom Zielgerät aus erreichbar ist.

In Tabelle 1 sind die Methodenparameter aufgeführt, die install() Sie je nach Speicherort des Softwarepakets festlegen müssen. Sie müssen immer entweder den package or pkg_set -Parameter in den install() Methodenaufruf einschließen.

Tabelle 1: Parametereinstellungen für die install()-Methode für den Speicherort des Softwarepakets

Speicherort des Softwarepakets	no_copy Parameter	package oder pkg_set Parameter	remote_path Parameter
Konfigurationsverwaltungsserver	Weglassen oder setzen auf False	Dateipfad einschließlich des Dateinamens des Softwarepakets oder der Pakete auf dem lokalen Server, auf dem Junos PyEZ ausgeführt wird.	(Optional) Pfad zu dem Verzeichnis auf dem Zielgerät, in das das Paket oder die Pakete kopiert werden. Der Standardwert ist /var/tmp.
Zielgerät	Setzen Sie auf True	Dateiname des Softwarepakets oder der Softwarepakete.	(Optional) Pfad zu dem Verzeichnis auf dem Zielgerät, in dem sich das Paket oder die Pakete bereits befinden müssen. Der Standardwert ist /var/tmp.
Weblinks	–	URL aus der Perspektive des Junos-Zielgeräts, von dem aus das Softwarepaket installiert wird.	–

Das package Argument wird verwendet, um Software auf einem einzelnen Junos-Gerät oder auf Bauteilen in einem nicht gemischten Virtual Chassis zu installieren. Das package Argument ist eine Zeichenfolge, die ein einzelnes Softwareabbild angibt. Zum Beispiel:

Das pkg_set Argument wird verwendet, um Software auf den Bauteilen in einem gemischten virtuellen Chassis zu installieren. Sie enthält eine Liste oder ein Tupel von Zeichenfolgen, die die erforderlichen Software-Images in beliebiger Reihenfolge für die verschiedenen Virtual Chassis-Member angeben. Zum Beispiel:

Bei Paketen, die sich auf dem lokalen Server befinden, auf dem Junos PyEZ ausgeführt wird, kopiert der Server das angegebene Softwarepaket auf das Gerät, wenn Sie das no_copy Argument weglassen oder auf Falsefestlegen. Das Einschließen des package Arguments bewirkt, dass der Server das Paket auf das Zielgerät kopiert (einzelnes Gerät oder primärer Router oder Switch in einem nicht gemischten Virtual Chassis), und das Einschließen des pkg_set Arguments bewirkt, dass der Server alle Pakete in der Liste auf den primären Router oder Switch in einem gemischten Virtual Chassis kopiert. Standardmäßig werden Software-Images im Verzeichnis /var/tmp abgelegt, es sei denn, das Argument remote_path gibt ein anderes Verzeichnis an.

Wenn Sie das no_copy Argument auf True festlegen, müssen die erforderlichen Softwarepakete bereits auf dem Zielgerät oder dem primären Virtual Chassis-Gerät vorhanden sein, bevor die Installation beginnt. Die Pakete müssen sich entweder in dem durch das remote_path Argument angegebenen Verzeichnis oder, falls remote_path es weggelassen wird, im Standardverzeichnis /var/tmp befinden.

Junos PyEZ unterstützt auch die Installation von Software-Images über eine URL. In diesem Fall muss der package Wert "oder pkg_set " eine URL aus der Perspektive des Junos-Zielgeräts sein. Das Paket wird von der angegebenen URL kopiert und installiert, und die no-copy Argumente und remote_path werden ignoriert. Weitere Informationen zum Angeben des URL-Formats finden Sie unter Format zum Angeben von Dateinamen und URLs in Junos OS CLI-Befehlen.

Um ein Software-Image auf einem Junos-Gerät zu installieren, stellt eine Junos PyEZ-Anwendung eine Verbindung mit dem einzelnen Gerät oder dem primären Gerät in einem Virtual Chassis her, erstellt eine Instanz des SW Dienstprogramms und ruft die install() Methode mit allen erforderlichen oder optionalen Argumenten auf. Zum Beispiel:

Die aktuelle Liste der install() Methodenparameter finden Sie unter install().

Wenn sich das Softwarepaket auf dem Konfigurationsverwaltungsserver befindet und der no_copy Parameter weggelassen oder auf False festgelegt ist, führt die install() Methode vor der Installation der Software die folgenden Vorgänge aus:

• Berechnet die Prüfsumme des lokalen Softwarepakets bzw. der lokalen Softwarepakete mit dem im checksum_algorithm Argument angegebenen Algorithmus, wenn die Prüfsumme nicht bereits über das checksum Argument bereitgestellt wird. Zulässige checksum_algorithm Werte sind "md5", "sha1"und "sha256". Der Standardwert ist "md5".

• Führt eine Speicherbereinigung auf dem Zielgerät durch, um Speicherplatz für das Softwarepaket zu schaffen, es sei denn cleanfs , es ist auf Falsefestgelegt.

• SCP oder FTP kopiert das Paket in das remote_path Verzeichnis oder, falls remote_path nicht angegeben, in das Verzeichnis /var/tmp , wenn sich nicht bereits eine Datei mit demselben Namen und derselben Prüfsumme am Zielspeicherort auf dem Gerät befindet.

• Berechnet die Prüfsumme der Remotedatei und vergleicht sie mit dem Wert der lokalen Datei.

Nachdem sich das Softwarepaket auf dem Zielgerät befindet, unabhängig davon, ob es ursprünglich dorthin heruntergeladen, von der install() Methode vom Konfigurationsverwaltungsserver oder vom Zielgerät aus einer URL kopiert wurde, führt die install() Methode die folgenden Vorgänge aus:

• Überprüft die Konfiguration anhand des neuen Pakets, wenn der validate Parameter auf True festgelegt ist

• Installiert das Paket auf allen Routing-Engines, es sei denn all_re , es ist auf False

Anmerkung:

Ab Version 2.1.5 aktualisiert Junos PyEZ standardmäßig alle Routing-Engines auf einzelnen Geräten und Mitgliedern in einem virtuellen Chassis. In früheren Versionen oder wenn all_re=False, aktualisiert Junos PyEZ nur die Routing-Engine, mit der es verbunden ist.

Ab Junos PyEZ, Version 2.5.0, gibt die install() Methode ein Tupel zurück, das den Status der Installation und eine Meldungszeichenfolge enthält. In früheren Versionen gibt die Methode nur den Status der Installation zurück. Der Status ist True , ob die Installation erfolgreich war und False nicht. Die Meldungszeichenfolge enthält zusätzliche Informationen über den Erfolg oder Misserfolg der Installation und kann Informationsmeldungen oder Fehlermeldungen enthalten, die von Junos PyEZ oder dem Gerät generiert werden. Zum Beispiel:

Die install() Methode startet das Gerät nicht automatisch neu. Um das Gerät nach Abschluss der Installation neu zu starten oder herunterzufahren, rufen Sie die or-Methode shutdown() bzw. aufreboot().

Das folgende Video zeigt eine kurze Python-Sitzung, in der veranschaulicht wird, wie Sie Junos PyEZ zur Installation von Junos OS verwenden.

Junos PyEZ führt Vorgänge über eine NETCONF-Sitzung aus. Die Standardzeit für ein Timeout eines NETCONF-RPCs beträgt 30 Sekunden. Während des Installationsvorgangs erhöht Junos PyEZ das RPC-Timeout-Intervall beim Kopieren und Installieren des Pakets auf dem Gerät auf 1800 Sekunden (30 Minuten) und beim Berechnen der Prüfsumme auf 300 Sekunden (5 Minuten). In einigen Fällen kann der Installationsprozess oder die Prüfsummenberechnung diese Zeitintervalle überschreiten.

Um den Timeoutwert für den Installationsprozess und die Prüfsummenberechnung zu erhöhen, schließen Sie die timeout Parameter und checksum_timeout in den Aufruf der install() Methode ein, und legen Sie sie auf die entsprechenden Werte fest. Zum Beispiel:

Der Junos PyEZ-Installationsprozess ermöglicht es Ihnen, den Fortschritt der Installation anzuzeigen oder zu protokollieren, indem Sie das Argument progress in den install() Methodenaufruf aufnehmen. Das Argument wird auf eine Rückruffunktion festgelegt, für die ein Funktionsprototyp definiert sein muss, der die Instanz- und Berichtszeichenfolgenargumente Device enthält. Sie können auch die Verwendung sw.progress() für die grundlegende Berichterstellung festlegenprogress=True.

Im folgenden Beispiel wird der Installationsfortschritt mithilfe der myprogress Funktion ausgegeben.

Die Fortschrittsausgabe erfolgt im benutzerdefinierten Format.

Auf Geräten mit Routing-Engines mit VM-Host-Unterstützung wird Junos OS als virtuelle Maschine (VM) über einen Linux-basierten Host (VM-Host) ausgeführt. Für ein Upgrade eines VM-Hosts ist ein VM-Host-Installationspaket (junos-vmhost-install-x.tgz) erforderlich, mit dem das Hostbetriebssystem und das kompatible Junos-Betriebssystem aktualisiert werden. Das Upgrade wird mit dem Befehl Betriebsmodus ausgeführt, der request vmhost software add dem <request-vmhost-package-add> RPC entspricht.

Ab Junos PyEZ, Version 2.1.6, unterstützt die sw.install() Methode das vmhost=True Argument zum Ausführen eines VM-Host-Upgrades. Wenn das Argument vmhost=True vorhanden ist, führt die sw.install() Methode die Installation mit dem <request-vmhost-package-add> RPC anstelle des <request-package-add> RPC aus.

Im folgenden Beispiel werden sowohl das Junos-Betriebssystem als auch das Hostbetriebssystem auf einem einzelnen Routing-Engine-Gerät aktualisiert und neu gestartet:

Wenn Sie nur die Junos OS-Software neu starten möchten, rufen Sie die sw.reboot() Methode ohne das vmhost Argument auf.

Junos PyEZ bietet Unterstützung für die Durchführung eines einheitlichen In-Service-Software-Upgrades (Unified ISSU) oder eines Nonstop-Software-Upgrades (NSSU) auf Geräten, die die Funktion unterstützen und die erforderlichen Anforderungen erfüllen. Tabelle 2 beschreibt die Junos PyEZ-Version, in der die vereinheitlichten ISSU- und NSSU-Funktionen erstmals unterstützt werden. Weitere Informationen zu einheitlichem ISSU und NSSU finden Sie in der Softwaredokumentation für Ihr Produkt.

Tabelle 2: Unterstützung für Junos PyEZ Unified ISSU und NSSU

Junos PyEZ-Version	Funktionsunterstützung
2.1.0	Unterstützung für einheitliche ISSU und NSSU auf Junos-Geräten mit dualer Routing-Engine.
2.1.6	Unterstützung für Unified ISSU während eines VM-Host-Upgrades für Geräte mit VM-Host-Unterstützung, die den request vmhost software in-service-upgrade Befehl verwenden, um ein einheitliches In-Service-Software-Upgrade des Host- und Junos-Betriebssystems durchzuführen.

Die einheitliche ISSU-Funktion ermöglicht Ihnen ein Upgrade zwischen zwei verschiedenen Junos OS-Versionen ohne Unterbrechung auf der Steuerungsebene und mit minimaler Unterbrechung des Datenverkehrs. Um ein einheitliches In-Service-Softwareupgrade auf Geräten durchzuführen, die diese Funktion unterstützen, schließen Sie das Argument issu=True in die install() Methode ein.

Im folgenden Beispiel aktualisiert die install() Methode Junos OS auf beiden Routing-Engines und startet die neue primäre Routing-Engine (zuvor die alte Backup-Routing-Engine) im Rahmen des Installationsvorgangs neu. Wenn die Installation erfolgreich ist, startet die reboot() Methode das verbundene Routingmodul neu, bei dem es sich um das neue Backup-Routingmodul (zuvor das alte primäre Routingmodul) handelt.

Um ein einheitliches In-Service-Softwareupgrade auf einer Routing-Engine mit VM-Host-Unterstützung durchzuführen, die die erforderlichen Anforderungen erfüllt und eine einheitliche ISSU unterstützt, schließen Sie die vmhost=True Argumente and issu=True in die install() Methode ein. Das Gerät wird mithilfe des <request-vmhost-package-in-service-upgrade> RPC von einem Hostbetriebssystem und einer Junos OS-Version auf die angeforderte Version aktualisiert.

Mit der NSSU-Funktion können Sie die Junos OS-Software, die auf einem Switch oder Virtual Chassis ausgeführt wird, mit redundanten Routing-Engines bei minimaler Unterbrechung des Netzwerkdatenverkehrs aktualisieren. Um ein unterbrechungsfreies Softwareupgrade auf Geräten durchzuführen, die diese Funktion unterstützen, schließen Sie das Argument nssu=True in die install() Methode ein. Zum Beispiel:

Wenn Sie ein Upgrade eines nicht gemischten Virtual Chassis der EX-Serie durchführen, befolgen Sie im Allgemeinen den Installationsprozess, der in der Übersicht über den Installationsprozess beschrieben ist, um das gesamte Virtual Chassis zu aktualisieren. Es kann jedoch vorkommen, dass Sie Software auf bestimmten Komponenten-Switches in einem virtuellen Chassis installieren müssen. Ab Junos PyEZ, Version 2.6.8, können Sie mithilfe des member_id Arguments ein Softwarepaket auf einzelnen Member-Switches in einem Virtual Chassis der EX-Serie installieren. Das member_id Argument ist eine Liste von Zeichenfolgen, die die Member-IDs angeben, auf denen die Software installiert werden soll.

Mit der folgenden Junos PyEZ-Anwendung wird beispielsweise die Software auf Bauteil 0 und Bauteil 1 im virtuellen Chassis der EX-Serie aktualisiert: