WebSphere

Creating portlets in WebSphere Portal for Business Space widgets

Run the automated deployment script for your widgets. This creates portlets that you need for widgets in WebSphere® Portal.

Before you begin

Topic scope: This topic applies to the following products:
  • WebSphere Business Modeler Publishing Server
  • WebSphere Enterprise Service Bus
  • WebSphere Process Server

About this task

On each node where you want to add widgets, complete the following steps.

Procedure
  1. Copy the following automated deployment script and related files from install_root/BusinessSpace/portal on your product server to install_root/BusinessSpace/portal on WebSphere Portal.
    • configure_iwidget_portlet.ant
    • configureIWidget.jy
    • For Windows operating system For Windows® platforms: iwidget.bat
    • For i5/OS operating systemFor Linux operating systemFor UNIX operating system For i5/OS®, Linux®, UNIX®, and z/OS® platforms: iwidget.sh
    • portal.iwidgets.properties
    • PubServerWidgetPortlets.xml
    • WPSWidgetPortlets.xml
    Note: The iwidget script works with two groups of Business Space widgets: widgets that work with WebSphere Business Modeler Publishing Server (which are defined in PubServerWidgetPortlets.xml) and widgets that work with WebSphere Enterprise Service Bus and WebSphere Process Server (which are defined in WPSWidgetPortlets.xml). To configure both groups of widgets, you must run the scripts twice.
  2. Edit the portal.iwidgets.properties file to specify the group of widgets and specific information for your environment.
    1. In the properties file, change the path to the server that you are using with WebSphere Portal.
    2. To specify which group of widgets to configure, remove the comment character from the line in the properties file for the group of widgets that you want to configure, and add a comment character on the other line. For example:

      Portal.iWidget.Xml.File=PubServerWidgetPortlets.xml
      #
      #Portal.iWidget.Xml.File=WPSWidgetPortlets.xml

    3. Change the Portal.userid and Portal.password values to the admin user name and password for WebSphere Portal.
    4. For the Business Space server, change the host name and port number to the appropriate host name and port number, using the full URL format, for example https://9.26.73.163:9447.
    5. For the WebSphere Portal server, change the host name and port number to the appropriate host name and port number, using the full URL format.
    6. Remove the comments for the iwidget script that you are using for your platform.
      For example, for a Windows platform, the WAS.script.ext=.bat has the comment character removed, and all other lines are designated as comments:

      # --- WAS script extension
      # --- Windows:
      WAS.script.ext=.bat
      # --- Unix/Linux:
      #WAS.script.ext=.sh
      # --- iOS:
      #WAS.script.ext=

  3. Save the portal.iwidgets.properties file.
  4. To create the portlets, run the iwidget script. Run one of the following commands, based on your platform:
    • For i5/OS operating system On i5/OS platforms: iwidget -w wp_profile_root -p property_file_location, where wp_profile_root is the WebSphere Portal root.
    • For Linux operating systemFor UNIX operating system On Linux, UNIX, and z/OS platforms: iwidget.sh -w wp_profile_root -p property_file_location, where wp_profile_root is the WebSphere Portal root.
    • For Windows operating system On Windows platforms: iwidget.bat -w wp_profile_root -p property_file_location, where wp_profile_root is the WebSphere Portal root.
    After you configure the portlets with the script, you can see the portlets by clicking Administration > Portlet Management > Portlet. These portlets can be used only in a Business Space theme.
  5. Optional: If you want to configure the other group of widgets, repeat steps 2-4 for the second set of widgets.

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 22 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic/com.ibm.websphere.wbpm.bspace.config.620.doc/doc/tcfg_bsp_portal_portlet.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).