Deploying portlet projects

These instructions apply only when you are deploying to a WebSphere® Portal server.

When you deploy a portlet project, the portlet is installed on the target WebSphere Portal server, but not placed on a page. Use the Administrative functions of the target WebSphere Portal server to manage the placement of the portlets.

For limitations regarding firewalls and Linux®, refer to Network considerations.

To deploy a portlet project to a WebSphere Portal server, follow the steps below.

  1. From the Project Explorer view, right-click the portlet project and select Deploy Portlet. The Deploy Portlet wizard opens.
  2. Select an existing server from the list or create a new one. Follow the instructions in Defining servers for publishing portlets.
  3. Click Next.
  4. On the Portlets page, define these options for Portlet Overwriting:
    • If you do not want to be prompted, select Automatically overwrite portlets.
    • Select the option that you want to use for overwriting portlets:
      • Use the Update option to install the portlet, but preserve any customization data that was added in the configure or edit modes.
      • Use the Remove & Deploy option to remove and reinstall the portlet. During the removal process, all customization data is also removed, and portlets are removed from any pages where they were already placed. The install process only installs portlets, but does not restore customization data nor place portlets on pages. Use this option if you want to clean up portlet settings, or if your portlet is not compatible with the old version.
  5. Click Finish. Do not interrupt the deployment process.
  6. Once the portlet is successfully installed on the portal server, add the portlet to a portal page following these steps:
    1. Open a Web browser to the Administration page of the remote WebSphere Portal server.
    2. Open Portal User Interface > Manage Pages,
    3. Locate the page where you will add the portlet. Click on the Edit Page Layout button (the pencil icon).
    4. Use the Add portlets buttons to add the portlet to the page. Click Done to save the changes.

Note: An XML Exception occurs and the server attach fails to start if the project name, the filename, the file directory structure or the User ID for WebSphere Portal login name is excessively long. To correct this, shorten the length of the filename, the file directory structure or the User ID for WebSphere Portal login at the WebSphere Portal Server Attach server configuration.

Related tasks
Defining servers for publishing portlets
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.