IBM WebSphere Portal for Multiplatforms V5 Handbook

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

application settings.

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:

򐂰 Show Info

򐂰 Update

򐂰 Un-install

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:

򐂰 Activate/Deactivate

򐂰 Rename

򐂰 Copy

򐂰 Modify Parameters

򐂰 Show Info

򐂰 Delete

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

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

Update

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

changes.

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

updated successfully.

Uninstall

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

automatically.

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

Activate/Deactivate

The Deactivate feature helps to temporarily suspend access to your selected

portlet application and then with activating, provide access to the portlet

application.

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

page.