應用程式更新 Script

Scripting 程式庫提供多個 Script 程序來自動執行應用程式配置。請參閱更新應用程式之 Script 的用法資訊。您可以個別執行每一個 Script ，或結合程序為您的環境建立自訂自動化 Script。

每一個應用程式管理 Script 程序都位於 app_server_root/scriptLibraries/application/V70 目錄中。使用下列 Script 程序來更新應用程式配置:

addSingleFileToAnAppWithUpdate指令
addSingleModuleFileToAnAppWithUpdateCommand
addUpdateSingleModuleFileToAnAppWithUpdate指令
addPartialAppToAnAppWithUpdate指令
deleteSingleFileToAnAppWithUpdate指令
deleteSingleModuleFileToAnAppWithUpdateCommand
deletePartialAppToAnAppWithUpdate指令
updateApplicationUsingDefault合併
updateApplicationWithUpdateIgnoreNew選項
updateApplicationWithUpdateIgnoreOld選項
updateEntireAppToAnAppWithUpdate指令
updatePartialAppToAnAppWithUpdate指令
updateSingleFileToAnAppWithUpdate指令
updateSingleModuleFileToAnAppWithUpdateCommand

addSingleFileToAnAppWithUpdate指令

此 Script 使用 update 指令，將單一檔案新增至已部署的應用程式。

若要執行 Script ，請指定應用程式名稱、檔名及內容統一資源識別碼 (URI) 引數，如下表中所定義:

表 1. addSingleFileToAnAppWithUpdate指令引數說明。執行 Script 以將檔案新增至已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.addSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.addSingleFileToAnAppWithUpdateCommand("myApp", "c:\sample.txt", "META-INFO/sample.txt")

AdminApplication.addSingleFileToAnAppWithUpdateCommand("myApp", "/sample.txt", "META-INFO/sample.txt")

addSingleModuleFileToAnAppWithUpdateCommand

此 Script 使用 update 指令，將單一模組檔案新增至已部署的應用程式。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 2. addSingleModuleFileToAnAppWithUpdateCommand 引數說明。執行 Script 以將模組檔案新增至已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.addSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.addSingleModuleFileToAnAppWithUpdateCommand("myApp", "c:\Increment.jar", "Increment.jar")

AdminApplication.addSingleModuleFileToAnAppWithUpdateCommand("myApp", "/Increment.jar", "Increment.jar")

addUpdateSingleModuleFileToAnAppWithUpdate指令

此 Script 使用 update 指令來新增及更新已部署應用程式的單一模組檔案。

若要執行 Script ，請指定應用程式名稱、檔名、內容 URI 及環境定義根目錄引數，如下表中所定義:

表 3. addUpdateSingleModuleFileToAnAppWithUpdate指令引數說明。執行 Script 以更新已部署應用程式中的檔案。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。
`contextRoot`	指定應用程式中 Web 模組的環境定義根目錄。

語法

AdminApplication.addUpdateSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI, contextRoot)

範例用法

AdminApplication.addUpdateSingleModuleFileToAnAppWithUpdateCommand("myApp",
"c:\DefaultWebApplication.war", "DefaultWebApplication.war", 
"/webapp/defaultapp")

AdminApplication.addUpdateSingleModuleFileToAnAppWithUpdateCommand("myApp",
"/DefaultWebApplication.war", "DefaultWebApplication.war", 
"/webapp/defaultapp")

addPartialAppToAnAppWithUpdate指令

此 Script 會使用 update 指令，將局部應用程式新增至已部署的應用程式。

若要執行 Script ，請指定應用程式名稱及檔案內容引數，如下表中所定義:

表 4. addPartialAppToAnAppWithUpdate指令引數說明。執行 Script 以更新已部署應用程式的一部分。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。

語法

AdminApplication.addPartialAppToAnAppWithUpdateCommand(appName, fileContent)

範例用法

AdminApplication.addPartialAppToAnAppWithUpdateCommand("myApp", "c:\partialadd.zip")

AdminApplication.addPartialAppToAnAppWithUpdateCommand("myApp", "/partialadd.zip")

deleteSingleFileToAnAppWithUpdate指令

