Work with application configuration properties files

Use properties files to create, modify, or delete application configuration objects.

Determine the changes to make to an application configuration object.

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.

Use a properties file to create, modify, or delete an application configuration.

Run administrative commands using wsadmin to create or change a properties file for an application configuration, 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 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 object.

  1. Set ApplicationConfig properties as needed.

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

     #
     # Header
     #
     ResourceType=ApplicationConfig
     ImplementingResourceType=Application
     ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:ApplicationConfig=
     #DELETE=true
     #
     
     #
     #Properties
     #
     enableSFSBFailover=false #boolean,default(false)
     overrideDefaultDRSSettings=false #boolean,default(false)
     
     #
     EnvironmentVariablesSection
     #
     #
     #Environment Variables
     cellName=myCell04
     applicationName=myApp
     

  2. Run the applyConfigProperties command to create or change an application 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 '])
     

• Modify an existing properties file.
  1. Obtain a properties file for the application configuration to change.

     We can extract a properties file for an ApplicationConfig 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 application configuration, we can delete the entire application configuration 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 application configuration object and its properties.

What to do next

Save the changes to the configuration.

Subtopics

• Work with application configuration session manager properties files
  Use properties files to create, modify, or delete session manager objects of an application configuration.
• 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.
• Work with application configuration EJB module properties files
  Use properties files to create, modify, or delete EJB module configuration objects of an application configuration. An EJB module must conform to Java EE specifications.

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 .