How to move EGL JSF Application to a Higher Server Runtime

Technote (FAQ)


Question

How do you move EGL JSF application to a higher server runtime using IBM Rational Business Developer?

Cause

If you are using Apache Tomcat 5.5 and WebSphere Application Server 6.1 which support JSF 1.1, you know JSF 1.1 is deprecated, and the old server runtime will be out of service. How do you move to a higher server runtime which supports JSF 1.2 or above?

Answer

Currently EGL JSF only supports JSF 1.1 specification, which means you should not directly change JSF 1.1 faces to JSF 1.2 or above in the Project Facets for existing or new EGL web project. In order to move to a higher server runtime, you can migrate to JSF 1.2/2.0 with the way of using the JSF 1.2/2.0 implementation which can be backward compatible with JSF 1.1 specification (JSF 1.1 specification is a fixed configuration with Rational Business Developer).

Note: The migration refers to JSF implementation migration rather than JSF specification migration.

Procedure:

How to move applications to higher Apache Tomcat or WebSphere Application Server.

Summary of default runtime and other supported runtime for each type of Server.

Servers
Default runtime
Other supported runtime
Tomcat 6.0.x/7.0.x SUN RI 1.1 SUN RI 1.2
WebSphere Application Server 7.0.x SUN RI 1.2
WebSphere Application Server 8.0.x Apache MyFaces 2.0 SUN RI 1.2
WebSphere Application Server 8.5.x Apache MyFaces 2.0 SUN RI 1.2

Note: It is recommended that you use the default runtime for both development and deployment.


For Apache Tomcat

For Tomcat server, SUN RI (SUN Reference Implementation) 1.1 and 1.2 are now officially supported by Rational Business Developer.

If you update the server runtime to Tomcat 6.0.x/7.0.x, there is no need for them to change anything for JSF, because the default JSF implementation SUN RI 1.1 shipped with Rational Business Developer is supported by Rational Business Developer itself.

If you want to explicitly switch to JSF 1.2 implementation, you can download the SUN RI 1.2 and replace the old JSF implementation as follows:
  1. Download the JSF 1.2 implementation from http://javaserverfaces.java.net/
    Download the latest implementation for JSF 1.2 (as of this writing, the latest is Mojarra 1.2_15).

  2. Extract the zip file to the local disk.

  3. Replace the old jars with new ones in the WebContent/lib/ directory:
    jsf-api.jar
    jsf-impl.jar

  4. Restart Tomcat server.



For WebSphere Application Server

By default, JSF implementation is shipped with WebSphere Application Server.

    WebSphere Application Server 7.0.x

    In WebSphere Application Server 7.0.x, SUN RI 1.2 is shipped and set as the default implementation. It is officially supported by Rational Business Developer.
    If you update the server runtime to WebSphere Application Server 7.0.x, there is no need to change anything for JSF, because the default JSF implementation SUN RI 1.2 in WebSphere Application Server 7.0.x is supported by Rational Business Developer.

    WebSphere Application Server 8.0.x

    In WebSphere Application Server 8.0.x, both SUN RI 1.2 and Apache MyFaces 2.0 are shipped, and MyFaces 2.0 is set as the default implementation. Both are officially supported by Rational Business Developer.

    If you update the server runtime to WebSphere Application Server 8.0.x, there is no need to change anything for JSF, because the default JSF implementation MyFaces 2.0 can be backward compatible with JSF 1.1 specification and it is supported by Rational Business Developer.

    If you want to explicitly switch to JSF 1.2 implementation, the following procedures explains how to migrate to JSF 1.2 implementation within WebSphere Application Server 8.0.x.
    1. Change the JSF implementation to SUN RI 1.2

    2. Restart WebSphere Application Server.


    WebSphere Application Server 8.5.x

    In WebSphere Application Server 8.5.x, both SUN RI 1.2 and Apache MyFaces 2.0 are shipped, and MyFaces 2.0 is set as default implementation. Both are officially supported by Rational Business Developer.

    If you update the server runtime to WebSphere Application Server 8.5.x, there is no need to change anything for JSF, because the default JSF implementation MyFaces 2.0 can be backward compatible with JSF 1.1 specification and it is supported by Rational Business Developer.

    If you want to explicitly switch to JSF 1.2 implementation, the following procedure explains how to migrate to JSF 1.2 implementation within WebSphere Application Server 8.5.x.
    1. Change the JSF implementation to SUN RI 1.2

    2. Restart WebSphere Application Server.

    Note: You may need to recompile all the jsp files by setting the JSF engine configuration parameter com.ibm.ws.jsf.JSF_IMPL_CHECK. Review the following information center topic for more details:
    http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/topic/com.ibm.websphere.nd.iseries.doc/info/iseriesnd/ae/tweb_jsfengine.html

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Business Developer
JSF Handlers

Software version:

8.0.1.4

Operating system(s):

Linux, Windows

Reference #:

1621732

Modified date:

2013-02-28

Translate my page

Machine Translation

Content navigation