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
- 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® platforms: iwidget.bat


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.
- Edit the portal.iwidgets.properties file
to specify the group of widgets and specific information for your
environment.
- In the properties file, change the path to the server
that you are using with WebSphere Portal.
- 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
- Change the Portal.userid and Portal.password values
to the admin user name and password for WebSphere Portal.
- 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.
- 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.
- 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=
- Save the portal.iwidgets.properties file.
- To create the portlets, run the iwidget script. Run one of the following commands, based on your platform:
On i5/OS platforms: iwidget
-w wp_profile_root -p property_file_location,
where wp_profile_root is the WebSphere Portal root.

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.
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 . These portlets can be used only in a Business Space
theme.
- Optional: If you want to configure the other
group of widgets, repeat steps 2-4 for the second set of widgets.