Magnolia 5.5 reached end of life on November 15, 2019. This branch is no longer supported, see End-of-life policy.
The IBM WebSphere Compatibility module is an Enterprise Edition module that provides a servlet for the IBM WebSphere application server to accept requests. With other application servers, Magnolia uses its filter chain with no specific endpoint. In Magnolia 5.5, IBM WebSphere 9 works with the WebSphere Compatibility module.
Maven is the easiest way to install the module. Add the following dependency to your bundle:
<dependency> <groupId>info.magnolia</groupId> <artifactId>magnolia-module-websphere</artifactId> <version>1.4.0</version> </dependency>
Pre-built jars are also available for download. See Installing a module for help.
If you downloaded the prebundled IBM WebSphere war file, skip this step:
magnolia-module-websphere
jar file is your webapp's WEB-INF/lib
directory.Edit the web.xml
file and add the following Servlet
definition:
<servlet> <description>Spool servlet</description> <servlet-name>Spool</servlet-name> <servlet-class>info.magnolia.module.websphere.Spool</servlet-class> <init-param> <param-name>Path</param-name> <param-value>/docroot</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>Spool</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping>
Note that the Servlet
must be mapped to serve /*
, but you can adapt the Path
parameter to allow it to serve other static resources from your webapp.
Refer also to the IBM WebSphere JAAS documentation: Login configuration for Java Authentication and Authorization Service.
magnolia
.info.magnolia.jaas.sp.jcr.JCRAuthenticationModule
as REQUISITE
.info.magnolia.jaas.sp.jcr.JCRAuthorizationModule
as REQUIRED
.com.ibm.ws.cdi.enableCDI
, value: false
.com.ibm.ws.cdi.enableImplicitBeanArchives
, value: false
.com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine
, value: true
.