You can use properties files to create, modify, or delete
object pool properties and custom properties.
Before you begin
Determine the changes that you want to make to your object
pool configuration or its configuration objects.
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
an object pool instance. You can also create, modify, or delete object
pool custom properties.
Run administrative commands using wsadmin
to create or change a properties file for an object pool, validate
the properties, and apply them to your configuration.
Table 1. Actions for object pool properties
files. You can create, modify, and delete object pool
instances.Action |
Procedure |
create |
Set required properties and then run the applyConfigProperties
command. |
modify |
Edit properties and then run the applyConfigProperties
command to modify the value of a custom property. |
delete |
Run the deleteConfigProperties command to delete
a property. If the deleted property has a default value, the property
is set to the default value. To delete the entire ObjectPool instance,
uncomment #DELETE=true and then run the deleteConfigProperties
command. |
create Property |
Not applicable |
delete Property |
Not applicable |
Table 2. Actions for
object pool custom properties. You can create, modify,
and delete object pool custom properties.Action |
Procedure |
create |
Not applicable |
modify |
Edit properties and then run the applyConfigProperties
command to modify the value of an existing custom property. |
delete |
Not applicable |
create Property |
Set properties and then run the applyConfigProperties
command to create a custom property. |
delete Property |
Specify the properties to delete in the properties
file and then run the deleteConfigProperties command 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
- Create or edit an object pool properties file.
- Set ObjectPool object properties as needed.
Open
an editor on an ObjectPool properties file. Modify the Environment
Variables section to match your system and set any property value
that needs to be changed. An example ObjectPool properties file follows:
#
# Header
#
ResourceType=ObjectPool
ImplementingResourceType=ObjectPoolManagerInfo
ResourceId=Cell=!{cellName}:ObjectPoolProvider= myObjectPoolProvider:ObjectPoolManagerInfo=
jndiName#myObjPoolJndiName:ObjectPool=poolClassName#abc,poolImplClassName#abc
AttributeInfo=objectPools
#DELETE=true
#
#Properties
#
#
#Properties
#
poolClassName=abc #required
poolImplClassName=abc #required
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
- Run the applyConfigProperties command to change an object
pool 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 '])
- Create or edit object pool custom properties.
- Set ObjectPool custom properties as needed.
Open
an editor on an ObjectPool properties file. Modify the Environment
Variables section to match your system and set any property value
that needs to be changed. To specify a custom property, edit the AttributeInfo value
and properties values; for example:
#
# Header
#
ResourceType=ObjectPool
ImplementingResourceType=ObjectPoolManagerInfo
ResourceId=Cell=!{cellName}:ObjectPoolProvider=myObjectPoolProvider:ObjectPoolManagerInfo=
jndiName#myObjPoolJndiName:ObjectPool=poolClassName#abc,poolImplClassName#abc
AttributeInfo=properties(name,value)
#
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
- Run the applyConfigProperties command.
- If you no longer need the object pool or an existing custom
property, you can delete the entire object pool object or the custom
property.
Results
You can use the properties file to configure and manage
the object pool instance and its properties.
What to do next
Save the changes to your configuration.