Migrating WebSphere Portal v5.0 portlets to v5.1

Most portlets written for WebSphere Portal v5.0 will run unchanged in WebSphere Portal v5.1. Some of the Portlet 5.0 APIs are now marked as deprecated, but are still available on WebSphere Portal v5.1. However, some portlets will have to be migrated as described in this topic. It is recommended that you migrate portlet projects to the version of WebSphere Portal that your portlets will be installed on.

Note: Migrated portlet application projects are not backward compatible.

To migrate portlet applications for WebSphere Portal v5.0 to v5.1, do the following:

1. Migrate the Portal v5.0 portlet projects to Portal v5.1 portlet projects:

   1. Right-click the portlet project that you want to migrate.

   2. Select Properties > Portlet API to open the Portlet API page.

   3. Select WebSphere Portal Version v5.1 from the Portlet API version drop-down list.

   4. Click OK, and the following changes are automatically made:
      • The tag library descriptor (TLD) file for the portlet API is removed if it exists.

      • The JRE containers for WebSphere Portal v5.0 that are associated with the project will be changed to WebSphere Portal v5.1 JRE containers.

      • The WebSphere Portal v5.0 target runtime servers that are associated with the project will be changed to WebSphere Portal v5.1 target runtime servers.

2. If your portlet project is associated with an enterprise application project, it is recommended that you migrate the target server of the EAR project to WebSphere Portal v5.1.

   1. If the migrated portlet project is only associated with the enterprise application project, do the following:
      1. Close all editors in the workbench.

      2. Right-click the enterprise application project with which the migrated portlet project is associated.

      3. Select Properties > Server to open the Server page.

      4. Select WebSphere Portal v5.1 as the Target Runtime.

      5. Click Apply.

   2. If other portlet projects are associated with the enterprise application project, remove the migrated portlet project and add it to another enterprise application project. Follow these steps:
      1. Remove the module of the migrated portlet project from the enterprise application project.
         1. Expand the enterprise application project and select the deployment descriptor.

         2. Select Open With > Deployment Descriptor Editor.

         3. Select the Module tab. On the Module page of the editor, select the WAR file of the migrated portlet project.

         4. Click Remove.

         5. Select File > Save to save the changes.

      2. Create a new enterprise application project and add the portlet project to it.
         1. Select File > New > Project.

         2. Select the Show All Wizards check box.

         3. Expand J2EE and select Enterprise Application Project.

         4. Fill in the project Name field.

         5. Select J2EE version 1.3

         6. Select WebSphere Portal v5.1 as the target server

         7. Click Next.

         8. On the EAR Module Projects page, select the migrated portlet project and click Finish.

 

Related tasks

Migrating to the portal tools in Rational Application Developer V6.0