Updating Faces runtime resources for portlet 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 portlet 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 portlet project is imported or a workspace is opened that contains out-of-date Faces or Faces Client runtime resources. After importing a portlet 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 portlet project:
  1. Import a portlet 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 portlet project and select Build > Project; the process of rebuilding a project opens the Project Migration window.
  2. If you have other portlet 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 portlet 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 portlet project or restart the workbench before rebuilding your portlet project. If you have disabled automatic builds, right-click your portlet 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.
  4. To update the portlet-specific Faces runtime resources, jsf-portlet.jar and jsf-wp.jar, you need to follow the manual update steps below.

Manually updating runtime resources

To update the Faces and Faces Client runtime resources manually for a portlet project:
  1. Create a new portlet project named JSFP601. 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 JSFP601 project and select Properties from the menu.
  3. Click Web Project Features and select Add Faces Client Framework for Portlet Project, then click OK.
  4. For each existing Faces portlet 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:
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • jsf-portlet.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 JSFP601 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.
      • If your portlet project uses the IBM® portlet API or person link component, copy the jsf-wp.jar file into your original project.
      • If you copy the file odc-jsf.jar, copy the file odc-jsf-portlet.jar as well.
  5. Delete the JSFP601 portlet project.
Related tasks
Updating Faces runtime resources in a portlet project
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.