JBoss.orgCommunity Documentation

Chapter 2. Upgrading

2.1. Before upgrading
2.2. Installation

Upgrading an existing project to use the RichFaces 4.0 framework only requires that the new libraries replace the old ones. For a complete installation guide for new projects, refer to the Developer Guide.

2.1. Before upgrading

Ensure you make a back-up copy of any projects and settings before upgrading an existing RichFaces installation.

Check that the environment you are working in meets the RichFaces technical requirements listed in the Developer Guide.

2.2. Installation

  1. Download RichFaces packages

    If you have not already done so, download the RichFaces binaries from the RichFaces downloads page at http://www.jboss.org/richfaces/download.html.

  2. Install libraries

    Copy the following libraries from the RichFaces package to your application's WEB-INF/lib libraries directory:

    • richfaces-api

    • richfaces-impl

    • core-ui

    Existing projects should already contain the following libraries; if not, they will need to be included in the libraries directory as well:

    • commons-logging

    • commons-beanutils

    • slf4j-api

    • slf4j-log4j12

  3. Set up Maven

    For existing projects, you should already have a Maven installation set up for RichFaces. If not, refer to the Developer Guide for how to set up Maven.

  4. Namespace and taglib declaration

    The namespace and library inclusions are the same as those for previous versions of RichFaces.

    The RichFaces namespaces need to be declared in the project's XHTML pages. 

    
<ui:composition xmlns:a4j="http://richfaces.org/a4j" xmlns:rich="http://richfaces.org/rich">
    
    ...
    
</ui:composition>

    Note

    With RichFaces 4.0, it is no longer necessary to modify the web.xml and faces-config.xml files of a project to use the framework.