Work with application deployment properties files

Use properties files to modify enterprise application deployment properties. An enterprise application must conform to Java EE specifications.

Determine the changes to make to the 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.

Use a properties file to 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 the configuration.

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, we can use interactive mode with the commands:

AdminTask.command_name('-interactive')

Tasks

1. 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
   

2. 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'])
   

Use the properties file to configure and manage the application deployment object and its properties.

What to do next

Save the changes to the configuration.

Subtopics

• Work with web module deployment properties files
  
• Work with EJB module deployment properties files
  
• Work with application configuration properties files
  

Extracting properties files

Create server, cluster, application, or authorization group objects using properties files and wsadmin scripting

Deleting server, cluster, application, or authorization group objects using properties files

PropertiesBasedConfiguration .