Application update scripts

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

Each application management script procedure is located in...

$WAS_HOME/scriptLibraries/application/V70

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	Name of the file to use to update the application.
contentURI	Specifies the URI of the file content.
contextRoot	Context root for Web modules in the application.

Syntax

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

Example usage

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	Name of the file to use to update the application.

Syntax

AdminApplication.addPartialAppToAnAppWithUpdateCommand(appName, fileContent)

Example usage

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

AdminApplication.deletePartialAppToAnAppWithUpdateCommand("myApp", "/part ialdelete.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

Argument	Description
appName	Name of the application to update.
earFile	Name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationUsingDefaultMerge(appName, earFile)

Example usage

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

AdminApplication.updateApplicationUsingDefaultMerge("myApp", "/ears/D efaultApplication.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

Argument	Description
appName	Name of the application to update.
earFile	Name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationWithUpdateIgnoreNewOption(appName, earFile)

Example usage

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
earFile	Name of the file to use to update the application.

Syntax

AdminApplication.updateApplicationWithUpdateIgnoreOldOption(appName, earFile)

Example usage

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
earFile	Name of the file to use to update the application.

Syntax

AdminApplication.updateEntireAppToAnAppWithUpdateCommand(appName, earFile)

Example usage

(Windows)

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

AdminApplication.updatePartialAppToAnAppWithUpdateCommand("myApp", "/part ialadd.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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

Argument	Description
appName	Name of the application to update.
fileContent	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

(Windows)

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

[AIX] [Solaris]

[Linux] [HP-UX]

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

---

 

Related tasks

Use the script library to automate the application serving environment
Automating application configurations using the scripting library
Application administration scripts

 

Related

Application installation and uninstallation scripts
Application query scripts
Application export scripts
Application deployment configuration scripts