Work with application configuration web module properties files

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.

Run: wsadmin -lang jython

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

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

Optionally, we can use interactive mode with the commands:

AdminTask.command_name('-interactive')

Tasks

• 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 the applyConfigProperties command to create or change a web module.

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

• Modify an existing properties file.
  1. Obtain a properties file for the web module 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 the applyConfigProperties command.

• If we no longer need the web module, we 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 the deleteConfigProperties command; for example:

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

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.

Subtopics

• Work with web module configuration session manager properties files
  Use properties files to create, modify, or delete session manager objects of a web module configuration.

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 .