You can use properties files to create, modify, or delete
data replication service (DRS) properties and custom properties.
Before you begin
Determine the changes that you want to make to your DRS
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
a DRS instance. You can also create, modify, or delete servlet cache
custom properties.
Run administrative commands using wsadmin
to create or change a properties file for a DRS instance, validate
the properties, and apply them to your configuration.
Table 1. Actions for DRS properties
files. You can create, modify, and delete DRS properties.
Action |
Procedure |
create |
Set required properties and then run the applyConfigProperties command. |
modify |
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 DRSSettings
object, uncomment #DELETE=true and then run the deleteConfigProperties command. |
create Property |
Not applicable |
delete Property |
Not applicable |
Table 2. Actions for
DRS custom properties. You can create, modify, and delete
DRS custom properties.
Action |
Procedure |
create |
Not applicable |
modify |
Run the applyConfigProperties command
to modify the value of an existing custom property. |
delete |
Not applicable |
create Property |
Run the applyConfigProperties command
to create a custom property. |
delete Property |
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 a properties file for a DRSSettings object.
- Set DRSSettings properties as needed.
Open
an editor on a DRSSettings 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. An example DRSSettings properties file follows:
#
# Header
#
ResourceType=DRSSettings
ImplementingResourceType=ServletCacheInstance
ResourceId=Cell=!{cellName}:CacheProvider=myCacheProvider:ServletCacheInstance=jndiName#myServletCacheJndiName:DRSSettings=
AttributeInfo=cacheReplication
#DELETE=true
#
#
#Properties
#
overrideHostConnectionPoints={}
ids={} #integer*
messageBrokerDomainName=null
dataReplicationMode=BOTH #ENUM(SERVER|CLIENT|BOTH),default(BOTH)
preferredLocalDRSBrokerName=null
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
- Run the applyConfigProperties command
to create or change a DRS 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.
- Obtain a properties file for the DRSSettings that you
want to change.
You can extract a properties file for
a DRSSettings object using the extractConfigProperties command.
- Open the properties file in an editor and change the
properties as needed.
Ensure that the environment variables
in the properties file match your system.
To
specify a custom property, edit the AttributeInfo value
and properties values; for example:
#
# Header
#
ResourceType=DRSSettings
ImplementingResourceType=ServletCacheInstance
ResourceId=Cell=!{cellName}:CacheProvider=myCacheProvider:ServletCacheInstance=jndiName#myServletCacheJndiName:DRSSettings=
AttributeInfo=properties(name,value)
#
#Properties
#
existingProp=newValue
newProp=value
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
- Run the applyConfigProperties command.
- If you no longer need the servlet cache or an existing
custom property, you can delete the entire servlet cache object or
the custom property.
Results
You can use the properties file to configure and manage
the DRS object and its properties.
What to do next
Save the changes to your configuration.