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 > Work with application configuration properties files

Work with application configuration web module properties files

We can use properties files to create, modify, or delete web module configuration objects of an application configuration. A web module must conform to Java EE specifications.

Determine the changes to make to a web module of an application configuration.

Start the wsadmin scripting tool.

To start wsadmin using the Jython language, run...

WP_PROFILE/bin/wsadmin -lang jython

Use a properties file, you can create, modify, or delete a web module.

Run administrative commands using wsadmin to create or change a properties file for a web module, validate the properties, and apply them to the configuration.

Actions for application configuration web module configuration properties files. We can create, modify, and delete web module configuration properties.

Action	Procedure
create	Set required properties and then run applyConfigProperties.
modify	Make required changes to properties and then run applyConfigProperties.
delete	To delete the entire ApplicationConfig WebModuleConfig object, uncomment #DELETE=true and then run deleteConfigProperties.
create Property	Not applicable
delete Property	Not applicable

Optionally, you can use interactive mode with the commands:

AdminTask.command_name('-interactive')

Procedure

• Create a properties file for an ApplicationConfig WebModuleConfig object.

  1. Set ApplicationConfig WebModuleConfig properties as needed.

     Open an editor on an ApplicationConfig WebModuleConfig properties file. Modify the Environment Variables section to match the system and set any property value that needs to be changed. An example ApplicationConfig WebModuleConfig properties file follows:

     #
     # Header (ApplicationConfig Session Manager)
     #
     ResourceType=WebModuleConfig
     ImplementingResourceType=Application ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:ApplicationConfig=: WebModuleConfig =myWebModule
     #DELETE=true
     #
     
     #
     #Properties
     #
     name=myWebModule
     description=null
     #
     EnvironmentVariablesSection
     #
     #
     #Environment Variables
     cellName=myCell04
     applicationName=myApp
     

  2. Run applyConfigProperties to create or change a web module.

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

• Modify an existing properties file.
  1. Obtain a properties file for the web module that you want to change.

     We can extract a properties file for an ApplicationConfig WebModuleConfig object using the extractConfigProperties command.

  2. Open the properties file in an editor and change the properties as needed.

     Ensure that the environment variables in the properties file match the system.

  3. Run applyConfigProperties.

• If you no longer need the web module, you can delete the entire web module object.

  To delete the entire object, specify DELETE=true in the header section of the properties file and run deleteConfigProperties; for example:

  AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
  

Results

We can use the properties file to configure and manage the web module 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