Chapter 10. WebSphere Portal administration 551
10.4.2 Manage Portlet Applications
Manage Portlet Applications helps you to identify and manage existing installed
Web modules (WAR file). It also displays the concrete portlet application
corresponding to the selected Web module. Using this portlet, you can uninstall
the portlet application and modify dynamically configured parameters or portlet
Select the Manage Portlet Applications portlet and you should see a window
open as shown in Figure 10-35 on page 552. Using the Manage Applications
portlet, you will be able to:
Web modules can contain one or more portlet applications, servlets JSP files and
other files and are defined in the Web descriptor file (web.xml).
With the portlet applications belonging to the selected module, you can:
Portal applications can contain one or more portlets. They are created implicitly
when the WAR file is deployed and they are packaged as an enterprise
application (ear file). You will see the default Web modules in Figure 10-35 on
page 552. This is installed during the WebSphere Portal installation.
Note: You need to select the portlet application belonging to the selected Web
module in order to see the icons for Activate/Deactivate, Copy, Modify
Parameters, Show Info and Delete.
552 IBM WebSphere Portal for Multiplatforms V5 Handbook
Figure 10-35 Manage Applications portlet
Show Info describes the content of the WAR file (Web module), abstract portlet
application and the abstract portlet (complete portlet application).
1. Select a WAR file and click Show Info.
2. You will be shown the selected Web module, portlet application name,
concrete portlet applications belonging to the Web module, and portlets as
shown in Figure 10-36 on page 553.
3. Click Done to come back to Manage Portlet.
Chapter 10. WebSphere Portal administration 553
Figure 10-36 Manage Portlet Applications
The Update option helps you to modify your existing portlet application without
the need to uninstall your existing portlet application.
1. Select any WAR file that you need to update. Click Update and it will take you
to a window similar to Figure 10-37 on page 554.
Note: Update functionality includes updating configuration parameters in your
portlet and replacing the portlet code with new code, incorporating all the
554 IBM WebSphere Portal for Multiplatforms V5 Handbook
Figure 10-37 Update existing Web module
2. Enter or browse for the updated WAR file.
3. Click Next. You can also click Cancel to return without updating the WAR file.
4. You will get a window highlighting the portlets that will be installed during the
update. Check for accuracy and click the Install option. You can select
Cancel to return.
5. If the WAR file is successfully updated, you should see The web module was
Uninstall helps to uninstall your existing portlet application.
1. Highlight the Web module to uninstall.
2. A confirmation window will prompt for confirmation. Click OK if you want to
uninstall or click Cancel to return to the Manage Portlet Application portlet
without uninstalling the Web module.
Tip: It is not required for you to add the portlet to the page again after doing an
update. Changes are incorporated to the page where the portlet was installed
Chapter 10. WebSphere Portal administration 555
3. If you click OK, you will get the message The web module was uninstalled
successfully in the Manage Portlet Applications portlet and this Web module
will be removed from the Web module section and also from the page where
the portlet is deployed.
Portlet applications belonging to the selected Web module
When you select a Web module, you will find the list of portlet applications
corresponding to the selected Web module. When you select any of these portlet
applications, you will see the options to Activate/Deactivate, Copy, Modify
Parameters, Show Info and Delete as shown in Figure 10-38.
Figure 10-38 Select Portlet application belonging to the Web module
The Deactivate feature helps to temporarily suspend access to your selected
portlet application and then with activating, provide access to the portlet
1. Highlight the portlet application to activate or deactivate. By default, the
portlet application will be in Active state.
2. Click Activate/Deactivate to deactivate the portlet application and vice versa.
Tip: Once you deactivate your portlet application, all the portlets that are part
of the deactivated application will disappear from your customized portal