使用 Scripting 來更新 DataPower 設備的韌體版本
利用 wsadmin 工具,來更新受管理集內之設備的韌體。製造商提供的韌體版本檔案專用於特定的裝置類型、機型和特性程式庫。
開始之前
在開始之前,請先新增及配置設備和受管理集,以設定 DataPower® 設備管理程式。
關於這項作業
這個主題提供範例,來說明如何針對 DataPower 設備管理程式在受管理集內所管理的多部設備,更新其韌體。屬意的設備是 testSet 受管理集的成員。當更新管理多部設備之受管理集上的韌體時,系統會將韌體版本部署至主要設備,再循序部署至受管理集中的每一部設備。
如果要檢視這個主題中指令的其他資訊和範例,請參閱「AdminTask 物件的 dpManagerCommands 指令群組」說明文件。
程序
- 啟動 wsadmin Scripting 工具。
- 判斷受管理集的 ID。 使用 dpGetAllManagedSetIDs 指令,顯示 DataPower 設備管理程式配置中每一個受管理集的 ID,如下列指令所示:
AdminTask.dpGetAllManagedSetIds()
您可以選擇性地使用 dpGetManagedSet 指令,顯示給定的特定受管理集 ID 的屬性,如下列範例所示:AdminTask.dpGetManagedSet('-managedSetId testSet')
- 判斷要部署至每一個受管理集的韌體版本。
您可以使用 DataPower 設備管理程式,將新韌體版本部署在配置中,或是回復成存在於您配置中的舊韌體版本。
- 如果要將新的韌體版本部署在配置中,請從 DataPower 網站下載所要的韌體版本。如果您要回復成存在於您配置中的舊韌體版本,則不需下載新韌體版本。下載新的韌體版本之後,請使用 dpAddFirmwareVersion 指令,將本端韌體版本新增至 DataPower 設備管理程式。韌體版本會與特定韌體相關聯,對於具有相同設備類型、機型和相容特性的每一個韌體版本,形同儲存器。下列指令範例是將韌體版本新增至
DataPower 設備管理程式:
addFirmwareTask=AdminTask.dpAddFirmwareVersion('[-file "C:\temp\dptestFW\dev-xs-143863-3_6_0_16.scrypt2" -userComment "my new firmware for test"]')
指令會將作業提交給 DataPower 設備管理程式,並將作業 ID 設定給對應的變數。請使用下列範例指令,來監視作業的狀態:
指令會以 result 屬性值的形式,傳回作業資訊和韌體版本 ID,如下列範例輸出所示:param = '-taskId '+addFirmwareTask print AdminTask.dpGetTask(param)
[ [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]] ]
您可以使用 dpGetAllFirmwareIds 指令,來顯示每一個可用韌體的 ID。然後使用 dpGetAllFirmwareVersionIDs 指令,取得您屬意之韌體的每一個可用韌體版本的 ID。當您找到要使用的韌體版本 ID 時,請將 result 屬性值設成一個變數,以便用於將韌體版本部署至受管理集的指令,如下列範例所示:testFirmwareVersionID = 'XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15'
- 如果要將現有的韌體版本部署至受管理集,請使用下列指令,判斷屬意的韌體版本:
- 使用 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
- 您可以選擇性地使用 dpGetFirmware 指令,顯示該韌體的設備類型、機型、嚴格特性和非嚴格特性,如下列範例所示:
AdminTask.dpGetFirmware('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
- 如果您不確定要使用哪一個韌體,可以使用 dpGetBestFirmware 指令,來查詢符合您設備類型、機型和設備特性的韌體。指令不會建議特定的韌體。指令會判斷符合您配置的韌體。在下列範例中,指令會查詢是否有含有 3.6.0.4 韌體版本的韌體:
AdminTask.dpGetBestFirmware('-applianceType "XS40" -modelType "9002" -applianceFeatures "JAXP-API" -level "3.6.0.4"')
- 使用 dpGetAllFirmwareVersionIds 指令,顯示特定韌體的每一個韌體版本的版本 ID,如下列範例所示:
- 如果要將新的韌體版本部署在配置中,請從 DataPower 網站下載所要的韌體版本。如果您要回復成存在於您配置中的舊韌體版本,則不需下載新韌體版本。下載新的韌體版本之後,請使用 dpAddFirmwareVersion 指令,將本端韌體版本新增至 DataPower 設備管理程式。韌體版本會與特定韌體相關聯,對於具有相同設備類型、機型和相容特性的每一個韌體版本,形同儲存器。下列指令範例是將韌體版本新增至
DataPower 設備管理程式:
- 驗證系統已將新的韌體版本新增至
DataPower 設備管理程式。 使用 getTask 指令,判斷作業是否已完成,如下列範例所示:
AdminTask.dpGetTask('-taskId '+addFirmwareTask)
指令會傳回您屬意之非同步作業的相關資訊。如果作業已完成,isComplete 屬性會顯示值 true。如果未完成,請記下 taskStatus 屬性的值。如果回覆值是 0,表示作業位於佇列中,且系統尚未啟動作業。如果回覆值是 1,表示作業進行中。如果回覆值是 2,表示作業已順利完成。如果回覆值是 3,表示作業遇到異常狀況。
- 部署韌體版本 在系統將韌體版本新增至 DataPower 設備管理程式之後,請使用 dpSetManagedSet 指令,將韌體版本指派給受管理集。下列範例是將新下載的韌體版本指派給測試環境受管理集:
FVTask=AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId '+testFirmwareVersionID)
指令會將作業提交給 DataPower 設備管理程式,並將作業 ID 指派給對應的變數。部署韌體可能要數分鐘,且會讓設備重新啟動,以便執行新的韌體版本。
- 驗證系統已順利將新的韌體版本指派給受管理集。 使用 getTask 指令,判斷作業是否已完成,如下列範例所示:
AdminTask.dpGetTask('-taskId '+FVTask)
指令會傳回您屬意之非同步作業的相關資訊。如果作業已完成,isComplete 屬性會顯示值 true。如果未完成,請記下 taskStatus 屬性的值。如果回覆值是 0,表示作業位於佇列中,且系統尚未啟動作業。如果回覆值是 1,表示作業進行中。如果回覆值是 2,表示作業已順利完成。如果回覆值是 3,表示作業遇到異常狀況。
- 選擇性的: 將系統已取代的韌體版本從
DataPower 設備管理程式移除。
如果您不想將舊韌體版本的副本保留在 DataPower 設備管理程式上,請將該韌體版本從配置移除。您可能想保留前兩個韌體版本,以防您需要回復成舊版。
請使用 dpRemoveFirmwareVersion 指令,來移除受管理集不再使用的韌體版本。您無法移除指派給受管理集的韌體版本。下列範例是將韌體版本從 DataPower 設備管理程式移除:AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')
結果
受管理集會使用新的韌體版本。
下一步
您可以使用 wsadmin 工具,來管理設備、韌體、網域、受管理集和設備專用的設定。此外,系統會為網域、韌體和設備專用的設定建立版本。您可以使用 wsadmin 工具,來修改網域、韌體和設備專用設定的現行版本,或回復成舊版。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7dpfirmware
檔名:txml_7dpfirmware.html