Application update scripts

The scripting library provides multiple script procedures to automate your application configurations. See the usage information for scripts that update applications. You can run each script individually or combine procedures to create custom automation scripts for your environment.

Each application management script procedure is located in the app_server_root/scriptLibraries/application/V70 directory. Use the following script procedures to update application configurations:

addSingleFileToAnAppWithUpdateCommand
addSingleModuleFileToAnAppWithUpdateCommand
addUpdateSingleModuleFileToAnAppWithUpdateCommand
addPartialAppToAnAppWithUpdateCommand
deleteSingleFileToAnAppWithUpdateCommand
deleteSingleModuleFileToAnAppWithUpdateCommand
deletePartialAppToAnAppWithUpdateCommand
updateApplicationUsingDefaultMerge
updateApplicationWithUpdateIgnoreNewOption
updateApplicationWithUpdateIgnoreOldOption
updateEntireAppToAnAppWithUpdateCommand
updatePartialAppToAnAppWithUpdateCommand
updateSingleFileToAnAppWithUpdateCommand
updateSingleModuleFileToAnAppWithUpdateCommand

addSingleFileToAnAppWithUpdateCommand

This script uses the update command to add a single file to a deployed application.

To run the script, specify the application name, file name, and the content uniform resource identifier (URI) arguments, as defined in the following table:

Table 1. addSingleFileToAnAppWithUpdateCommand argument descriptions . Run the script to add a file to a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.addSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

addSingleModuleFileToAnAppWithUpdateCommand

This script uses the update command to add a single module file to a deployed application.

To run the script, specify the application name, file name, and content URI arguments, as defined in the following table:

Table 2. addSingleModuleFileToAnAppWithUpdateCommand argument descriptions . Run the script to add a module file to a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.addSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

addUpdateSingleModuleFileToAnAppWithUpdateCommand

This script uses the update command to add and update a single module file for a deployed application.

To run the script, specify the application name, file name, content URI, and context root arguments, as defined in the following table:

Table 3. addUpdateSingleModuleFileToAnAppWithUpdateCommand argument descriptions . Run the script to update a file in a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.
`contextRoot`	Specifies the context root for web modules in the application.

Syntax

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

Example usage

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

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

addPartialAppToAnAppWithUpdateCommand

This script uses the update command to add a partial application to a deployed application.

To run the script, specify the application name and file content arguments, as defined in the following table:

Table 4. addPartialAppToAnAppWithUpdateCommand argument descriptions . Run the script to update part of a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.

Syntax

AdminApplication.addPartialAppToAnAppWithUpdateCommand(appName, fileContent)

Example usage

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

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

deleteSingleFileToAnAppWithUpdateCommand

This script uses the update command to delete a single file from a deployed application.

To run the script, specify the application name, file name, and content URI arguments, as defined in the following table:

Table 5. deleteSingleFileToAnAppWithUpdateCommand argument descriptions . Run the script to delete a file from a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.deleteSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

deleteSingleModuleFileToAnAppWithUpdateCommand

This script uses the update command to delete a single module file from a deployed application.

To run the script, specify the application name, file name, and content URI arguments, as defined in the following table:

Table 6. deleteSingleModuleFileToAnAppWithUpdateCommand argument descriptions . Run the script to delete a module file from a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.deleteSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

deletePartialAppToAnAppWithUpdateCommand

This script uses the update command to delete a partial application from a deployed application.

To run the script, specify the application name, file name, and the content URI arguments, as defined in the following table:

Table 7. deletePartialAppToAnAppWithUpdateCommand argument descriptions . Run the script to delete part of a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.deletePartialAppToAnAppWithUpdateCommand(appName, 
fileContent, contentURI)

Example usage

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

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

updateApplicationUsingDefaultMerge

This script updates an application using default merging.

To run the script, specify the application name and EAR file arguments, as defined in the following table:

Table 8. updateApplicationUsingDefaultMerge argument descriptions . Run the script to update a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`earFile`	Specifies the name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationUsingDefaultMerge(appName, earFile)

Example usage

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

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

updateApplicationWithUpdateIgnoreNewOption

This script updates an application using -update.ignore.new option. The system ignores the bindings from the new version of the application.

To run the script, specify the application name and EAR file arguments, as defined in the following table:

Table 9. updateApplicationWithUpdateIgnoreNewOption argument descriptions . Run the script to update a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`earFile`	Specifies the name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationWithUpdateIgnoreNewOption(appName, earFile)

Example usage

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

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

updateApplicationWithUpdateIgnoreOldOption

This script updates an application using the -update.ignore.old option. The system ignores the bindings from the installed version of the application.

To run the script, specify the application name and EAR file arguments, as defined in the following table:

Table 10. updateApplicationWithUpdateIgnoreOldOption argument descriptions . Run the script to update a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`earFile`	Specifies the name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationWithUpdateIgnoreOldOption(appName, earFile)

Example usage

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

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

updateEntireAppToAnAppWithUpdateCommand

This script uses the update command to update an entire deployed application.

To run the script, specify the application name and EAR file arguments, as defined in the following table:

Table 11. updateEntireAppToAnAppWithUpdateCommand argument descriptions . Run the script to update a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`earFile`	Specifies the name of the file to use to update the application.

Syntax

AdminApplication.updateEntireAppToAnAppWithUpdateCommand(appName, earFile)

Example usage

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

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

updatePartialAppToAnAppWithUpdateCommand

This script uses the update command to update a partial application for a deployed application.

To run the script, specify the application name, file name,and the content URI arguments, as defined in the following table:

Table 12. updatePartialAppToAnAppWithUpdateCommand argument descriptions . Run the script to update part of a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.updatePartialAppToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

updateSingleFileToAnAppWithUpdateCommand

This script uses the update command to update a single file on a deployed application.

To run the script, specify the application name, file name, and the content URI arguments, as defined in the following table:

Table 13. updateSingleFileToAnAppWithUpdateCommand argument descriptions . Run the script to update a file in a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.updateSingleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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

updateSingleModuleFileToAnAppWithUpdateCommand

This script uses the update command to update a single module file for a deployed application.

To run the script, specify the application name, file name, and the content URI arguments, as defined in the following table:

Table 14. updateSingleModuleFileToAnAppWithUpdateCommand argument descriptions . Run the script to update a module file in a deployed application.
Argument	Description
`appName`	Specifies the name of the application to update.
`fileContent`	Specifies the name of the file to use to update the application.
`contentURI`	Specifies the URI of the file content.

Syntax

AdminApplication.updateSingleModuleFileToAnAppWithUpdateCommand(appName, fileContent, contentURI)

Example usage

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

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