Installation and Upgrade Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Registering and Configuring Lotus Notes Portlets

After you have run the installation wizard and verified correct installation, you must register Lotus Notes Portlets in the portal. This chapter describes how to register and configure the portlets in the portal.

 


Registering Lotus Notes Portlets

To register Lotus Notes Portlets, import the portlet package:

  1. Log in to the portal as an administrator and click Administration.
  2. Click the Select Utility drop down menu and choose Migration - Import.
  3. Click Browse and locate the PortletSuite-LotusNotes.pte file, located by default in C:\bea\alui\PortletSuiteLotusNotes\3.4\portalfiles\packages\5.0\. Click Open.
  4. Click Load Package.
  5. Check the box next to Overwrite Remote Servers.
  6. Click Finish.

 


Configuring Portlet Services

After you have installed and registered the portlet suite, you must configure the services used to manage mail servers and the users and domains that they support. This section provides instructions for modifying the required Administrative Preferences and updating portlet settings to implement optional authentication features.

Modifying Administrative Preferences

Administrative Preferences determine how portlet users are authenticated and how mail is handled. You must update the settings on the Administrative Preference pages to complete installation and setup.

  1. Log in to the portal as an administrator and click Administration.
  2. Navigate to the folder that was created for the Lotus Notes Portlets when you migrated the portlet package into the portal.
  3. To display a list of portlet objects, click Portlet.
  4. Click the name of one of the Notes portlets to open the Portlet Editor. The preferences you set for one portlet are inherited by all portlets in the suite.
  5. On the Main Settings page, under Web Service, click the Edit button to open the Administrative Preferences page.

Administrative Preferences Menus and Settings

Use the links in the menu column to display forms that allow you to modify settings. The following table summarizes the menu and the available settings. For detailed information about settings, click Tips on the Administrative Preferences page.

Table 4-1 Lotus Notes Portlets Administrative Preferences Page Settings
Menu
Settings
Portlet Information
Displays version information for the portlet and the Lotus Domino server.
Custom Editor Settings
Select whether clients use a portal or client Web interface to access mail.
Attachment Settings
Displays an editable path to the temporary file directory on the Remote Server and the maximum attachment size (in bytes). If an SSL client certificate is not installed on the Remote Server, the field can be left blank.
User Information Settings
Displays options for user authentication:
  • Portal Setting Authentication: The portlet uses the User or Community preferences to connect to the backend server. For Community portlets (Calendar, Mail, or Contacts), you must select this option.
  • Basic Authentication: The portlet uses basic authentication for the Remote Server to connect to the backend server. For additional requirements, see Enabling Basic Authentication.
  • User Information Authentication: The portlet uses values from an associated LDAP system. Specify the LDAP field name associated with the user name, password, domain, or mailbox. For additional requirements, see Enabling LDAP Authentication.
Authentication Settings
Allows you to switch between Master and Manual Server configurations. In Master Server mode, the Master Server will be queried and the user's server name will be set automatically. In Manual Server mode, the user must choose their server from a list of available servers.
For Master Server mode, you must provide values for the following fields:
  • Server Name/IP/URL: The fully qualified domain name, IP address or URL to the backend server.
  • Server Port: The listening port of the backend server.
  • Proxy Host/Firewall: The host name of the proxy host or firewall server.
  • Proxy Host/Firewall Port: The associated listening port number.
  • Use SSL: Whether or not the connection to the backend server uses SSL.
  • HTTPS Port: The port to use for the HTTPS connection to the server.
Server List
Displays the Lotus Domino servers that appear on the User Preferences page. (If the Administrative Preferences are set up with only one server, the Server List is not displayed on the User Preferences page.)
Add each server in use in your deployment. To add a new server to the list, click + (add row). To delete a server, click - (delete row).
  • Server Name/IP/URL: The fully qualified domain name, IP address, or URL to the backend server (and virtual directory, if applicable), for example, http://<host>/notes. Do not type a trailing slash (/). If the URL is redirected, specify the ultimate location.
  • Server Alias: The server name to be displayed on the User Preferences page.
  • Proxy Host/Firewall: The server name or IP address for the Proxy Host/Firewall server.
  • Proxy Host/Firewall Port: The associated port number.
  • Notes Server Temp Dir: The local path to where the Domino Server temporarily stores attachment files.
  • Notes Server Temp UNC: The UNC path to where the Domino Server temporarily stores attachment files.

Enabling Basic Authentication

To enable Notes portlets to use basic authentication information from the portal:

  1. On the Administrative Preference page, set the User Information Settings option to Basic Authentication as described in the previous section.
  2. Open the Lotus Notes Portlets folder.
  3. Expand the Remote Server section and click the Lotus Notes Portlets Remote Server.
  4. On the Main Settings page of the Remote Server Editor, in the Basic Authentication Type section, select User's Basic Authentication Info.
  5. If you deploy SSL, modify the Base URL for HTTPS protocol.
  6. To save your changes, click Finish.
Note: The portal must be enabled for basic authentication. For information on configuring the portal, refer to the Administrator Guide for AquaLogic Interaction.

Enabling LDAP Authentication

Follow the instructions below if you want Notes portlets to use LDAP authentication values from the portal.

  1. On the Administrative Preference page, set the User Information Settings option to User Information Authentication as described in the previous section.
  2. In the administrative portal folder that contains the Lotus Notes Portlets, click Web Service to display a list of Web Service objects.
  3. Complete the following steps for each of the Lotus Notes Web Service objects:
    1. Click the Web Service name to open the Web Service Editor.
    2. In the Edit Object Settings menu, click User Information.
    3. Select existing LDAP field settings in the User Information Settings section, or add field names by clicking Add New User Information.
    4. To save your changes, click Finish.

 


Localizing Portlet Objects

Lotus Notes Portlets include localization support for the following languages: Chinese, English, French, German, Italian, Japanese, Korean, and Spanish.

Localization support files allow names and descriptions of portlets and Remote Server objects to be localized when the portal settings locale is changed.

The installer copies localization support files to the following location on the Remote Server host computer: <PT_HOME>\PortletSuiteLotusNotes\3.4\portalfiles\common\msgs\.

To enable language support in the portal, copy these files to the appropriate directory on the Portal Server host, for example:

<PT_HOME>\ptportal\6.1\settings\i18n\.


  Back to Top       Previous  Next