Updating Faces runtime resources for Web projects from Rational Application Developer V6.0

The JavaServer Faces and Faces Client runtime resources that originally shipped in Rational® Application Developer V6.0 have been updated for Rational Application Developer V6.0.1. If you want to continue development on Web projects that were created with this previous product version, it is recommended that you update the Faces and Faces Client runtime resources to the latest levels.

In Rational Application Developer V6.0.1, the Faces and Faces Client runtime resource updates happen automatically when a Web project is imported or a workspace is opened that contains out-of-date Faces or Faces Client runtime resources. After importing a Web project or opening a workspace from Rational Application Developer V6.0 to Rational Application Developer V6.0.1, you will be prompted to update these runtime resources to the latest levels.

Automatically updating runtime resources

To update the Faces and Faces Client runtime resources automatically for a Web project:
  1. Import a Web project (or a workspace) containing Faces or Faces Client content from Rational Application Developer V6.0. The Project Migration window opens.
    Note: If the Project Migration window does not open, your automatic build preference setting is probably disabled. In Project Explorer, right-click your Web project and select Build > Project; the process of rebuilding a project opens the Project Migration window.
  2. If you have other Web projects with Faces or Faces Client content in your workspace, check Apply this choice to any other projects that need to be upgraded and all your Web projects will be updated.
  3. Click one of the following:
    • Yes to complete the update automatically.
    • Later to defer the update. To update runtime resources automatically after selecting Later, you have to close and reopen the Web project or restart the workbench before rebuilding your Web project. If you have disabled automatic builds, right-click your Web project and select Build Project.
    • Never to keep your runtime resources back-level. If you choose Never and intentionally stay with the back-level runtime resources, you will not be prompted again to update them. In the future, you will need to update the runtime resources manually if you require them.

Manually updating runtime resources

To update the Faces and Faces Client runtime resources manually for a Web project:
  1. Create a new Web project (or, if you are working with EGL, create a new EGL Web project) named JSF601. You will use this project only as a source for the latest runtime resources; it can be deleted after the update is complete.
  2. In the Project Explorer, right-click on the JSF601 project and select Properties from the menu.
  3. Click Web Project Features and select Add Faces Base Components and Add Faces Client Framework, then click OK.
  4. If you are working with EGL, create a JSF page file as follows:
    1. Right-click the WebContent folder of your new EGL Web project.
    2. Select New > Other > Faces JSP File.
    The eglintdebug.jar and eglintdebugsupport.jar files are added to your project.
  5. For each existing Faces project that you want to update, do the following:
    1. In Project Explorer, expand an existing project to show the files in the WebContent/WEB-INF/lib/ folder. Locate and delete any of the following JAR files in this directory:
      • eglintdebug.jar (EGL only)
      • eglintdebugsupport.jar (EGL only)
      • fda6.jar (EGL only)
      • fdaj6.jar (EGL only)
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • odc-jsf.jar
    2. For any JAR files that you deleted, copy the JAR file of the same name from the WebContent/WEB-INF/lib directory of the JSF601 project and paste it into your original project in the same location. Some configurations will not require all of these JAR files to be present in the project; do not copy a particular JAR file if it was not in the original project.
    3. If you are working with EGL, right click on the name of each EGL Web project and click Generate; then, if you are not building the projects automatically, click Project > Build All.
  6. Delete the JSF601 Web project.
Related tasks
Updating Faces runtime resources in a Web project
Updating Faces Client runtime resources in a Web project
Updating Faces runtime resources in a portlet project
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.