Network Deployment (Distributed operating systems), v8.0 > Scripting 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 wsadmin.sh. To start wsadmin using the Jython language, run...

Use 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 the 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 applyConfigProperties.
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

  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 applyConfigProperties to change an application deployment configuration.

    Run applyConfigProperties 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 configure and manage the application deployment object and its properties.


What to do next

Save the changes to the configuration.
Extract 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


Related


PropertiesBasedConfiguration command group using wsadmin.sh

+

Search Tips   |   Advanced Search