Verwenden Sie das Tool "wsadmin", um Firmware für Geräte in einer verwalteten Gruppe
zu aktualisieren. Die Firmwareversionsdateien des Herstellers sind für Einheitentypen, Modelltypen und Bibliotheken für Features spezifisch.
Vorbereitende Schritte
Bevor Sie mit der Aktualisierung beginnen, konfigurieren Sie den DataPower-Gerätemanager, indem Sie Geräte und verwaltete Gruppen hinzufügen.
Informationen zu diesem Vorgang
Dieser Artikel enthält ein Beispiel für die Aktualisierung der Firmware für mehrere Geräte, die der
DataPower-Gerätemanager in einer verwalteten Gruppe verwaltet.
Die Geräte von Interesse sind Member der verwalteten Gruppe testSet.
Wenn Sie die Firmware in einer verwalteten Gruppe aktualisieren, in der mehrere verwaltet werden,
implementiert das System die Firmwareversion auf dem Mastergerät und anschließend auf jedem einzelnen Gerät in der verwalteten Gruppe.
Weitere Informationen und Beispiele zu den in diesem Artikel verwendeten Befehlen finden Sie in der Dokumentation zur Befehlsgruppe
"dpManagerCommands" für das Objekt "AdminTask".
Vorgehensweise
- Starten Sie das wsadmin-Scripting-Tool.
- Bestimmen Sie die IDs der verwalteten Gruppen.
Verwenden Sie den Befehl "dpGetAllManagedSetIDs",
wie im folgenden Beispiel gezeigt, um die IDs der verwalteten Gruppen in der Konfiguration des DataPower-Gerätemanagers anzuzeigen:
AdminTask.dpGetAllManagedSetIds()
Optional können Sie den Befehl
"dpGetManagedSet", wie im folgenden Beispiel gezeigt, verwenden, um die Attribute für eine bestimmte verwaltete Gruppe anzuzeigen:
AdminTask.dpGetManagedSet('-managedSetId testSet')
- Bestimmen Sie die Firmwareversion, die in den verwalteten Gruppen implementiert werden soll.
Sie können den DataPower-Gerätemanager verwenden, um eine neue Firmwareversion in Ihrer
Konfiguration zu implementieren oder um die Konfiguration auf eine vorhandene frühere Firmwareversion zurückzusetzen.
- Prüfen Sie, ob das System die neue Firmwareversion dem DataPower-Gerätemanager hinzugefügt hat.
Verwenden Sie den Befehl "getTask", wie im folgenden Beispiel gezeigt, um festzustellen, ob die Task ausgeführt wurde:
AdminTask.dpGetTask('-taskId '+addFirmwareTask)
Der Befehl gibt Informationen zur gewünschten asynchronen Task zurück.
Das Attribut isComplete hat den Wert true, wenn die Task abgeschlossen ist. Wenn die Task nicht abgeschlossen ist,
notieren Sie den Wert des Attributs taskStatus. Wenn der zurückgegebene Wert 0 lautet,
befindet sich die Task in einer Warteschlange, und das System hat die Task nicht gestartet. Lautet der zurückgegebene
Wert 1, ist die Task in Bearbeitung. Wenn der zurückgegebene
Wert 2 lautet, wurde die Task erfolgreich abgeschlossen. Lautet der zurückgegebene
Wert 3, ist bei der Ausführung der Task eine Ausnahme eingetreten.
- Implementieren Sie die Firmwareversion.
Nachdem das System die Firmwareversion dem DataPower-Gerätemanager hinzugefügt hat, verwenden Sie den Befehl "dpSetManagedSet", um
die Firmwareversion der verwalteten Gruppe zuzuordnen. Der folgende Beispielbefehl
ordnet die neu heruntergeladene Firmwareversion der verwalteten Gruppe für die Testumgebung hinzu:
FVTask=AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId '+testFirmwareVersionID)
Der Befehl
übergibt die Tasks an den DataPower-Gerätemanager und ordnet die Task-IDs den entsprechenden Variablen zu.
Die Implementierung einer Firmware kann mehrere Minuten dauern. Anschließen wird das Gerät erneut gestartet, damit die neue
Firmwareversion ausgeführt wird.
- Prüfen Sie, ob das System den verwalteten Gruppen die neuen Firmwareversionen erfolgreich zugeordnet hat.
Verwenden Sie den Befehl "getTask", wie im folgenden Beispiel gezeigt, um festzustellen, ob die Task ausgeführt wurde:
AdminTask.dpGetTask('-taskId '+FVTask)
Der Befehl gibt Informationen zur gewünschten asynchronen Task zurück.
Das Attribut isComplete hat den Wert true, wenn die Task abgeschlossen ist. Wenn die Task nicht abgeschlossen ist,
notieren Sie den Wert des Attributs taskStatus. Wenn der zurückgegebene Wert 0 lautet,
befindet sich die Task in einer Warteschlange, und das System hat die Task nicht gestartet. Lautet der zurückgegebene
Wert 1, ist die Task in Bearbeitung. Wenn der zurückgegebene
Wert 2 lautet, wurde die Task erfolgreich abgeschlossen. Lautet der zurückgegebene
Wert 3, ist bei der Ausführung der Task eine Ausnahme eingetreten.
- Optional: Entfernen Sie die Firmwareversion, die das System ersetzt hat,
aus dem DataPower-Gerätemanager.
Wenn Sie keine Kopie der früheren Firmwareversion im DataPower-Gerätemanager behalten möchten,
entfernen Sie die Firmwareversion aus Ihrer Konfiguration.
Sie können die früheren zwei Firmwareversionen aber auch behalten, falls Sie auf die frühere Version zurückgreifen müssen.
Verwenden Sie den Befehl "dpRemoveFirmwareVersion", um die Firmwareversion zu entfernen, die
von der verwalteten Gruppe nicht mehr verwendet wird. Firmwareversionen , die verwalteten Gruppen zugeordnet sind, können nicht entfernt werden.
Der folgende Beispielbefehl entfernt die Firmwareversion aus dem DataPower-Gerätemanager:
AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')
Ergebnisse
Die verwaltete Gruppe verwendet die neue Firmwareversion.
Nächste Schritte
Sie können das Tool "wsadmin" verwenden, um Geräte, Firmware, Domänen, verwaltete Gruppen und gerätespezifische
Einstellungen zu verwalten. Außerdem erstellt das System Versionen von Domänen, Firmware und
gerätespezifischen Einstellungen. Sie können das Tool "wsadmin" verwenden, um die aktuelle Version zu ändern oder
um auf frühere Versionen von Domänen, Firmware oder gerätespezifischen Einstellungen zurückzugreifen.