You can use properties files to create, modify, or delete
web module configuration objects of an application configuration.
A web module must conform to Java Platform,
Enterprise Edition (Java EE) specifications.
Before you begin
Determine the changes that you want to make to a web module
of an application 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.
About this task
Using 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 your configuration.
Table 1. Actions for application configuration web module
configuration properties files. You can create, modify,
and delete web module configuration properties.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, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create a properties file for an ApplicationConfig WebModuleConfig
object.
- Set ApplicationConfig WebModuleConfig properties as
needed.
Open an editor on an ApplicationConfig WebModuleConfig
properties file. Modify the Environment Variables section to match
your 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
- 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.
- Obtain a properties file for the web module that you
want to change.
You can extract a properties file for
an ApplicationConfig WebModuleConfig object using the extractConfigProperties command.
- Open the properties file in an editor and change the
properties as needed.
Ensure that the environment variables
in the properties file match your system.
- Run the applyConfigProperties command.
- 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 the deleteConfigProperties command;
for example:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
the web module object and its properties.
What to do next
Save the changes to your configuration.