Fix (APAR): PK37608 Status: Fix Release: 6.1.0.7 Operating System: AIX,HP-UX,i5/OS,Linux,Solaris,Windows Supersedes Fixes: CMVC Defect: xxxxxx Byte size of APAR: 39037 Date: 2007-04-26 Abstract: Applications or stack products can have problems when a header name contains a dollar sign "$". Description/symptom of problem: PK37608 resolves the following problem: ERROR DESCRIPTION: The special header $WSEP was added to support a function in the ODR.Plug-in does not use it, it relies only on the HTTP status line. The solution for the above problem involves 2 parts as follows. 1. The ODR team adds a new header "$WSSC", set to the value "ErrorPage", on requests forwaded to the webcontainer. 2. The webcontainer implements a custom property: com.ibm.ws.webcontainer.suppressErrorPageODRHeader if set to false (default) the webcontainer will include the $WSEP header in the error page response (current default behavior) if set to true the webcontainer will not include the $WSEP header in the error page response unless it finds a "WSSC" header set to "ErrorPage" in the request. LOCAL FIX: N/A PROBLEM SUMMARY USERS AFFECTED: IBM WebSphere Application Server version 6 users in which their code cannot handle a dollar sign ($) in a header. PROBLEM DESCRIPTION: Applications or stack products can have problems when a header name contains a dollar sign "$". RECOMMENDATION: None The Web Container adds a HTTP header name $WSEP for some error conditions (for example, a 403 error code). Certain applications or stack products such as WebSphere Extended Deployment (XD) cannot handle having a "$" as part of the header There is a need to be able to suppress the header. PROBLEM CONCLUSION: The solution to this problem involves two steps: 1. The stack product or application needs to add a new header named "$WSPC" and the value set to "ErrorPage" on requests forwaded to the WebContainer. 2. The WebContainer code was modified to look for a WebContainer custom property named: com.ibm.ws.webcontainer.suppressErrorPageODRHeader If the value of the property is "false", which is the default behaviour, the webcontainer will include the $WSEP header in the error page response. If the value is set to "true" the WebContainer will not include the $WSEP header in the error page response unless it finds a "$WSPC" header that is set to "ErrorPage" in the request. The fix for this APAR is currently targeted for inclusion in fixpacks 6.0.2.19 and 6.1.0.9. Please refer to the Recommended Updates page for delivery information: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980 Directions to apply fix: NOTE: Choose the: 1) Release the fix applies to 2) The Editions that apply 3) Delete the Editions & Methods that do not apply and this Note Fix applies to Editions: Release 6.0 __ Application Server (Express or BASE) __ Network Deployment (ND) __ WebSphere Business Integration Server Foundation (WBISF) __ Edge Components __ Developer __ Extended Deployment (XD) Install Fix to: Method: __ Application Server Nodes __ Deployment Manager Nodes __ Both NOTE: The user must: * Have Administrative rights in Windows, or be the Actual Root User in a UNIX environments. * Logged in with the same authority level when unpacking a fix, fix pack or refresh pack. * Be at V6.0.2.2 or newer of the Update Installer. This can be checked by reviewing the level of the Update Installer in file /updateinstaller/version.txt. The Update Installer can be downloaded from the following link: http://www.ibm.com/support/docview.wss?rs=180&uid=swg21205991 For detailed instructions to Extract the Update Installer see the following Technote: http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg21205400 1) Copy PKxxxxx.pak file directly to the maintenance directory 2) Shutdown WebSphere Manually execute setupCmdLine.bat in Windows or . ./setupCmdLine.sh in Unix from the WebSphere instance that maintenance is being applied to. 3) Launch Update Installer 4) Enter the installation location of the WebSphere product you want to update. 5) Select the "Install maintenance package" operation. 6) Enter the file name of the maintenance package to install (PKxxxxx.pak file which was copied in the maintenance directory). 7) Install the maintenance package. 8) Restart WebSphere Directions to remove fix: NOTE: * The user must have Administrative rights in Windows, or be the Actual Root User in a UNIX environments. * FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED * DO NOT REMOVE A FIX UNLESS ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED * YOU MAY REAPPLY ANY REMOVED FIX Example: If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be removed, fix3 must be removed first, fix2 removed, and fix3 re-applied. 1) Shutdown WebSphere Manually execute setupCmdLine.bat in Windows or . ./setupCmdLine.sh in Unix from the WebSphere instance that uninstall is being run against. 2) Start Update Installer 3) Enter the installation location of the WebSphere product you want to remove the fix. 4) Select "Uninstall maintenance package" operation. 5) Enter the file name of the maintenance package to uninstall (PKxxxxx.pak). 6) UnInstall maintenance package. 7) Restart WebSphere Directions to re-apply fix: 1) Shutdown WebSphere. 2) Follow the Fix instructions to apply the fix. 3) Restart WebSphere. Additional Information: