Work with application configuration properties files

We can use properties files to create, modify, or delete application configuration objects.

Determine the changes to make to an application configuration object.

From the server profile bin directory, run wsadmin -lang jython

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

properties files. We can create, modify, and delete

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

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

Results

We can 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
  We can use properties files to create, modify, or delete session manager objects of an application configuration.

• 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.

• Work with application configuration EJB module properties files
  We can 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.

Related tasks

Extracting properties files

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

PropertiesBasedConfiguration (AdminTask)