Sun Java System Portal Server 7.1 Administration Guide

Administering Portlets

This section describes how to deploy and undeploy portlets, and how to modify portlet preferences.

Portlets are web applications that process requests and generate content within the context of a portal. Portlets are managed by the Portlet Container (an implementation of the Portlet Specification as defined by the JSR 168 Expert Group).

A portlet can only be deployed on a selected DN node once. If a portlet has already been deployed on the same DN node, you should undeploy the portlet and deploy it. If your require a portlet to be on multiple sub organizations or roles, then deploy the portlet on the portal global DN or the parent organization.

ProcedureTo Deploy a Portlet

  1. Log in to the Portal Server management console.

  2. Select the Portals tab.

  3. Select a portal server from Portals.

  4. From the Select DN drop-down menu, select any DN.

  5. Click Deploy Portlet to start the wizard.

    1. Ensure the selected portal and selected DN are the ones where you want to deploy the portlet, and click Next.

    2. Specify a portlet war file, the roles file, and the users file.


      Note –

      The roles file and the users files are optional. The war file, the roles file, and the users file can be located either on the local machine, or on the remote portal server system.


    3. Select the button for either the local system or the remote portal server system.

      • If the upload file is from the local machine, use the browse dialog box to select the file from the local machine.

      • If the upload file is from a remote portal server system, use the file chooser dialog to choose a file from the remote machine

    4. Verify the information provided, and click Next.

    5. An information page appears when the portlet is deployed.

  6. Follow the instructions to deploy a portlet.

Equivalent psadmin Command

psadmin deploy-portlet

ProcedureTo Undeploy a Portlet

  1. Log in to the Portal Server management console.

  2. Select the Portals tab.

  3. Select a portal server from Portals.

  4. From the Select DN drop-down menu, select any DN.

  5. Click Undeploy Portlet to launch the wizard.

  6. Modify the configuration attributes as necessary.

  7. Click Undeploy to record the changes.

Equivalent psadmin Command

psadmin undeploy-portlet

ProcedureTo Modify Portlet Preferences

  1. Log in to the Portal Server management console.

  2. Click the Common Tasks tab, then Manage Channel and Containers from the submenu.

  3. Select a portal and the DN where the portlet is deployed.

    The navigation tree with available channels and portlets is displayed.

  4. From the navigation tree on the left frame, select the portlet channel.

    The preferences table and properties table is displayed on the right frame.

  5. In the preferences table, click Edit Values link of a preference you want to modify.

  6. In the preferences wizard, type the new value in the text field, and click OK.

    • To remove a value, select the value from the list and click Remove.

  7. When you done with modifying preferences, click Save.

  8. Click Close.