How can I modify the web server's plug-in (plugin-cfg.xml) properties from the WebSphere Application Server administrative console?
IBM recommends that modifications to the web server plug-in properties be made from the WebSphere Application Server administrative console so any changes are persisted when a new plugin-cfg.xml file is generated and propagated to the web server.
The following information is provided as a guide to assist you in determining where to make specific plug-in property changes from the WebSphere Application Server administrative console.
- Plug-in properties
- Plug-in properties > Request and response
- Plug-in properties > Caching
- Plug-in properties > Request routing
- cluster_member_name > Web server plug-in properties
- cluster_name > Cluster members
- cluster_member_name > Session management
- application_name > Session management
- Web server plug-in custom properties
- Additional resources
Excerpt from plugin-cfg.xml file (Plug-in properties):
IgnoreDNSFailures="false" RefreshInterval="60" ResponseChunkSize="64" VHostMatchingCompat="false"> Files/IBM/WebSphere/Plugins/logs/webserver/http_plugin.log"/> ...
plugin-key.kdb"/>
|
The following plug-in properties have been highlighted in the preceding excerpt:
- IgnoreDNSFailures
- RefreshInterval
- KeyRing
- Log Name
- Log Level
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Web Servers > web_server_name > Plug-in properties):
Excerpt from plugin-cfg.xml file (Request and response):
ASDisableNagle="false" AcceptAllContent="false" AppServerPortPreference="HostHeader" ChunkedResponse="false" FIPSEnable="false"IISDisableNagle="false" IISPluginPriority="High" IgnoreDNSFailures="false" RefreshInterval="60" ResponseChunkSize="64" VHostMatchingCompat="false"> |
The following plug-in properties have been highlighted in the preceding excerpt:
- ResponseChunkSize
- ASDisableNagle
- IISDisableNagle*
- ChunkedResponse
- AcceptAllContent
- VhostMatchingCompat
- AppServerPortPreference
- IISPluginPriority*
*Only available for IIS defined web servers.
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Web Servers > web_server_name > Plug-in properties > Request and response):
Excerpt from plugin-cfg.xml file (Caching):
The following plug-in properties have been highlighted in the preceding excerpt:
- ESIEnable
- ESIInvalidationMonitor
- ESIMaxCacheSize
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Web Servers > web_server_name > Plug-in properties > Caching):
Excerpt from plugin-cfg.xml file (Request routing):
CloneSeparatorChange="false" GetDWLMTable="false" LoadBalance="Round Robin" Name="wp_cluster" PostBufferSize="64" PostSizeLimit="-1" RemoveSpecialHeaders="true" RetryInterval="60"> |
The following plug-in properties have been highlighted in the preceding excerpt:
- LoadBalance option
- RetryInterval
- PostSizeLimit
- PostBufferSize
- RemoveSpecialHeaders
- CloneSeparatorChange
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Web Servers > web_server_name > Plug-in properties > Request routing):
Excerpt from plugin-cfg.xml file ( cluster_member_name > Web server plug-in properties)
ConnectTimeout="0" ExtendedHandshake="false" LoadBalanceWeight="2" MaxConnections="-1" Name="Cluster_Mem_1"ServerIOTimeout="0" WaitForContinue="false"> ...
|
The following plug-in properties have been highlighted in the preceding excerpt:
- Primary or Backup Server Designation
- ConnectTimeOut
- ServerIOTimeout*
- MaxConnections
- ExtendedHandshake
- WaitForContinue
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Application Servers >cluster_member_name > Web server plug-in properties):
*This is from a version 6.1 administrative console. Version 6.0 requires
ServerIOTimeout to be set as a
Webserver > Plug-in Properties > Custom Properties.
Excerpt from plugin-cfg.xml file ( cluster_name > Cluster members) :
LoadBalanceWeight="0" MaxConnections="-1" Name="Cluster_Mem_1" ServerIOTimeout="0" WaitForContinue="false"> ... LoadBalanceWeight="2" MaxConnections="-1" Name="Cluster_Mem_2" ServerIOTimeout="0" WaitForContinue="false"> |
The following plug-in property has been highlighted in the preceding excerpt:
- LoadBalanceWeight
This plug-in property can be found and modified in the WebSphere Application Server administrative console (
Server clusters > cluster_name > Cluster members):
Excerpt from plugin-cfg.xml file ( cluster_member_name > Session management) :
Server_ID" AffinityURLIdentifier="jsessionid" Name="/PlantsByWebSphere/*"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/PlantsByWebSphere/docs/*"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wps/*"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wsrp/*"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wps/config/*"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wps/config/*.jsp"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wps/config/*.jsv"/> Server_ID" AffinityURLIdentifier="jsessionid" Name="/wps/config/*.jsw"/>
|
The following plug-in property has been highlighted in the preceding excerpt:
- Set a custom Cookie ID for a server
This plug-in property can be found and modified in the WebSphere Application Server administrative console (
Servers > Application Servers >cluster_member_name > Session management):
Excerpt from plugin-cfg.xml file ( application_name > Session management) :
Deployment_ID" AffinityURLIdentifier="jsessionid" Name="/PlantsByWebSphere/*"/> Deployment_ID" AffinityURLIdentifier="jsessionid" Name="/PlantsByWebSphere/docs/*"/>
|
The following plug-in property has been highlighted in the preceding excerpt:
- Set a custom Cookie ID for an application
This plug-in property can be found and modified in the WebSphere Application Server administrative console (
Enterprise Applications > application_name > Session management):
Web server plug-in custom properties
In addition to the preceding plug-in properties, there are also plug-in "custom properties" that can be added from the WebSphere Application Server administrative console if desired, depending on web server plug-in version level.
- Web server plug-in versions 6.1 and later:
ESIEnableToPassCookies
IgnoreAffinityRequests
- Web server plug-in versions 6.0.2.23, 6.1.0.13 and 7.0.0.0 - APAR PK48101:
GetDWLMTable
- Web server plug-in versions 6.1.0.21 and 7.0.0.3 - APAR PK73752:
HTTPMaxHeaders
- Web Server plug-in versions 6.1.0.23 and 7.0.0.3 - APAR PK78546:
CertLabel
SSLConsolidate
SSLPKCSDriver
SSLPKCSPassword
- Web Server plug-in versions 6.1.0.23 and 7.0.0.3 - APAR PK78451:
TrustedProxyEnable
TrustedProxyList
- Web Server plug-in versions 6.1.0.33 and 7.0.0.13 - APAR PM12112:
FailoverToNext
Note: After Plug-in APAR PM12112, the new DEFAULT behavior is FailoverToNext="false", which means that when the Plug-in marks an appserver down, it will distribute all of the "pending" requests RANDOMLY to the other available appservers in the same cluster.
- Web Server plug-in versions 6.1.0.45, 7.0.0.25, 8.0.0.5, and 8.5.0.1 - APAR PM67658:
KillWebServerStartUpOnParseErr
Excerpt from plugin-cfg.xml file:
HTTPMaxHeaders="500" FailoverToNext="false" KillWebServerStartUpOnParseErr="true" IISDisableNagle="false" IISPluginPriority="High" IgnoreDNSFailures="false" RefreshInterval="60" ResponseChunkSize="64" SSLConsolidate="true" SSLPKCSDriver="/usr/lib/pkcs11/PKCS11_API.so" SSLPKCSPassword="/usr/lib/pkcs11/password.sth" TrustedProxyEnable="true" VHostMatchingCompat="false"> ...
... GetDWLMTable="true" IgnoreAffinityRequests="false" LoadBalance="Round Robin" Name="wp_cluster" PostBufferSize="64" PostSizeLimit="-1" RemoveSpecialHeaders="true" RetryInterval="60"> ...
|
These plug-in properties can be found and modified in the WebSphere Application Server administrative console (
Servers > Web Servers > web_server_name > Plug-in properties > Custom Properties):