您可以使用属性文件来创建、修改或删除 Web 服务器插件属性和定制属性。
开始之前
确定您要对插件属性配置或其配置对象进行的更改。
启动 wsadmin 脚本编制工具。要使用 Jython 语言来启动 wsadmin,请从服务器概要文件的 bin 目录运行 wsadmin -lang jython 命令。
关于此任务
您可以使用属性文件来创建、修改或删除插件对象。您还可以创建、修改或删除插件定制属性。
使用 wsadmin 以运行管理命令来更改插件的属性文件,验证属性,并将其应用于您的配置。
表 1. 插件属性文件的操作. 您可以修改和删除插件对象。操作 |
过程 |
create |
不适用 |
modify |
编辑属性,然后运行 applyConfigProperties 命令以修改定制属性的值。 |
delete |
运行 deleteConfigProperties 命令以删除属性。如果删除的属性具有缺省值,那么该属性将设置为缺省值。 |
create Property |
不适用 |
delete Property |
不适用 |
表 2. 插件定制属性的操作. 您可以创建、修改和删除插件定制属性。操作 |
过程 |
create |
不适用 |
modify |
编辑属性,然后运行 applyConfigProperties 命令以修改现有定制属性的值。 |
delete |
不适用 |
create Property |
设置属性,然后运行 applyConfigProperties 命令以创建定制属性。 |
delete Property |
指定属性文件中要删除的属性,然后运行 deleteConfigProperties 命令来删除现有定制属性。属性文件必须仅包含要删除的属性。 |
您可以选择性地以交互方式使用该命令:
AdminTask.command_name('-interactive')
过程
- 创建或编辑 Web 服务器插件属性文件。
- 根据需要,设置 PluginProperties 对象属性。
打开 PluginProperties 属性文件的编辑器。修改“环境变量”部分来匹配系统并设置需要更改的任何属性值。以下是 PluginProperties 属性文件示例:
#
# 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
- 运行 applyConfigProperties 命令以创建或更改插件属性配置。
运行 applyConfigProperties 命令会将属性文件应用于配置。在此 Jython 示例中,可选的 -reportFileName 参数生成名为 report.txt 的报告:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])
- 创建或编辑 Web 服务器插件定制属性。
- 根据需要,设置 PluginProperties 定制属性。
打开 PluginProperties 属性的编辑器。修改“环境变量”部分来匹配系统并设置需要更改的任何属性值。要指定定制属性,请编辑 AttributeInfo 值和属性值;例如:
#
# 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
- 运行 applyConfigProperties 命令。
- 删除 Web 服务器插件属性。
结果
您可以使用属性文件来配置和管理插件对象及其属性。