1. Deploy the web application on WAS.

2. Execute the command to change the runtime from Sun RI to MyFaces.

This can be done either via the WAS admin console or through a wsadmin command.

3. Start your application.

Using a user-supplied version of MyFaces 2.0.x with WebSphere Application Server v7.0

As of WebSphere Application Server 7.0.0.19, MyFaces 2.0 annotation providers are included as part of the WAS optionalLibraries. A developerWorks article will be available soon with instructions on how to configure these providers. Until that developerWorks article is posted, follow the instructions outlined from this article.

Websphere 6.1 Installation Guide

Make sure you do NOT copy commons-logging-1.0.4 jar (conflicts with the commons-logging jar already provided by Websphere) and also jsp-2.0.jar (which will cause a "com.ibm.ws.jsp.taglib.TldParser logParseErrorMessage: The JSP container failed to load the TagExtraInfo class" exception with JSF applications that use tiles).

2. Deploy the web application on WAS.

3. Alter the module classloader policy to application first.

Note that there are several ways to set the classloader policy in websphere (at the server, application, and module level). You need to set it at the module level as follows: Click on Enterprise Applications > Your application > Manage Modules > Your war file > Change Class loader order to "Classes loaded with application class loader first"

4. Start your application.

If the extension-Filter does not work properly, it might help to set the property com.ibm.ws.webcontainer.invokefilterscompatibility=true. Instructions can be found at this IBM support site.

Websphere 6.0 Installation Guide

****Please note that removing any of the jars from the WebSphere lib directory as described in these instructions is unsupported by IBM. If you wish to maintain support you can use the alternate WebSphere 6.0 instructions below that do not remove the IBM jars ****

1. Remove Webspheres JSF API and Implementation

Remove Jsf API and Jsf Impl from Webshpere AppServer/lib dir

• AppServer/lib/jsf-api.jar - remove

• AppServer/lib/ws-jsf.jar - remove

2. Copy the MyFaces JSF API to WAS

Copy the MyFaces API to AppServer/lib dir

• myfaces-api.jar - copy to AppServer/lib

3. Add commons classes to WAS

Copy commons classes to AppServer/lib dir

• commons-beanutils.jar
• commons-codec.jar
• commons-collections.jar
• commons-digester.jar
• commons-lang.jar

For library versions see Library dependencies

4. Remove MyFaces API from your web archive

• myfaces-api.jar - remove from war

5. Deploy web application on WAS

Nothing special here, just use Classloader option "Parent first"

6. Optional / untested

You may also add the MyFaces Jsf Implementation myfaces-impl.jar to the AppServer/lib dir. It should work with MyFaces Core >= 1.1.2

Attention: Do not copy a myfaces-impl to AppServer/lib dir that depends on the old myfaces-commons library.
Reason: Classloader problems may show up, when MyFaces-Impl and MyFaces-Tomahawk reference different myfaces-commons.jar versions.
In MyFaces 1.1.2 the commons project was refactored and is now called shared.
The shared classes are part of both myfaces-impl and myfaces-tomahawk. To avoid classloader problems due to different versions of shared classes the package names are different for impl and tomahawk.

Websphere 6.0 Installation Guide (without removing IBM jars)

must be replaced as follows:

<!DOCTYPE faces-config PUBLIC "-//Sun Microsystems,
Inc.//DTD JavaServer Faces Config 1.0//EN" "http://java.sun.com/dtd/web-facesconfig_1_0.dtd">

1. Copy the MyFaces JSF jars and dependencies to WebApp lib

Copy jars to ${WebApp}/WEB-INF//lib dir

• MyFaces & Tomahawk

• myfaces-api-1.1.3.jar
• myfaces-impl-1.1.3.jar
• tomahawk-1.1.2.jar

Use Classloader option "Parent last"

Websphere 5.1.X Installation Guide

1. Use Classloader option "Parent last"

2. List of files in WAR's lib, some files may not be needed, but it works for me.

• antlr-2.7.6rc1.jar
• cglib-nodep-2.1_2.jar
• commons-beanutils-1.7.0.jar
• commons-codec-1.3.jar
• commons-collections-3.1.jar
• commons-digester-1.6.jar
• commons-el-1.0.jar
• commons-lang-2.1.jar
• dom4j-1.6.1.jar
• ehcache-1.1.jar
• el-api-1.0.jar
• el-ri-1.0.jar
• hibernate-3.1.2.jar
• jsfExt.jar
• jsf-facelets-1.1.11.jar
• jstl-1.1.0.jar
• myfaces-api-1.1.3.jar
• myfaces-impl-1.1.3.jar
• ojdbc14.jar
• oscache-2.3.1.jar
• portals-bridges-common-1.0.jar
• portals-bridges-frameworks-1.0.jar
• portals-bridges-jsf-1.0.jar
• portals-bridges-portletfilter-1.0.jar
• spring-1.2.6.jar
• tagHandlers.jar
• tomahawk-1.1.5-SNAPSHOT.jar
• tomahawk-sandbox-1.1.5-SNAPSHOT.jar

• jsp-api.jar

3. Use pluto to test first, but needs to remove jsp-api.jar for pluto.

use "org.apache.portals.bridges.jsf.FacesPortlet" bridge instead of "org.apache.myfaces.portlet.MyFacesGenericPortlet" to work with pluto. (inside portlet.xml)