24 February 2012

On a recent project I had problems deploying a web application built on the Struts 2 MVC framework to a fresh WebSphere installation. I wasted a lot of time labouring under the incorrect assumption (for once) that the architectural changes I had introduced in the latest sprint were the cause of my troubles.

But it turned out to be an environmental issue. We were deploying Struts 2 as a servlet filter and out of the box WebSphere does not support HTTP requests that are served by a servlet filter. A custom property called com.ibm.ws.webcontainer.invokefilterscompatibilty must be set for the web container. I guess I should have just deployed straight to the UAT environment!

Here is the procedure for setting the com.ibm.ws.webcontainer.invokefilterscompatibility custom property:

  1. In the administrative console click Servers > Application Servers > server_name > Web Container Settings > Web Container.

  2. Under Additional Properties select Custom Properties.

  3. On the Custom Properties page, click New.

  4. On the settings page, enter com.ibm.ws.webcontainer.invokefilterscompatibility in the Name field and true in the Value field.

  5. Click Apply or OK.

  6. Click Save on the console task bar to save your configuration changes.

  7. Restart the server.

Brian Matthews