Troubleshooting
Problem
There are several causes for the WebSphere web server plug-in "failed to load" error or failures routing requests to the WebSphere Application Server.
The two most frequent errors:
1. The web server plug-in module cannot use DNS to resolve the server hostnames listed in the plug-in configuration file.
2. The web server plug-in log file is larger than 2GB.
If either of these errors occur, the failure is an unrecoverable error that prevents the web server from starting.
Symptom
The plug-in log might contain errors such as the following:
| ws_transport: transportSetServerAddress: Failed to resolve address ws_server: serverAddTransport: Failed to initialize server address ws_config_parser: configParserParse: Failed to parse the config file ws_common: websphereUpdateConfig: Failed parsing the plugin config file |
These errors are an indication that the plug-in cannot resolve the hostname of the WebSphere Application Server defined in the plug-in XML file. Each cluster must have at least one transport that resolves to an IP address for the web server plug-in module to initialize.
After startup, the web server plug-in does not attempt any name resolution for any of the transports unless the configuration is reloaded. A configuration reload occurs when the plug-in module detects a change to the plugin-cfg.xml file. To force a reload, edit and save the file with no changes or use the touch command to change the timestamp of the plugin-cfg.xml file.
If there are frequent name changes, define the transports as IP address to prevent DNS resolution or modify the OS hosts file to include the name resolution to avoid DNS failures.
These errors prevent the web server plug-in to not load. The failure is an unrecoverable error and prevents the web server from starting.
These errors prevent the web server plug-in to not load. The failure is an unrecoverable error and prevents the web server from starting.
[{"Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000Cd3qAAC","label":"WebSphere HTTP Plugin-\u003EPLG.Configuration\/Questions-\u003EPlugin XML (properties, etc.)"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"All Version(s)"}]
Log InLog in to view more of this document
This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.
Was this topic helpful?
Document Information
Modified date:
03 March 2025
UID
swg21326077