[IBM i]

clientUpgrade Script

clientUpgrade Script 會移轉企業保存檔 (EAR) 中的應用程式用戶端模組及其資源,以便這些應用程式用戶端可以在 WebSphere® Application Server 8.5中執行。 該 Script 會轉換您要移轉的 EAR 檔,然後以已轉換的 EAR 檔改寫原始 EAR 檔。

下列標題提供 clientUpgrade Script 相關資訊。
注意: 此指令在 6.1版中已淘汰。
任命的成員 說明
產品 clientUpgrade Script 只能在 WebSphere Application Server ( WebSphere Application Server (基本程式)) 產品中使用。
權限 如果要執行這個 Script,您的使用者設定檔必須具備 *ALLOBJ 權限。
語法 clientUpgrade Script 的語法如下:
clientUpgrade EAR_file [ -clientJAR client_JAR_file ]
  [ -logFileLocation logFileLocation ]
  [ -traceString trace_spec [ -traceFile file_name ] ]
參數 clientUpgrade Script 的參數如下:
  • EAR_file -- 這是必要參數。 值 EAR_file 指定 EAR 檔完整路徑,此路徑含有您要移轉的應用程式用戶端模組。
  • -clientJAR -- 這是選用參數。 值 client_JAR_file 指定您要移轉的 JAR 檔。 Script 會以只含指定 JAR 檔的新 EAR 檔,來改寫原始 EAR 檔。 如果您未指定這個參數,clientUpgrade Script 會移轉 EAR 檔中的所有用戶端 JAR 檔。
  • -logFileLocation -- 利用這個選用參數來指定替代位置,以儲存日誌輸出。
  • -traceString -- 這是選用參數。 值 trace_spec 指定您要收集的追蹤資訊。 若要收集所有追蹤資訊,請指定 "* = all = enabled" (包括雙引號 ("))。 依預設, Script 不會收集追蹤資訊。 如果您指定這個參數,您也必須指定 -traceFile 參數。
  • -traceFile -- 這是選用參數。 值 file_name 指定追蹤資訊的輸出檔名稱。 如果您指定 -traceString 參數,但是未指定 -traceFile 參數,Script 將不會產生追蹤檔。
記載 clientUpgrade Script 會在執行時顯示狀態。 它也會將更廣泛的記載資訊儲存至 clientupgrade.log 檔。 此檔案位於 /QIBM/UserData/WebSphere/AppServer/V85/edition/profiles/default/logs 目錄中 (適用於使用預設設定檔的預設安裝) ,或位於-logFileLocation 參數指定的位置。
這些範例示範正確的語法。 在此範例中, My51Application.ear 檔案從 WebSphere Application Server 5.1版移轉, Script 會以您可以在 WebSphere Application Server Version 8.5 設定檔中部署的新檔案改寫原始 EAR 檔。
clientUpgrade /My51Application/My51Application.ear
在此範例中,只有myJarFile.jar已移轉用戶端 JAR 檔。 Script 改寫My51Application.ear具有包含下列項目的 EAR 檔:myJarFile.jar. 您可以在 WebSphere Application Server 設定檔中部署新的 EAR 檔。
clientUpgrade /My51Application/My51Application.ear -clientJAR myJarFile.jar