WAS v8.5 > Script the application serving environment (wsadmin) > Use properties files to manage system configuration > Manage specific configuration objects using properties files > Use application properties files to install, update, and delete enterprise application files

Work with application deployment properties files

We can 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. Using a properties file, we 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.

Actions for application deployment properties files. We 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, we can use interactive mode with the commands:

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


Results

We can use the properties file to manage the application deployment object and its properties.

Save the changes to your configuration.


Subtopics


Related


Extracting properties files using wsadmin.sh
Create server, cluster, application, or authorization group objects using properties files and wsadmin scripting
Delete server, cluster, application, or authorization group objects using properties files


Reference:

PropertiesBasedConfiguration command group for AdminTask using wsadmin.sh


+

Search Tips   |   Advanced Search