Verwenden Sie das Tool "wsadmin", um das Versionsprotokoll für verwaltete Domänen und Firmware für den
DataPower-Gerätemanager zu verwalten. Sie können auf frühere Domänen- und
Firmware-Versionen zurückgreifen, die im DataPower-Gerätemanager vorhanden sind.
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
Wenn ein DataPower-Administrator die Domäne, Firmware oder Einstellungen ändert, erstellt der
DataPower-Gerätemanager automatisch eine Kopie der früheren Konfiguration als
Domänen-, Firmware- bzw. Einstellungsversion, sofern die folgenden Bedingungen zutreffen:
- Der DataPower-Gerätemanager
erstellt Domänenversionen, wenn sich das Gerät in einer verwalteten Gruppe befindet und die Domäne verwaltet wird.
- Der DataPower-Gerätemanager
erstellt Firmware-Versionen nur, wenn der Administrator dem DataPower-Gerätemanager
neue Firmware-Versionen hinzufügt.
- Der DataPower-Gerätemanager
erstellt Einstellungsversionen, wenn das Gerät in einer verwalteten Gruppe konfiguriert ist.
Sie können das Tool "wsadmin" verwenden, um ein Versionsprotokoll anzuzeigen, auf eine frühere
Domänenversion zurückzugreifen oder eine Domänenversion in eine andere verwaltete Gruppe zu kopieren.
Dieser Artikel enthält Beispiele für die das Ändern der Domänen-, Firmware- und
Einstellungsversionen.
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
- Verwalten Sie Versionen verwalteter Domänen.
- Starten Sie das wsadmin-Scripting-Tool.
- Zeigen Sie die IDs der verwalteten Gruppe in Ihrer Konfiguration an.
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()
- Zeigen Sie jede Domäne an, die von einer bestimmten verwalteten Gruppe verwaltet wird.
Verwenden Sie den Befehl "dpGetAllMSDomainIds", wie im folgenden Beispiel gezeigt, um die Domänen-IDs aller Domänen in einer bestimmten verwalteten Gruppe anzuzeigen:
AdminTask.dpGetAllMSDomainIds('[-managedSetId myManagedSet]')
- Zeigen Sie alle Domänenversionen an, die für eine bestimmte Domäne vorhanden sind.
Verwenden Sie den Befehl "dpGetAllMSDomainVersionIds", wie im folgenden Beispiel gezeigt, um die Domänenversions-IDs
aller Domänenversionen anzuzeigen, die für eine bestimmte Domäne vorhanden sind:
AdminTask.dpGetAllMSDomainVersionIds('[-msDomainId myManagedSet:domain1]')
In diesem Beispiel gibt der Befehl die folgende Ausgabe zurück:
[myManagedSet:domain1:1, myManagedSet:domain1:2, myManagedSet:domain1:3, myManagedSet:domain1:4]
- Zeigen Sie die Informationen zur Domänenversion an.
Verwenden Sie den Befehl "dpGetMSDomainVersion", wie im folgenden
Beispiel gezeigt, um detaillierte Informationen zu einer Domänenversion anzuzeigen, einschließlich der Uhrzeit, zu der
der DataPower-Gerätemanager die Version und die Kommentare erstellt hat:
AdminTask.dpGetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:1]')
- Geben Sie einen Kommentar zu einer Domänenversion an.
Verwenden Sie den Befehl "dpSetDomainVersion", wie im folgenden Beispiel gezeigt,
um einen Kommentar zu einer Domäne einzugeben:
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15" -userComment "revert to firmware version 3.6.0.15"')
- Wechseln Sie auf die erste Version der Domäne zurück.
Verwenden Sie den
Befehl "dpSetMSDomainVersion", wie im folgenden Beispiel gezeigt, um die Version der Domäne, die von der verwalteten Gruppe verwendet wird,
zu ändern:
AdminTask.dpSetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:2 -userComment "revert to previous version"]')
- Verwalten Sie Firmware-Versionen.
- Starten Sie das wsadmin-Scripting-Tool.
- Zeigen Sie die IDs der Firmware in Ihrer Konfiguration an.
Verwenden Sie den Befehl "dpGetAllFirmwareIds", wie im folgenden Beispiel gezeigt, um die IDs der Firmware
in der Konfiguration des DataPower-Gerätemanagers anzuzeigen:
AdminTask.dpGetAllFirmwareIds()
- Zeigen Sie die Firmware-Versonen an, die für eine bestimmte Firmware vorhanden sind.
Verwenden Sie den Befehl "dpGetAllFirmwareVersionIds", wie im folgenden Beispiel gezeigt, um alle Firmware-Versions-IDs für die gewünschte Firmware anzuzeigen:
AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
In diesem Beispiel gibt der Befehl die folgende Ausgabe zurück:
[XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15, XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16]
- Geben Sie einen Kommentar zu einer Firmware-Version an.
Verwenden Sie den Befehl "dpSetFirmwareVersion", wie im folgenden Beispiel gezeigt,
um einen Kommentar zu einer Firmware-Version einzugeben:
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15" -userComment "revert to firmware version 3.6.0.15"')
- Legen Sie die Firmware-Version für die verwaltete Gruppe fest.
Verwenden Sie den
Befehl "dpSetManagedSet", wie im folgenden Beispiel gezeigt, um der verwalteten Gruppe die Firmware-Version zuzuordnen:
AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15')
- Verwalten Sie Einstellungsversionen.
- Zeigen Sie die IDs der verwalteten Gruppe in Ihrer Konfiguration an.
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()
- Zeigen Sie weitere Informationen zur gewünschten verwalteten Gruppe an.
Verwenden Sie den Befehl "dpGetManagedSet", um die Konfigurationsattribute für die verwaltete Gruppe anzuzeigen.
Der Wert des Attributs
settingsId stellt das Einstellungsobjekt der gewünschten verwalteten Gruppe dar.
AdminTask.dpGetManagedSet('-managedSetId myManagedSet')
- Zeigen Sie die Versionen der gewünschten Einstellungen an.
Verwenden Sie den Befehl "dpGetAllMSSettingsVersionIds", wie im folgenden
Beispiel gezeigt, um die IDs aller Einstellungsversionen für die gewünschten Einstellungen anzuzeigen:
AdminTask.dpGetAllMSSettingsVersionIds('-msSettingsId mySettings')
In diesem Beispiel gibt der Befehl die folgende Ausgabe zurück:
[myManagedSet:1, myManagedSet:2, MyManagedSet:3]
- Bestimmen Sie die von der verwalteten Gruppe momentan verwendete Einstellungsversion.
Verwenden Sie den Befehl "dpGetMSSettings", um die Konfigurationsattribute für die Einstellungsversion anzuzeigen, die
von der verwalteten Gruppe derzeit verwendet wird.
In der Befehlsausgabe stellt der Wert des Attributs
desiredSettingsVersionId die Einstellungsversion dar, die von der verwalteten Gruppe verwendet wird.
AdminTask.dpGetMSSettings('-msSettingsId mySettings')
In diesem Beispiel gibt der Befehl die folgende Ausgabe zurück:
[MyManagedSet:3]
- Legen Sie die von der verwalteten Gruppe zu verwendende Einstellungsversion fest.
Verwenden Sie den Befehl
"dpSetMSSettings", wie im folgenden Beispiel gezeigt, um die Einstellungsversion festzulegen, die für die verwaltete Gruppe
verwendet werden soll:
AdminTask.dpSetMSSettings('-msSettingsId myMS1 -desiredSettingsVersionId myMS1:1')
- Geben Sie einen Kommentar zu einer Einstellungsversion an.
Verwenden Sie den Befehl
"dpSetMSSettingsVersion", wie im folgenden Beispiel gezeigt, um einen Kommentar zu einer Einstellungsversion einzugeben:
AdminTask.dpSetMSSettingsVersion('[-msSettingsVersionId myManagedSet:2 -userComment "added new timeserver"]')
Nächste Schritte
Sie können das Tool "wsadmin" verwenden, um Geräte, Firmware, Domänen, verwaltete Gruppen und gerätespezifische
Einstellungen zu verwalten.