You can use properties files to modify enterprise application
deployment properties. An enterprise application must conform to Java™ Platform, Enterprise Edition
(Java EE) specifications.
Before you begin
Determine the changes that you want to make to your application
deployment configuration.
Start the wsadmin scripting tool.
To start wsadmin using the Jython language, run the wsadmin
-lang jython
command from the bin directory
of the server profile.
About this task
Using a properties file, you can modify an application
deployment object. This task resembles editing the deployment options
of an application, except it uses an ApplicationDeployment resource
type instead of an Application resource type and it specifies more
properties.
Run administrative commands using wsadmin to change
a properties file for an application deployment, validate the properties,
and apply them to your configuration.
Table 1. Actions for application deployment properties files . You can modify application deployment properties.
Action |
Procedure |
create |
Not applicable |
modify |
Edit the properties file and then run the applyConfigProperties command. |
delete |
Not applicable |
create Property |
Not applicable |
delete Property |
Not applicable |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Edit an application deployment configuration.
For
example, specify properties such as the following for an ApplicationDeployment
instance:
ResourceType=ApplicationDeployment
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
#
#
#Properties
#
recycleOnUpdate=PARTIAL #ENUM(PARTIAL|NONE|FULL),default(PARTIAL)
allowDispatchRemoteInclude=false #boolean,default(false)
autoLink=false #boolean,default(false)
expandSynchronously=false #boolean,default(false)
zeroBinaryCopy=false #boolean,default(false)
allowServiceRemoteInclude=false #boolean,default(false)
warClassLoaderPolicy=MULTIPLE #ENUM(MULTIPLE|SINGLE),required,default(MULTIPLE)
asyncRequestDispatchType=null #ENUM(CLIENT_SIDE|DISABLED|SERVER_SIDE)
filePermission=".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755"
enableDistribution=true #boolean,default(true)
deploymentId=0 #required
startingWeight=1 #integer,required,default(1)
zeroEarCopy=false #boolean,default(false)
backgroundApplication=false #boolean,default(false)
reloadInterval=3 #long,default(3)
useMetadataFromBinaries=false #boolean,default(false)
reloadEnabled=false #boolean,default(true)
appContextIDForSecurity="href:IBM-49F7FB781FENode01Cell/DefaultApplication"
createMBeansForResources=false #boolean,default(false)
binariesURL="$(APP_INSTALL_ROOT)/$(CELL)/DefaultApplication.ear" #required
startOnDistribute=false #boolean,default(false)
#
# Header ( ApplicationDeployment ClassLoader)
#
ResourceType=Classloader
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:Classloader=
#
#
#Properties
#
mode=PARENT_FIRST #ENUM(PARENT_FIRST|PARENT_LAST),default(PARENT_FIRST)
#
# Header (ApplicationDeployment ClassLoader's LibraryRef )
#
ResourceType=LibraryRef
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:Classloader=:LibraryRef=libraryName#myLibName
#
#
#Properties
#
libraryName=myLibName
sharedClassLoader=null
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
applicationName=myApp
- Run the applyConfigProperties command
to change an application deployment configuration.
Running
the applyConfigProperties command applies the properties
file to the configuration. In this Jython example, the optional -reportFileName
parameter
produces a report named report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])
Results
You can use the properties file to configure and manage
the application deployment object and its properties.
What to do next
Save the changes to your configuration.