# Installation and Upgrade Guide

# Installing or Upgrading the IMAP Portlets

This chapter describes how to install or upgrade AquaLogic Interaction Portlet Suite - IMAP. Before you begin, ensure that you have met the prerequisites for installation described in Installation Prerequisites.

This chapter provides detailed installation steps and instructions on how to start the AquaLogic Interaction Portlet Suite - IMAP service and verify your deployment.

- Installing or Upgrading the IMAP Portlets
- Starting the BEA ALI Portlet Suite for IMAP Service
- Verifying Deployment

## Installing or Upgrading the IMAP Portlets

The IMAP Portlet Suite is 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.

Note: | If you have previously installed IMAP Portlets, we recommend uninstalling the earlier files before installing the current version.

To install or upgrade product files:

1. 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.
2. Map a connection to the top-level folder of the AquaLogic Interaction portal installation.
3. Copy the installation package to a location on the Remote Server host.
4. To launch the installer, click the ALIPortletSuiteIMAP_v3-2.exe (Windows) / ALIPortletSuiteIMAP_v3-2 (Unix/Linux) file.
5. 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.
Table 3-1 IMAP Portlets Installer Wizard Pages
Wizard Page | Description
--- | ---
License Agreement | 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 Service, choose Image Service. To install both sets of files, choose Both. (The wizard pages that follow are based on your selection.)
Choose Install 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 Service 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 Service.
Portlet Suite for IMAP Application Port | Specify the port that the Portlet Suite service should use to handle requests. Indicate whether it should be HTTP or HTTPS.
Pre-Installation Summary | Verify the information in the panel and click Install.
Install Complete | Click Done to close the installer.

## Starting the BEA ALI Portlet Suite for IMAP Service

Follow the instructions below to start the IMAP 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 NT Service and ALI IMAP Service.
- Or, type the following at the command line:
  `$ <install base>\PortletSuiteIMAP\3.2\bin\ptimapd.bat start`

To stop the service:

- From the Service Control Manager, stop the ALI IMAP Service.
- From the command line, type the following:
  `$ <install base>\PortletSuiteIMAP\3.2\bin\ptimapd.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>/PortletSuiteIMAP/3.2/bin/ptimapd.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 IMAP service, type the following at the command line:

`$ sh <install base>/PortletSuiteIMAP/3.2/bin/ptimapd.sh stop`

## Verifying Deployment

After you have deployed the package to your application server, run the provided diagnostic utility to verify connectivity among deployment components.

In a Web browser, type the URL for the Remote Server diagnostic utility, for example: http://<remoteserver>:<port>/imap/install. The default port is 11953.

Use the diagnostic 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 IMAP server, click Verify Connection to Backend Server, type the appropriate values, and click Submit. Verify the connectivity information that appears in the Test Results section.

Note: | If your deployment includes multiple IMAP server instances, test connectivity with each server one at a time.

See Registering and Configuring Portlets for instructions on registering portlet services in the portal.