How to Upgrade

The following is a total hack and is completely unsupported.  But if you want to upgrade JBoss AS to JSF2 and then have lots of fun with the new JSF2 features, here is what you need to do:

1. If you are running JBoss AS 6.0 or greater, you are done.  JSF2 is already there.
2. If you are running JBoss AS 4.0 or earlier, find something else to do.  It's lot harder and I don't have time to provide instructions.
3. Find jsf-api.jar and jsf-impl.jar for JSF2.  If these jars have a version number in the name then rename them.  They need to be named jsf-api.jar and jsf-impl.jar.
4. If you are running JBoss AS 4.2 or greater, copy the jars to <JBOSS_HOME>/server/default/deploy/jboss-web.deployer/jsf-libs.
5. If you are running JBoss AS 5.0 or greater, copy the jars to <JBOSS_HOME>/server/default/deploy/jbossweb.sar/jsf-libs.

That's it.  To use JSF2 features, you need to be aware that many of the new features get turned off when JSF1.x style apps are detected.  See the JSF2 release notes.

Known Issues with JSF2 on JBoss AS

The first issue is fixed in the JSF2 Release Candidate, so I'd advise not using the beta:

https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=1173

The second issue claims to be fixed, but it's really not.  To work around it, you just need to make sure you use a web.xml in your web app.

https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=1224

Also, there is this known issue with the JBoss Embedded Console.  So you may run into this one:

https://jira.jboss.org/jira/browse/JOPR-343