Manage environment configurations using properties files
Use this topic to modify the environment using properties files. Use wsadmin to generate, validate and apply properties files in the appserver, profile, node, or other resource configurations.
Use the PropertiesBasedConfiguration command group for AdminTask, we can extract the configuration attributes and values from the environment to properties files. Use this functionality for various purposes, including:
- To modify the existing configuration in one location, instead of configuring multiple admin console panels or running many commands
- To improve the application development life cycle
Use this topic to manage the following resources in the environment:
- Application servers
- Virtual hosts
- Authorization tables
- Data replication domains
- Variable maps
- Java™ Database Connectivity (JDBC) providers
- URL providers
- Mail providers
- Resource environment providers
- Java™ 2 Connector (J2C) resource adapters
We cannot apply a z/OS operating system properties file directly to a distributed operating system. Similarly, we cannot apply a distributed operating system properties file directly to a z/OS operating system. gotcha Complete the following steps to extract a properties file for an appserver, edit the properties, and apply them to the configuration. We can also use interactive mode with these commands, as the following syntax demonstrates:AdminTask.commandName('-interactive')
Modify an appserver configuration, and apply the changes using a properties file.
- Launch wsadmin.
- Extract the appserver configuration to modify.
Use the extractConfigProperties command to extract the object configuration, as the following Jython example demonstrates:AdminTask.extractConfigProperties('-propertiesFileName ConfigProperties_server1.props -configData Server=server1')
The system extracts the properties file, which contains each of the configuration objects and attributes for the server1 appserver.
- Open the properties file, and manually edit the attribute values of interest.
Because we are manually editing the properties file, make a back-up copy of the properties file before you edit it. gotcha
The following sample is a section of an application server properties file:# # Configuration properties file for cells/myCell/nodes/myNode/servers/server1|server.xml# # Extracted on Thu Sep 06 00:27:26 CDT 2007 # # # Section 1.0 ## cells/myCell/nodes/myNode/servers/server1|server.xml#server1 # # # SubSection 1.0 # Server Section # ResourceType=Server ImplementingResourceType=Server ResourceId=cells/myCell/nodes/myNode/servers/server1|server.xml#server1 # # #Properties # shortName=null serverType=APPLICATION_SERVER developmentMode=false # boolean name=server1 parallelStartEnabled=true #boolean clusterName=C modelId=null uniqueId=null #
To modify the appserver to run in development mode and disable parallel start, modify the developmentMode and parallelStartEnabled properties...# # Configuration properties file for cells/myCell/nodes/myNode/servers/server1|server.xml# # Extracted on Thu Sep 06 00:27:26 CDT 2007 # # # Section 1.0 ## cells/myCell/nodes/myNode/servers/server1|server.xml#server1 # # # SubSection 1.0 # Server Section # ResourceType=Server ImplementingResourceType=Server ResourceId=cells/myCell/nodes/myNode/servers/server1|server.xml#server1 # # #Properties # shortName=null serverType=APPLICATION_SERVER developmentMode=true #boolean name=server1 parallelStartEnabled=false #boolean clusterName=C modelId=null uniqueId=null #
- Validate the properties file.
Best practice: As a best practice, use the validateConfigProperties command to validate the modified properties file before applying the changes, as the following Jython example demonstrates:bpracAdminTask.validateConfigProperties('-propertiesFileName ConfigProperties_server1.props -reportFile report.txt')
The command returns a value of true if the system successfully validates the properties file. The command returns a value of false if the system does not validate the file.
- Apply the changes to the appserver. Use the applyConfigProperties command to apply the changes to the application server.AdminTask.applyConfigProperties('-propertiesFileName ConfigProperties_server1.props -validate true')
- Save the configuration changes.AdminConfig.save()
Extracting properties files
Applying properties files
Validating properties files
Create server, cluster, application, or authorization group objects using properties files
Delete server, cluster, application, or authorization group objects using properties files
Create and deleting configuration objects using properties files
Extracting properties files to troubleshoot the environment
Manage servers and nodes with scripting