Network Deployment (Distributed operating systems), v8.0 > Scripting the application serving environment (wsadmin) > Use properties files to manage system configuration > Manage specific configuration objects using properties files
Work with work area service properties files
We can use properties files to change work area service configuration objects and custom properties.
Determine the changes to make to your work area service configuration objects or custom properties.
Start wsadmin.sh.
To start wsadmin using the Jython language, run...
WP_PROFILE/bin/wsadmin -lang jython
Use a properties file, you can modify or delete a work area service object. We can also create, modify, or delete work area service custom properties.
Run administrative commands using wsadmin to change a properties file for a work area service, validate the properties, and apply them to the configuration.
Actions for work area service configuration objects. We can modify and delete work area service objects.
Action Procedure create Not applicable modify Edit properties and then run applyConfigProperties. delete Run deleteConfigProperties. Deleting a property sets the default value, if there is a default value for the property create Property Not applicable delete Property Not applicable
Actions for work area service custom properties. We can create, modify, and delete work area service custom properties.
Action Procedure create Not applicable modify Edit properties and then run applyConfigProperties to modify the value of an existing custom property. delete Not applicable create Property Set properties and then run applyConfigProperties to create a custom property. delete Property Specify the properties to delete in the properties file and then run deleteConfigProperties to delete an existing custom property. The properties file must contain only the properties to be deleted. Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Edit a work area service properties file.
- Set WorkAreaService object properties as needed.
Open an editor on a WorkAreaService properties file. Modify the Environment Variables section to match the system and set any property value that needs to be changed. An example WorkAreaService properties file follows:
# # Header # ResourceType=WorkAreaService ImplementingResourceType=PMEServerExtension ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:PMEServerExtension=:WorkAreaService= AttributeInfo=workAreaService # # #Properties # maxReceiveSize=10000 #integer,required,default(32768) enable=false #boolean,default(false) context=null maxSendSize=10000 #integer,required,default(32768) enableWebServicePropagation=false #boolean,default(false) # EnvironmentVariablesSection # # #Environment Variables cellName=myCell04 serverName=server1 nodeName=myNode05- Set WorkAreaService custom properties as needed.
To specify a custom property, edit the AttributeInfo value and properties values; for example:
# # Header # ResourceType=WorkAreaService ImplementingResourceType=PMEServerExtension ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:PMEServerExtension=:WorkAreaService= AttributeInfo=properties(name,value) # # #Properties # existingProp=value newProp=newValue # EnvironmentVariablesSection # # #Environment Variables cellName=myCell04 serverName=server1 nodeName=myNode05- Run applyConfigProperties to change a work area service configuration.
Run applyConfigProperties 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'])
- If you no longer need the work area service or an existing custom property, you can delete the entire work area service object or the custom property.
- To delete the entire object, run deleteConfigProperties; for example:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
- To delete a custom property, specify only the property to be deleted in the properties file and then run deleteConfigProperties.
Results
We can use the properties file to manage the work area service object and its properties.
What to do next
Save the changes to the configuration.
Extract properties files using wsadmin.sh
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
Related
PropertiesBasedConfiguration command group using wsadmin.sh