Oracle Portal Integration Solutions
Oracle Application Server Provider for Lotus Notes - Installation Instructions

Contents

Introduction

The Oracle Application Server (OracleAS) Provider for Lotus Notes provides Oracle Portal users with Single Sign-On (SSO) access to information within their Lotus Notes Inbox, Calendar, Contacts and To Do list. The portlets provide Oracle Portal users with seamless, high-level interaction between the two applications. The Lotus Domino user authentication information is configured as an External Application in Oracle Portal. The Oracle Portal's SSO server performs an implicit login to the Lotus Domino server every time any of the links within these portlets are clicked, there by eliminating the need for the user to authenticate against the Lotus Domino Server.

The Lotus Notes Portlets support the iNotes web template.

OracleAS Provider for Lotus Notes supplies following set of portlets:

• Inbox Portlet

• Calendar Portlet

• Contacts Portlet

• To Do Portlet

Please refer to the Oracle Application Server Provider for Lotus Notes - Frequently Asked Questions for additional details on these portlets.

Deploying the OracleAS Provider for Lotus Notes

After you have downloaded lotusnotes.zip, please follow the instructions in installing.integration.v2.html to deploy the OracleAS Provider for Lotus Notes.

Now, copy the NCSO.jar file to:

$IAS_HOME(MID_TIER)/j2ee/OC4J_PORTAL/applications/lotusnotes/lotusnotes/WEB-INF/lib directory.

Note: The NCSO.jar file includes the necessary Lotus Domino APIs and is typically found on the Lotus Domino server at: $LOTUS_HOME/Domino/data/domino/java/NCSO.jar.

Testing the Deployment

The OracleAS Provider for Lotus Notes is now deployed. To test the deployment, access the provider's test page at the following URL:

http://myserver.com:8888/lotusnotes/providers/lotusnotes

This page lists the Lotus Notes Inbox, Calendar, Contacts and To Do portlets that are included with the OracleAS Provider for Lotus Notes. If you are unable to get the provider's test page successfully, refer to Frequently Asked Questions on Lotus Notes Portlets for troubleshooting.

Configuring the Lotus Domino Server

Configuring Java/COM Restrictions on the Lotus Domino Server

• Go to the Domino Web Administrator interface and logon as the Domino administrator. Typically, the URL is something like http://your_domino_web_server_hostname:port/webadmin.nsf

• Select Configuration tab from the navigation bar.
 
• Select Server.
 
• Double click your server name from the list (or on current server document if you have only one server).
 
• Select Edit Server.
 
• Click on the Security tab.
 
• Scroll to the section labeled Run restricted Java/Javascript/COM and enter an asterisk character (*) in the text area provided.
 
• Scroll to the section labeled Run unrestricted Java/Javascript/COM and enter an asterisk character (*) in the text area provided.
 
• Click on the Save and Close link.

Enabling IIOP

The Lotus Notes Portlets implementation uses the Notes Client Side Objects  to communicate with the Lotus Domino server. The Notes Client Side Objects internally use IIOP (Internet Inter-ORB Protocol) to communicate and exchange object data. To allow this communication, a server task that runs on the Lotus Domino Server and works with the Domino Object Request Broker DIIOP (Domino Internet Inter-ORB Protocol) needs to be enabled.  You can ensure this by following these steps:

• Go to the Domino Web Administrator interface and logon as the Domino administrator. Typically, the URL is something like http://your_domino_web_server_hostname:port/webadmin.nsf
  
 
• Select Configuration tab.
 
• Double click your server name from the list (or on current server document if you have only one server).
 
• Select  Ports -> Internet Ports tab.
 
• Click on the DIIOP tab to go to the IIOP Server screen.
  
 
• Check the following settings:
• TCP/IP Port number: 63148 (default port)
• TCP/IP Port status: Enabled.  If not, then select Enabled and click on the Save and Close to save the changes.
 
• Now, start the DIIOP server task on the Lotus Domino Server, if not started, enter the following command on Lotus Domino Server console:
  load diiop
Press Enter to start the DIIOP server task.

Setting up Session Based Authentication

