You can use properties files to change dynamic cache properties
under a server.
Before you begin
Determine the changes that you want to make to your dynamic
cache 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 modify a dynamic cache
object and its configuration properties.
Run administrative
commands using wsadmin to change a properties file for a dynamic cache,
validate the properties, and apply them to your configuration.
Table 1. Actions for dynamic cache
properties files. You can create, modify and delete dynamic
cache properties.Action |
Procedure |
create |
Not available |
modify |
Edit properties and then run the applyConfigProperties command. |
delete |
Not available |
create Property |
Set properties and then run the applyConfigProperties command. |
delete Property |
To delete one or more properties, run deleteConfigProperties with
only those properties to delete in the properties file. |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create or edit dynamic cache properties under a server.
- Specify DynamicCache properties in a properties file.
Open an editor on a properties file. Example properties
for a DynamicCache under a server follow. A property under DynamicCache
has a name of myName and a value of myVal.
You can copy the example properties into an editor and modify them
as needed for your situation.
#
# SubSection 1.0 # DynamicCache
#
ResourceType=DynamicCache
ImplementingResourceType=DynamicCache
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:DynamicCache=
AttributeInfo=services
#
#
#Properties
#
defaultPriority=1 #integer,required,default(1)
diskOffloadLocation=null
context=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer= #ObjectName(ApplicationServer),readonly
flushToDiskOnStop=false #boolean,default(false)
enableCacheReplication=false #boolean,default(false)
diskCachePerformanceLevel=BALANCED #ENUM(HIGH|CUSTOM|BALANCED|LOW),default(BALANCED)
enableDiskOffload=false #boolean,default(false)
replicationType=NONE #ENUM(PULL|PUSH|PUSH_PULL|NONE),default(NONE)
diskCacheEntrySizeInMB=0 #integer,default(0)
enable=true #boolean,default(false)
cacheSize=2000 #integer,required,default(2000)
diskCacheSizeInGB=0 #integer,default(0)
pushFrequency=1 #integer,default(1)
hashSize=0 #integer,default(0)
diskCacheCleanupFrequency=0 #integer,default(0)
diskCacheSizeInEntries=0 #integer,default(0)
enableTagLevelCaching=false #boolean,default(false)
#
# Header
#
ResourceType=DynamicCache
ImplementingResourceType=DynamicCache
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:DynamicCache=
AttributeInfo=properties(name,value)
#
#
#Properties
#
myName=myVal
#
EnvironmentVariablesSection
#
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Run the applyConfigProperties command
to change a DynamicCache 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'])
- Delete dynamic cache properties.
To delete
one or more properties, specify only those properties to delete in
the properties file and run deleteConfigProperties; for example:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
dynamic cache properties.
What to do next
Save the changes to your configuration.