使用 wsadmin 工具来管理 DataPower® 设备管理器的受管域和固件版本历史记录。您可以还原为存在于 DataPower 设备管理器中的先前域和固件版本。
开始之前
在开始前,请通过添加并配置设备和受管集合来设置 DataPower 设备管理器。
关于此任务
当 DataPower 管理员修改域、固件或设置时,如果以下条件适用,那么 DataPower 设备管理器会自动将先前配置的副本创建为域、固件和设置版本:
- 如果设备是在受管集合中,并且域是受管的,那么 DataPower 设备管理器会创建域版本。
- 仅当管理员将新的固件版本添加到 DataPower 设备管理器时,DataPower 设备管理器才会创建固件版本。
- 如果在受管集合中配置了设备,那么 DataPower 设备管理器会创建设置版本。
您可以使用 wsadmin 工具来查看版本历史记录、还原为先前域版本或将域版本复制到另一个受管集合。本主题提供的示例会修改域、固件和设置版本。要查看本主题中命令的其他信息和示例,请参阅“AdminTask 对象的 dpManagerCommands 命令组”的文档。
过程
- 管理受管域版本。
- 启动 wsadmin 脚本编制工具。
- 显示配置中受管集合的标识。
使用 dpGetAllManagedSetIDs 命令来显示 DataPower 设备管理器配置中每个受管集合的标识,如以下命令所示:
AdminTask.dpGetAllManagedSetIds()
- 显示特定受管集合所管理的每个域。
使用 dpGetAllMSDomainIds 命令来显示特定受管集合中每个域的标识,如以下示例所示:
AdminTask.dpGetAllMSDomainIds('[-managedSetId myManagedSet]')
- 显示特定域的每个现有域版本。
使用 dpGetAllMSDomainVersionIds 命令来显示特定域的每个现有域版本的标识,如以下示例所示:
AdminTask.dpGetAllMSDomainVersionIds('[-msDomainId myManagedSet:domain1]')
对于本示例,此命令会返回以下输出:
[myManagedSet:domain1:1, myManagedSet:domain1:2, myManagedSet:domain1:3, myManagedSet:domain1:4]
- 显示域版本信息。
使用 dpGetMSDomainVersion 命令来显示详细的域版本信息,其中包括 DataPower 设备管理器创建版本和注释的时间,如以下示例所示:
AdminTask.dpGetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:1]')
- 为域版本指定注释。
使用 dpSetDomainVersion 命令,为域指定注释,如以下示例所示:
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15"
-userComment "revert to firmware version 3.6.0.15"')
- 更改为域的第一个版本。
使用 dpSetMSDomainVersion 命令来修改受管集合所使用的域的版本,如以下示例所示:
AdminTask.dpSetMSDomainVersion('[-msDomainVersionId myManagedSet:domain1:2 -userComment
"revert to previous version"]')
- 管理固件版本。
- 启动 wsadmin 脚本编制工具。
- 显示配置中固件的标识。
使用 dpGetAllFirmwareIds 命令来显示 DataPower 设备管理器配置中每个固件的标识,如以下命令所示:
AdminTask.dpGetAllFirmwareIds()
- 显示特定固件的现有固件版本。
使用 dpGetAllFirmwareVersionIds 命令来显示相关固件的每个固件版本标识,如以下示例所示:
AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
对于本示例,此命令会返回以下输出:
[XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15, XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16]
- 为固件版本指定注释。
使用 dpSetFirmwareVersion 命令,为固件版本指定注释,如以下示例所示:
AdminTask.dpSetFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15"
-userComment "revert to firmware version 3.6.0.15"')
- 为受管集合设置固件版本。
使用 dpSetManagedSet 命令,将固件版本指定给受管集合,如以下示例所示:
AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId
XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15')
- 管理设置版本。
- 显示配置中受管集合的标识。
使用 dpGetAllManagedSetIDs 命令来显示 DataPower 设备管理器配置中每个受管集合的标识,如以下命令所示:
AdminTask.dpGetAllManagedSetIds()
- 显示相关受管集合的其他信息。
使用 dpGetManagedSet 命令来显示受管集合的配置属性。
settingsId 属性的值代表相关受管集合的设置对象。
AdminTask.dpGetManagedSet('-managedSetId myManagedSet')
- 显示相关设置的每个版本。
使用 dpGetAllMSSettingsVersionIds 命令来显示相关设置的每个设置版本的标识,如以下示例所示:
AdminTask.dpGetAllMSSettingsVersionIds('-msSettingsId mySettings')
对于本示例,此命令会返回以下输出:
[myManagedSet:1, myManagedSet:2, MyManagedSet:3]
- 确定受管集合当前使用的设置版本。
使用 dpGetMSSettings 命令来显示受管集合当前使用的设置版本的配置属性。在命令输出中,
desiredSettingsVersionId 属性的值代表受管集合所使用的设置版本。
AdminTask.dpGetMSSettings('-msSettingsId mySettings')
对于本示例,此命令会返回以下输出:
[MyManagedSet:3]
- 设置受管集合所使用的设置版本。
使用 dpSetMSSettings 命令来设置要用于受管集合的设置版本,如以下示例所示:
AdminTask.dpSetMSSettings('-msSettingsId myMS1 -desiredSettingsVersionId myMS1:1')
- 为设置版本指定注释。
使用 dpSetMSSettingsVersion 命令,为配置中的设置版本指定注释,如以下示例所示:
AdminTask.dpSetMSSettingsVersion('[-msSettingsVersionId myManagedSet:2 -userComment
"added new timeserver"]')
下一步做什么
您可以使用 wsadmin 工具来管理设备、固件、域、受管集合以及特定于设备的设置。