Before publishing the Lotus Notes Portlets, you need to set up Session Based Authentication for Web clients who have access to a Domino Web server.

To specify settings that enable and control session-based authentication on the Lotus Domino Server, please follow these steps:

• Go to the Domino Web Administrator interface and logon as the Domino administrator. Typically, the URL is something like http://your_domino_web_server_hostname:port/webadmin.nsf

• Select Configuration tab from the navigation bar.
 
• Select Server.
  
 
• Double click your server name from the list (or on current server document if you have only one server).
 
• Select Edit Server.
 
• Select Internet Protocols -> Domino Web Engine
 
• In the HTTP Sessions section, for Session Authentication, select Single Server.
 
• Click on Save and Close.

Verifying Web settings

Publishing the OracleAS Provider for Lotus Notes

Creating the External Application

• Log on to Oracle Portal as a Oracle Portal Administrator. 
  
• Go to the Administer tab of the Oracle Portal Builder.
  
• In the SSO Server Administration portlet, click Administer External Applications.
• Click on Add External Application. 
  
• In the External Application Login and Authentication Method sections, enter the following:
• Application Name: Lotus Notes Mailbox
• Login URL: http://your_domino_webserver_hostname:port/names.nsf?Login.
• User Name/ID Field Name: Username
• Password Field Name: Password 
• Type of Authentication Used: Select POST
  
• In the Additional Fields section, enter the following: 

Field Name	Field Value	Display to User
MailFilename	(blank)	(checked)
Hostname	(host:port used to access Domino Web Mail)	(unchecked)

• Click OK. 
  
• Then click on the link for your new Lotus Notes Mailbox external application and enter valid user account (Domino Mail Web Access account) credentials (the value for the MailFilename field should typically be of the form "mail\<filename>.nsf"). 
  
• The Remember My Login Information... checkbox must be checked.
• After logging on, you should see the Domino default website home page.

Registering the OracleAS Provider for Lotus Notes

After deploying the OracleAS Provider for Lotus Notes, you must register the provider with Oracle Portal before adding the Lotus Notes Portlets to a page.

1. Login to Oracle Portal using an account that has build privileges.
2. If your home page is not the Build/Administer page, click on the Builder link in the top right corner of the screen.
3. Click on the Build tab if that is not the active tab.
4. Under the Build tab (on Oracle Portal Home Page), click on Register Portlet Provider within the portlet called Providers.
5. Fill out provider information for the Lotus Notes Provider.
• Name: LotusNotesProvider
• Display Name: Lotus Notes Provider
• Timeout: 100
• Timeout Message: Lotus Notes Provider Timed Out
• Implementation Style: Web
6. Click on the Next button to enter the Web Provider specific information
7. Enter the Web Provider location URL:
http://your_oc4j_hostname:port/lotusnotes/providers/lotusnotes
8. Select the radio button labeled The user's identity needs to be mapped to a different name....
9. In the External Application ID field, select the ID corresponding to the Lotus Notes Mailbox external application you created in the previous section.
10. Scroll down to the User/Session Information section and specify the login frequency
11. Select  the Login Frequency as:  Once Per User Session
12. Click on the Finish button to complete the registration.

Note: When registering a new provider with Oracle Portal, only the user who registered the provider has privileges to see the provider/portlets.  If necessary, go to the Folder with the name of the provider within the Portlet Repository content area and update the provider privileges as required.

Adding the Lotus Notes Portlets to a Page

You are now ready to add the Lotus Notes portlets to a page. For more information on adding portlets to your page, please refer to Oracle Application Server Portal User's Guide, section 1.3.1 Adding a Portlet to a Page.

Note: After adding the Lotus Notes Portlets to an Oracle Portal page, If you are logged on as a user other than the Oracle Portal administrator,  you will be asked to update the login information for the External Application before viewing the portlets. Click on the Update Login Information link and enter your Lotus Domino user credentials: Username, Password and MailFilename to view the portlets.

Trademarks

Oracle and the Oracle logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries.

Lotus, Lotus Notes, and Lotus Domino are trademarks or registered trademarks of International Business Machines in the United States and other countries. 

All other names are trademarks and/or registered trademarks of their respective owners.