This chapter describes how to install AquaLogic Interaction Portlet Suite - Lotus Notes. Before you begin, ensure that you have met the prerequisites for installation and performed the necessary pre-installation procedures described in Installation Prerequisites.
This chapter provides detailed installation steps and instructions on how to start the Lotus Notes Portlets service and verify your deployment.
Lotus Notes Portlets are implemented as a Remote Server in the context of the portal platform. Because mail processes utilize a great deal of host capacity, we recommend provisioning a host machine that is not a host for other AquaLogic User Interaction servers and has no other CPU or memory intensive processes.
To install product files:
Log in to the host computer using an administrator account that has access to the AquaLogic Interaction portal installation. Alternatively, log into any host using an administrator account that has access to the Remote Server host and the portal.
Map a connection to the top-level folder of the AquaLogic Interaction portal installation.
Copy the installation package to a location on the Remote Server host.
To launch the installer, click the ALIPortletSuite-LotusNotes.exe (Windows) / ALIPortletSuite-LotusNotes (Unix/Linux) file.
Complete the installation wizard pages as described in the following table.
Note:
To facilitate any troubleshooting that might be required, as well as communication with IT staff and customer support, we recommend keeping the default settings.
Read and accept the license agreement and click Next.
Choose Server Type
To install only files for the Portlet Suite, choose Remote Server.
To install only files for the Image Server, choose Image Service.
To install both sets of files, choose Both.
(The wizard pages that follow are based on your selection.)
Choose Installation Folder
To accept the default, click Next.
Cryptography Key
Type a random string of ASCII alphabetic and numeric characters to be used to encrypt and decrypt a password.
Specify Image Folder
Click Choose and browse to and select the imageserver directory on the portal host computer. (This page only appears when installing Image Service files.)
Note:
If you choose a different location to install Image Server files, you must copy the files from the images\RemoteGadgets\groupwareui and ImageServer\css subdirectories of the location you specify to the directory for the Image Server on the portal host. If the folders already exist on the portal Image Server, you must copy the files contained in these directories to the portal Image Server.
ALI Portlet Suite - Lotus Notes Application Port
Specify the port the Lotus Notes Portlets service should use to handle requests. Indicate whether it is HTTP or HTTPS.
Note:
This page only appears when installing portlet files.
Domino Server Version Selection
Indicate the version of your Domino Server.
Note:
This page only appears when installing portlet files.
Pre-installation Summary
Verify the information in the page and click Install.
Install Complete
Click Done to close the installer.
Starting the BEA ALI Portlet Suite for Lotus Notes Service
Follow the instructions below to start the Lotus Notes Portlets service.
Windows
To start the service in Windows, use either the Control Panel or the command line:
In Windows Control Panel, select Administrative Tools. Click Services to open the Service Control Manager. Start the BEA ALI Portlet Suite for Lotus Notes service.
Or, type the following at the command line: $ <install base>\PortletSuiteLotusNotes\3.4\bin\ptnotesd.bat start
To stop the service:
From the Service Control Manager, stop the BEA ALI Portlet Suite for Lotus Notes service.
From the command line, type the following: $ <install base>\PortletSuiteLotusNotes\3.4\bin\ptnotesd.bat stop
Unix or Linux
To start the service in Unix or Linux, type the following at the command line:
$ .<pt_home>/pthome.sh
$ sh <install base>/PortletSuiteLotusNotes/3.4/bin/ptnotesd.sh start
Note:
If PT_HOME is set to a directory other than /bea/alui, you must edit the script in the pthome.sh file to reference the correct PT_HOME path.
To stop the service, type the following at the command line:
$ sh <install base>/PortletSuiteLotusNotes/3.4/bin/ptnotesd.sh stop
Verifying Deployment
Run the provided diagnostic utility to verify connectivity among deployment components.
In a Web browser, type the URL for the Remote Server diagnostics utility, for example: http://<remoteserver>:<port>/notes/install.
Note:
The default port is 11952.
Use the diagnostic Web page to verify the following configuration elements:
PT_HOME: To verify that you have set PT_HOME to enable communication among deployment components, click the PT_HOME link and confirm your setting.
Backend Server: To test connectivity to the Lotus Domino server, click Verify Connectionto Backend Server, type the appropriate values, and click Submit. Verify the connectivity information that appears in the Test Results section.
