My Oracle Support Banner

Installing JSF 2.0 Into a GlassFish Server 2.x Domain Causes The FacesServlet To Throw An UnsupportedOperationException When Accessing the Administration Console (Doc ID 1508428.1)

Last updated on OCTOBER 17, 2023

Applies to:

Oracle GlassFish Server - Version 2.1 to 2.1.1 [Release 2.1]
Information in this document applies to any platform.


The Oracle GlassFish Server 2.x installation has been updated by following the instructions in the JSF 2 Release Notes.  However, when the domain is restarted an UnsupportedOperationException is thrown when trying to login to the domain's administration console: 



The only changes that have been made are those given in the JSF 2 Release Notes.  That is:

  1. Download the Mojarra 2.0.4 binary bundle from the project page
  2. Backup your existing jsf-impl.jar found in GF_HOME/lib
  3. Copy the new jsf-api and jsf-impl JARs to GF_HOME/lib
  4. Edit your GF_HOME/domains/<domain-name>/config/domain.xml and add (or update the existing classpath-prefix) 'classpath-prefix="${com.sun.aas.installRoot}/lib/jsf-api.jar" to the java-config element
  5. Restart your server

Following these steps and then attempting to login to the Domain Administration Server's (DAS) administration console results in the UnsupportedOperationException in the DAS server.log file.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 Deploy the JSF 2.0 jar files as part of the web application
 Deploy the JSF 2.0 jar files in a non-DAS GlassFish Server Instance

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.