Firmwareversionen für DataPower-Geräte mit Scripting aktualisieren

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

  1. Starten Sie das wsadmin-Scripting-Tool.
  2. 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')
  3. 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.

    • Wenn Sie eine neue Firmwareversion in Ihrer Konfiguration implementieren möchten, laden Sie die gewünschte Firmwareversion von der Website von DataPower herunter. Sie müssen keine neue Firmwareversion herunterladen, wenn Sie auf eine frühere Firmwareversion zurückgreifen möchten, die in Ihrer Konfiguration vorhanden ist. Nach dem Download der neuen Firmwareversion verwenden Sie den Befehl "dpAddFirmwareVersion", um die lokale Firmwareversion dem DataPower-Gerätemanager hinzuzufügen. Die Firmwareversion wird einer bestimmten Firmware zugeordnet, die als Container für alle Firmwareversionen dient, die denselben Gerätetyp, denselben Modelltyp und kompatible Features haben. Der folgende Beispielbefehl fügt dem DataPower-Gerätemanager eine Firmwareversion hinzu:
      addFirmwareTask=AdminTask.dpAddFirmwareVersion('[-file "C:\temp\dptestFW\dev-xs-143863-3_6_0_16.scrypt2"
       -userComment "my new firmware for test"]')
      Der Befehl übergibt die Tasks an den DataPower-Gerätemanager und setzt die Task-IDs auf die entsprechenden Variablen. Verwenden Sie die folgenden Beispielbefehle, um den Status der Tasks zu überwachen:
      param = '-taskId '+addFirmwareTask 
      print AdminTask.dpGetTask(param) 
      Der Befehl gibt, wie in der folgenden Beispielausgabe gezeigt, die Taskinformationen und die ID der Firmwareversion als Wert des Attributs result zurück:
      [ [currentStep 0] [totalSteps 0] [taskDescription [Add new firmware version to the DataPower appliance manager]] [currentStepTimestamp [Jan 18, 2008 2:32:25 PM]] [creationDate [Jan 18, 2008 2:32:23 PM]] [taskStatus 2] [taskId 1] [hasError false] [createdByUser defaultWIMFileBasedRealm/admin] [isComplete true] [result [XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15]] ] 
      Si können den Befehl "dpGetAllFirmwareIds" verwenden, um die IDs der verfügbaren Firmwares anzuzeigen. Verwenden Sie anschließend den Befehl "dpGetAllFirmwareVersionIDs", um die IDs der verfügbaren Firmwareversionen der gewünschten Firmware anzuzeigen. Wenn Sie die ID der zu verwendenden Firmwareversion gefunden haben, setzen Sie, wie im folgenden Beispiel gezeigt, den Wert des Attributs result auf eine Variable, die in dem Befehl verwendet werden soll, der die Firmwareversion in der verwalteten Gruppe implementiert.
      testFirmwareVersionID = 'XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15'
    • Wenn Sie eine vorhandene Firmwareversion in der verwalteten Gruppe implementieren möchten, verwenden Sie die folgenden Befehle, um die Firmwareversionen von Interesse zu bestimmen:
      • Verwenden Sie den Befehl "dpGetAllFirmwareVersionIds", wie im folgenden Beispiel gezeigt, um die Versions-IDs aller Firmwareversionen einer bestimmten Firmware anzuzeigen:
        AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • In diesem Beispiel sind die folgenden beiden Firmwareversionen vorhanden:
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16
      • Optional können Sie den Befehl "dpGetFirmware", wie im folgenden Beispiel gezeigt, verwenden, um den Gerätetyp, den Modelltyp, die strikt vorgegebenen Features und die nicht strikt vorgegebenen Features für die Firmware anzuzeigen:
        AdminTask.dpGetFirmware('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Wenn Sie sich unsicher sind, welche Firmware zu verwenden ist, können Sie den Befehl "dpGetBestFirmware" verwenden, um die Firmware abzufragen, die Ihrem Gerätetyp, Ihrem Modelltyp und Ihren Gerätefeatures entspricht. Der Befehl empfiehlt keine bestimmte Firmware. Der Befehl bestimmt lediglich die Firmware, die Ihrer Konfiguration entspricht. Im folgenden Beispiel fragt der Befehl eine Firmware ab, die die Firmwareversion "3.6.0.4" enthält:
        AdminTask.dpGetBestFirmware('-applianceType "XS40" -modelType "9002" -applianceFeatures "JAXP-API" -level "3.6.0.4"')
  4. 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.

  5. 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.

  6. 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.

  7. 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.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7dpfirmware
Dateiname:txml_7dpfirmware.html