此 Script 會使用 update 指令，從已部署的應用程式中刪除單一檔案。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 5. deleteSingleFileToAnAppWithUpdate指令引數說明。執行 Script 以從已部署的應用程式中刪除檔案。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.deleteSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.deleteSingleFileToAnAppWithUpdateCommand("myApp", "c:\sample.
txt", "META-INFO/sample.txt")

AdminApplication.deleteSingleFileToAnAppWithUpdateCommand("myApp", "/sample.
txt", "META-INFO/sample.txt")

deleteSingleModuleFileToAnAppWithUpdateCommand

此 Script 使用 update 指令，從已部署的應用程式中刪除單一模組檔案。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 6. deleteSingleModuleFileToAnAppWithUpdateCommand 引數說明。執行 Script 以從已部署的應用程式中刪除模組檔案。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.deleteSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.deleteSingleModuleFileToAnAppWithUpdateCommand("myApp", 
"c:\Increment.jar", "Increment.jar")

AdminApplication.deleteSingleModuleFileToAnAppWithUpdateCommand("myApp", 
"/Increment.jar", "Increment.jar")

deletePartialAppToAnAppWithUpdate指令

此 Script 會使用 update 指令，從已部署的應用程式中刪除局部應用程式。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 7. deletePartialAppToAnAppWithUpdate指令引數說明。執行 Script 以刪除已部署應用程式的一部分。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.deletePartialAppToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.deletePartialAppToAnAppWithUpdateCommand("myApp", "c:\part
ialdelete.zip", "partialdelete")

AdminApplication.deletePartialAppToAnAppWithUpdateCommand("myApp", "/part
ialdelete.zip", "partialdelete")

updateApplicationUsingDefault合併

此 Script 會使用預設合併來更新應用程式。

若要執行 Script ，請指定應用程式名稱及 EAR 檔引數，如下表中所定義:

表 8. updateApplicationUsingDefault合併引數說明。執行 Script 以更新已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`earFile`	指定用來更新應用程式的檔案名稱。

語法

AdminApplication.updateApplicationUsingDefaultMerge(appName, earFile)

範例用法

AdminApplication.updateApplicationUsingDefaultMerge("myApp", "c:\ears\D
efaultApplication.ear")

AdminApplication.updateApplicationUsingDefaultMerge("myApp", "/ears/D
efaultApplication.ear")

updateApplicationWithUpdateIgnoreNew選項

此 Script 會使用 -update.ignore.new 選項來更新應用程式。系統會忽略應用程式新版本的連結。

若要執行 Script ，請指定應用程式名稱及 EAR 檔引數，如下表中所定義:

表 9. updateApplicationWithUpdateIgnoreNew選項引數說明。執行 Script 以更新已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`earFile`	指定用來更新應用程式的檔案名稱。

語法

AdminApplication.updateApplicationWithUpdateIgnoreNewOption(appName, earFile)

範例用法

AdminApplication.updateApplicationWithUpdateIgnoreNewOption("myApp", 
"c:\ears\DefaultApplication.ear")

AdminApplication.updateApplicationWithUpdateIgnoreNewOption("myApp", 
"c:/ears/DefaultApplication.ear")

updateApplicationWithUpdateIgnoreOld選項

此 Script 會使用 -update.ignore.old 選項來更新應用程式。系統會忽略已安裝應用程式版本的連結。

若要執行 Script ，請指定應用程式名稱及 EAR 檔引數，如下表中所定義:

表 10. updateApplicationWithUpdateIgnoreOld選項引數說明。執行 Script 以更新已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`earFile`	指定用來更新應用程式的檔案名稱。

語法

AdminApplication.updateApplicationWithUpdateIgnoreOldOption(appName, earFile)

範例用法

AdminApplication.updateApplicationWithUpdateIgnoreOldOption("myApp", 
"c:\ears\DefaultApplication.ear")

AdminApplication.updateApplicationWithUpdateIgnoreOldOption("myApp", 
"/ears/DefaultApplication.ear")

updateEntireAppToAnAppWithUpdate指令

此 Script 使用 update 指令來更新整個已部署的應用程式。

若要執行 Script ，請指定應用程式名稱及 EAR 檔引數，如下表中所定義:

表 11. updateEntireAppToAnAppWithUpdate指令引數說明。執行 Script 以更新已部署的應用程式。
引數	說明
`appName`	指定要更新的應用程式名稱。
`earFile`	指定用來更新應用程式的檔案名稱。

語法

AdminApplication.updateEntireAppToAnAppWithUpdateCommand(appName, earFile)

範例用法

AdminApplication.updateEntireAppToAnAppWithUpdateCommand("myApp", "c:\new.ear")

AdminApplication.updateEntireAppToAnAppWithUpdateCommand("myApp", "/new.ear")

updatePartialAppToAnAppWithUpdate指令

此 Script 使用 update 指令來更新已部署應用程式的局部應用程式。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 12. updatePartialAppToAnAppWithUpdate指令引數說明。執行 Script 以更新已部署應用程式的一部分。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.updatePartialAppToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.updatePartialAppToAnAppWithUpdateCommand("myApp", "c:\part
ialadd.zip", "partialadd")

AdminApplication.updatePartialAppToAnAppWithUpdateCommand("myApp", "/part
ialadd.zip", "partialadd")

updateSingleFileToAnAppWithUpdate指令

此 Script 使用 update 指令來更新已部署應用程式上的單一檔案。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 13. updateSingleFileToAnAppWithUpdate指令引數說明。執行 Script 以更新已部署應用程式中的檔案。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.updateSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.updateSingleFileToAnAppWithUpdateCommand("myApp", "c:\sample.
txt", "META-INFO/sample.txt")

AdminApplication.updateSingleFileToAnAppWithUpdateCommand("myApp", "/sample.
txt", "META-INFO/sample.txt")

updateSingleModuleFileToAnAppWithUpdateCommand

此 Script 使用 update 指令來更新已部署應用程式的單一模組檔案。

若要執行 Script ，請指定應用程式名稱、檔名及內容 URI 引數，如下表中所定義:

表 14. updateSingleModuleFileToAnAppWithUpdateCommand 引數說明。執行 Script 以更新已部署應用程式中的模組檔案。
引數	說明
`appName`	指定要更新的應用程式名稱。
`fileContent`	指定用來更新應用程式的檔案名稱。
`contentURI`	指定檔案內容的 URI。

語法

AdminApplication.updateSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

範例用法

AdminApplication.updateSingleModuleFileToAnAppWithUpdateCommand("myApp", 
"c:\sample.jar", "Increment.jar")

AdminApplication.updateSingleModuleFileToAnAppWithUpdateCommand("myApp", 
"/sample.jar", "Increment.jar")