請使用 wsadmin 工具,來管理 DataPower®
設備管理程式的受管理網域和韌體版本歷程。您可以回復成存在於 DataPower 設備管理程式中的舊有網域和韌體版本。
開始之前
在開始之前,請先新增及配置設備和受管理集,以設定 DataPower 設備管理程式。
關於這項作業
當 DataPower 管理者修改網域、韌體或設定時,只要符合下列條件,DataPower 設備管理程式就會自動將先前配置的副本建立成網域、韌體和設定版本:
- 如果設備位於受管理集中,且網域是受管理的,DataPower 設備管理程式會建立網域版本。
- 只有在管理者新增韌體版本至 DataPower 設備管理程式時,DataPower 設備管理程式才會建立韌體版本。
- 如果設備配置在受管理集中,DataPower 設備管理程式就會建立設定版本。
您可以使用 wsadmin 工具,來檢視版本歷程、回復成舊網域版本,或是將網域版本複製到另一個受管理集。這個主題提供範例,來說明如何修改網域、韌體和設定版本。如果要檢視這個主題中指令的其他資訊和範例,請參閱「AdminTask 物件的 dpManagerCommands 指令群組」說明文件。
程序
- 管理受管理網域版本。
- 啟動 wsadmin Scripting 工具。
- 顯示您配置中的受管理集 ID。
使用 dpGetAllManagedSetIDs 指令,顯示 DataPower 設備管理程式配置中每一個受管理集的 ID,如下列指令所示:
AdminTask.dpGetAllManagedSetIds()
- 顯示特定受管理集所管理的每一個網域。
使用 dpGetAllMSDomainIds 指令,顯示特定受管理集中每一個網域的網域 ID,如下列範例所示:
AdminTask.dpGetAllMSDomainIds('[-managedSetId myManagedSet]')
- 顯示特定網域現有的每一個網域版本。
使用 dpGetAllMSDomainVersionIds 指令,顯示特定網域現有每一個網域版本的網域版本 ID,如下列範例所示:
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 Scripting 工具。
- 顯示您配置中之韌體的 ID。
使用 dpGetAllFirmwareIds 指令,顯示 DataPower 設備管理程式配置中每一個韌體的 ID,如下列指令所示:
AdminTask.dpGetAllFirmwareIds()
- 顯示特定韌體的現有韌體版本。
使用 dpGetAllFirmwareVersionIds 指令,顯示您屬意之韌體的每個韌體版本 ID,如下列範例所示:
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')
- 管理設定版本。
- 顯示您配置中的受管理集 ID。
使用 dpGetAllManagedSetIDs 指令,顯示 DataPower 設備管理程式配置中每一個受管理集的 ID,如下列指令所示:
AdminTask.dpGetAllManagedSetIds()
- 顯示您屬意之受管理集的其他資訊。
使用 dpGetManagedSet 指令,顯示受管理集的配置屬性。
settingsId 屬性值代表您屬意之受管理集的設定物件。
AdminTask.dpGetManagedSet('-managedSetId myManagedSet')
- 顯示您屬意之設定的每一個版本。
使用 dpGetAllMSSettingsVersionIds 指令,顯示您屬意之設定的每一個設定版本的 ID,如下列範例所示:
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 工具,來管理設備、韌體、網域、受管理集和設備專用的設定。