Migrating WebSphere Portal or portlet projects

This topic provides instructions for migrating portal or portlet projects from V5.1.x to V6.0 or later. It also describes how to select the runtime environment in the migrated project.

If you have migrated to WebSphere® Portal 6.0, or later, the portal stubs are already installed, hence a WebSphere Portal 6.0, or later runtime environment already exists. To add the appropriate runtime environment:

1. From the menu bar, choose

   Window | Preferences.

2. In the left pane, select

   Server | Runtime Environments.

3. Click the

   Add button. From the list of servers, select the appropriate WebSphere Portal version. Click Next.

4. Use the Browse buttons next to the portal and application servers to set the locations of the WebSphere Portal installation. Click Finish.

5. Click OK.

Note:

• Most portlets written for WebSphere Portal 5.1 will run unchanged in WebSphere Portal 6.0, or later; however, it is recommended that you migrate portlet projects to the version of WebSphere Portal that your portlets will be installed on.

• Migrated portlet application projects are not backward compatible.

To manually migrate portlet applications for WebSphere Portal 5.1.x to 6.0 or later, do the following:

1. Import the portal project to current workspace. Click File > Import and select Portal. See Importing portal sites on how to import project.

2. Right-click the portal project that you want to migrate and select Properties.

3. Select

   Targeted Runtimes. The page lists all runtimes supporting the selected project.

4. Select WebSphere Portal as the targeted runtime, then click OK. The project's target runtime, server classpath container, and JRE will now be targeted to the selected WebSphere Portal.

If the Enterprise application project (EAR) references another portlet project in addition to the migrated portlet project, you should consider creating a new enterprise application project to contain the migrated portlet project.

1. Remove the module of the migrated portlet project from the enterprise application project.

   • Expand the enterprise application project and select the deployment descriptor.

   • Right-click to select

     Open With | Deployment Descriptor Editor.

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

   • Click

     Remove.

   • Save your changes to the deployment descriptor.

2. Create a new enterprise application project and add the portlet project to it.

   • Select

     File | New | Project.

   • Select the Show All Wizards check box.

   • Expand J2EE and select Enterprise Application Project.

   • Fill in the project Name field.

   • Select the appropriate target WebSphere Portal server.

   • Click Next.

   • Select any facets that should be associated with this project. Click Next.

   • On the EAR Module Projects page, select the migrated portlet project. If the migrated portlet project has dependent projects, such as EJBs or utility jars, select those projects as well. Click Finish.

---