# Installation and Upgrade Guide

# Installation Prerequisites

Before you run the AquaLogic Interaction Portlet Suite - Lotus Notes installer, complete the following steps:

1. Download the most up-to-date documentation from http://www.oracle.com/technology/documentation/index.html.
2. Read the release notes for additional information on compatibility issues, known problems, and workarounds that might affect how you proceed with your deployment. Release notes are located at the top-level directory of the product package.
3. Provision host computers for your deployment and install prerequisite software. For details, see Hardware and Software Requirements, next.
4. Set the PT_HOME environment variable to `C:\bea\alui`. For details, see Setting the PT_HOME Environment Variable.
5. Configure the Lotus Domino Server, described in the last section in this chapter, Configuring the Lotus Domino Server.

## Hardware and Software Requirements

Note: | For the most up-to-date list of supported software for your deployment, refer to the Interoperability page in the AquaLogic User Interaction Support Center.

The following table summarizes the requirements for AquaLogic Interaction Portlet Suite - Lotus Notes. For the most current platform support information, refer to the Interoperability Matrix in Product Center.

Note: | IPv6 is not supported. Verify that IPv6 is not enabled prior to installing this product
Component | Requirement
--- | ---
Lotus Notes Portlets Host Computer | Hard Drive: 1 GHz or higher Disk: 128 MB available Memory: 512 MB RAM Operating System: Microsoft Windows 2000 Server SP3 or 2003 Server SP1 Red Hat Enterprise Linux 3 Update 3 (ES & AS) on x86 SUSE Linux 9 on x86 AIX 5.3 on POWER3, POWER4, POWER5 Solaris 8 and 9 on SPARC Application Server: BEA WebLogic 8.1 SP2 Apache Tomcat 4.1.30 IBM WebSphere 5.1.0.3
Portal Software | AquaLogic Interaction 6.1 Plumtree Foundation 6.0.x Plumtree Corporate Portal 5.0.x
Lotus Domino Server | Lotus Domino 5.0.11, 6.0, and 7.0
Network | You must be able to configure communication between the Remote Server, AquaLogic Interaction, and the Lotus Domino Application Server. If the Lotus Domino Server is located on a computer outside of the portal and Remote Server domain, you must configure trust relations between domains.
Client Browser | Internet Explorer 5.x or 6.x Netscape Navigator 4.08 (Windows) or Navigator 4.8 (UNIX) Netscape Communicator 4.79 Netscape 7.1
.

## Setting the PT_HOME Environment Variable

If you are installing AquaLogic User Interaction (or Plumtree) products on the Remote Server for the first time, you must set the PT_HOME environment variable to enable communication among component products.

### Setting the PT_HOME Environment Variable - Windows

To set the PT_HOME environment variable:

1. To display the System Properties dialog box, click Start | Settings | Control Panel | System.
2. To display the Environment Variables dialog box, click the Advanced tab and then the Environment Variables button.
3. To create the PT_HOME environment variable, in the System group, click the New button. In the Variable Name field, type `PT_HOME` and in the Variable Value field, type `C:\bea\alui`.

Note: | The default value for PT_HOME is `C:\bea\alui`. If you set PT_HOME to a different value in your portal installation, specify that value for PT_HOME on the Remote Server.

4. To close the New User Variable dialog box, click OK.
5. To close the Environment Variables dialog box, click OK.
6. To close the System Properties dialog box, click OK.
7. If your Web application server is a service, reboot the computer.
   If your application server is a console application, restart the application server

### Setting the PT_HOME Environment Variable - WebLogic

To set the PT_HOME environment variable in a WebLogic application server:

1. Stop the WebLogic application server.
2. Change to the following directory: <WebLogic Home>/wlserver/config/<mydomain>/
3. Open the startWebLogic.sh file in a text editor.
4. Modify the file by adding the contents of the pthome.sh script (in the /bea/alui directory) before the string that invokes Java.
5. Optionally, if you intend to manually deploy the package using the command prompt, make this same modification to the setEnv.cmd file located in the same <mydomain> directory. If you intend to complete manual deployment through the administrative console, this modification is not necessary.
6. Restart the application server to initialize your changes.

### Setting the PT_HOME Environment Variable - WebSphere

To set the PT_HOME environment variable in a WebSphere application server:

1. Stop the WebLogic application server.
2. Change to the following directory: <WebSphere Home>/WebSphere/AppServer/bin/
3. Open the startupServer.sh file in a text editor.
4. Modify the file by adding the contents of the pthome.sh script (in the /bea/alui directory) before the string that invokes Java.
5. Restart the application server to initialize your changes.

## Configuring the Lotus Domino Server

This section describes how to verify and modify the Lotus Domino Server configuration so it can receive remote calls from the Remote Server over HTTP and DIIOP.

1. Ensure that the server tasks Hypertext Transfer Protocol (HTTP) and Domino Internet Inter-ORB Protocol (DIIOP) are running.
2. Ensure that the notes.ini file contains the following string:
   `ServerTasks=<any other tasks>, http, diiop`
3. Use the Lotus Notes Administrative client to verify or modify the Lotus Domino Server configuration:

1. Click the Configuration tab. Under Server, select the relevant server document.
2. Click the Security tab of the server document. In the Server Access section, verify that Portlet Suite users are listed in the following locations:

- In the Access server list, check Server Access
- In the Run unrestricted Java/Javascript/Com list, check Java/COM Restrictions.

3. Click Ports | Internet Ports | IIOP and enable the Name & Password authentication option and confirm that TCP/IP Port Status is enabled.

Note: | Lotus Notes Portlets supports only HTTP over SSL; it does not support DIIOP over SSL.

4. Save and close the server document.
5. On the People & Groups tab, verify that all users that connect to the Lotus Domino Server via the Browse the Portlets option have an Internet password.

Note: | In order for attachments to work in Notes portlets, the Java application server service must have access to the share on the Domino server. You must grant access rights to the appropriate WebSphere or WebLogic user. To test your configuration, log in as the user and make sure you can access the share.