Getting started

What you need

• JDK 1.4.x
• Tomcat 4.x or 5.x
  - Get it from http://jakarta.apache.org/tomcat/index.html)
• MyFaces binary release
  - Download the latest MyFaces binaries
  (since we need Sun's jsf-api.jar we are obliged to distribute MyFaces bundled with the full reference implementation to conform to the license terms)
• MyFaces examples
  - Download the latest MyFaces examples web application

Installing and Running the Examples

• Unpack the MyFaces binaries archive myfaces-1.0.7.tgz to a directory of your choice.
• Unpack the MyFaces examples archive myfaces-1.0.7-examples.tgz to the same directory.
• Remove any previous MyFaces webapps from your Tomcat installation and clean up your Tomcat work dir.
• Copy or move the directory web (in webapps/examples) to the webapps dir of your Tomcat installation directory and rename it to "myfaces".
• Copy the file "jsf-api.jar" from the bundled "JavaServer Faces v1.0 Reference Implementation" archive jsf-1_0.zip to the WEB-INF/lib dir of your myfaces web application directory.
• (Re)start Tomcat (there is a known log4j issue - see KnownIssues if you get errors!)
• Start your browser and go to http://localhost:8080/myfaces.

Using MyFaces in your own web application

• Look at the compatibility list to find out if your servlet container is supported.
• Download the latest MyFaces binary release (myfaces-1.0.7.tgz).
• Copy the lib/myfaces.jar file to the WEB-INF/lib dir of your Webapplication.
• Copy the lib/cos.jar file to the WEB-INF/lib dir of your Webapplication.
• Copy the file "jsf-api.jar" from the bundled "JavaServer Faces v1.0 Reference Implementation" archive jsf-1_0.zip to the WEB-INF/lib dir of your web application.
• Configure your webapp's web.xml file (see conf/web.xml for example and documentation)
• Add the following lines to your JSPs:

• To be able to use the MyFaces extensions add the following line to your JSPs: