You can use properties files to create, modify, or delete
web server plug-in properties and custom properties.
Before you begin
Determine the changes that you want to make to your plug-in
properties 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 plug-in object. You can also create, modify, or delete plug-in custom
properties.
Run administrative commands using wsadmin to change
a properties file for a plug-in, validate the properties, and apply
them to your configuration.
Table 1. Actions for plug-in properties files. You can
modify and delete plug-in objects.
Action |
Procedure |
create |
Not applicable |
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. |
create Property |
Not applicable |
delete Property |
Not applicable |
Table 2. Actions for
plug-in custom properties. You can create, modify, and
delete plug-in 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 a web server plug-in properties file.
- Set PluginProperties object properties as needed.
Open an editor on a PluginProperties properties file.
Modify the Environment Variables section to match your system and
set any property value that needs to be changed. An example PluginProperties
properties file follows:
#
# Header
#
ResourceType=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=pluginProperties
#
#
#Properties
#
LogFilename="c:\Program Files\IBM\HTTPServer\Plugins\logs\IHS\http_plugin.log"
ConfigFilename=plugin-cfg.xml #default(plugin-cfg.xml)
RemoteKeyRingFilename="c:\Program Files\IBM\HTTPServer\Plugins\config\IHS\plugin-key.kdb"
LogLevel=ERROR #ENUM(DETAIL|DEBUG|ERROR|WARN|STATS|TRACE),default(ERROR)
PluginPropagation=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
AcceptAllContent=false #boolean,default(false)
PluginInstallRoot="c:\Program Files\IBM\HTTPServer\Plugins"
IgnoreDNSFailures=false #boolean,default(false)
ESIInvalidationMonitor=false #boolean,default(false)
IISDisableNagle=false #boolean,default(false)
RemoteConfigFilename="c:\Program Files\IBM\HTTPServer\Plugins\config\IHS\plugin-cfg.xml"
PluginGeneration=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
ResponseChunkSize=64 #integer,default(64)
RefreshInterval=60 #integer,default(60)
VHostMatchingCompat=false #boolean,default(false)
ASDisableNagle=false #boolean,default(false)
IISPluginPriority=HIGH #ENUM(MEDIUM|HIGH|LOW),default(HIGH)
KeyRingFilename=plugin-key.kdb #default(plugin-key.kdb)
ChunkedResponse=false #boolean,default(false)
ESIEnable=true #boolean,default(true)
ESIMaxCacheSize=1024 #integer,default(1024)
AppServerPortPreference=HOSTHEADER #ENUM(WEBSERVERPORT|HOSTHEADER),default(WEBSERVERPORT)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
nodeName=myNode04
serverName=IHS
- Run the applyConfigProperties command to create or change
a plug-in properties 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 web server plug-in custom properties.
- Set PluginProperties custom properties as needed.
Open an editor on a PluginProperties properties. 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=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=properties(name,value)
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
nodeName=myNode04
serverName=IHS
- Run the applyConfigProperties command.
- Delete a web server plug-in property.
Results
You can use the properties file to configure and manage
the plug-in object and its properties.
What to do next
Save the changes to your configuration.