Deploying IBM Workplace Services Express on the IBM eServer iSeries Server

Chapter 6. Integrating the Domino portlets 175

򐂰

My Stock: The My Stock portlet displays financial performance and fundamental

investment data for selected companies, investments, symbols, and indices.

򐂰

My Weather: The My Weather portlet displays weather-related data and forecasts for

user-selected cities.

򐂰

My Vertical News: This portlet provides top headlines from a wide array of general,

business, and industry news categories.

򐂰

Retirement Planner: The Retirement Planner is a goal-based tool that estimates your

desired retirement income and estate and evaluates the savings plan required to fund that

need.

6.2 Configuring the Domino Web Access portlet

This section explains how to configure the Domino Web Access portlet in the Workplace

Services Express environment.

6.2.1 Setting up Domino for use with the Domino Web Access portlet

Before you can use the Domino Web Access portlet in Workplace Services Express, make

sure that your Domino configuration meets the requirements for use with this portlet. Perform

the following steps:

1. Verify that all mail files to be accessed from the portlet are using the Domino Web Access

or iNotes template:

a. Open the Domino Administrator client and connect to your Domino server.

b. Click the Files tab.

c. Click the folder that contains your mail files. Typically this is the mail folder.

d. Scroll to the right and review the template name as shown in Figure 6-1. If you do not

see

iNotes6 or DWA7 in this column, you must convert your user’s mail file to use a

Domino Web Access (inotes6.ntf or dwa7.ntf) template.

Figure 6-1 Viewing the mail file template name in the Files tab of the Domino Administrator

Note: The steps to configure the Domino Web Access portlet are the same for Domino 6.x

and Domino 7.x.

176 Deploying IBM Workplace Services Express on the IBM Eserver iSeries Server

2. If necessary, update the design of the mail file to inotes6.ntf or dwa7.ntf using one of the

following convert commands on the Domino server console. In this command, FileName

represents the mail file name (see Example 6-1).

– For Domino 6.x, type the following command:

load convert mail/FileName.nsf * inotes6.ntf

– For Domino 7.x, type the following command:

load convert mail/FileName.nsf * dwa7.ntf

Example 6-1 Domino load convert utility

> Load convert mail/nadminis.nsf * inotes6.ntf

Load convert mail/nadminis.nsf * inotes6.ntf

10/13/2005 15:04:53 Mail Conversion Utility starting

10/13/2005 15:04:53 Mail Convert: Started replacing design template '*' with 'iNotes6'

in 'mail/nadminis.nsf'

10/13/2005 15:04:55 Adding 'DOLS Configuration Settings' to database 'Notes

Administrator' from template 'Domino Web Access (6)'

'10/13/2005 15:04:55 Adding '(ToggleUpdate Tasks)' to database 'Notes Administrator'

from template 'Domino Web Access (6)'

10/13/2005 15:04:55 Adding '($Journal)' to database 'Notes Administrator' from

template 'Domino Web Access (6)'

10/13/2005 15:04:55 Adding '($Users)' to database 'Notes Administrator' from template

'Domino Web Access (6)'

10/13/2005 15:04:57 Mail Convert: Finished replacing design template in

'mail/nadminis.nsf'

10/13/2005 15:04:57 Mail Conversion Utility shutdown

3. Add the appropriate fields to the Global Configuration document to allow LDAP queries for

the HTTP host name, mail server, and mail file name fields:

a. From the Domino Administrator client, click the Configuration tab.

b. In the left frame, click Server → Configurations.

c. Double-click the Global Configuration document to open it. The global configuration

document has a server name of * - [All Servers].

d. In the Global Configuration document, click the LDAP tab.

Tip: You can convert all files in the mail folder at one time by using one of the following

commands:

򐂰 For Domino 6.x:

load convert mail/* * inotes6.ntf

򐂰 For Domino 7.x:

load convert mail/* * dwa7.ntf

Tip: You might have to scroll up to see the Global Configuration document.

Chapter 6. Integrating the Domino portlets 177

e. The following fields should be listed under the LDAP Attribute Types column as shown

in Figure 6-2:

• HTTP-HostName

• MailFile

• MailServer

Figure 6-2 LDAP tab of the Global Configuration document

If these fields are not listed, perform the following steps to add them:

a. Click Edit Server Configuration.

b. Click Select Attribute Types.

c. In the ObjectClasses field, type an asterisk (*).

d. Click Display Attributes.

e. Select the attributes HTTP-HostName, MailFile and MailServer.

f. Click Add.

g. Click OK to exit the LDAP Attribute Type Selection window.

h. Save and close the configuration document.

i. End the Domino server.

j. After the Domino server successfully ends, restart the Domino server.

Tip: These fields are listed only if you followed the steps in 3.4.2, “Modifying the

LDAP configuration” on page 61.