# Installation and Upgrade Guide

# Welcome

AquaLogic Interaction Portlet Suite - IMAP provides a set of portlets that allows portal users to access E-mail from an Internet Message Access Protocol (IMAP)-compliant server through the AquaLogic Interaction portal.

This release provides localization support for eight languages: English, French, German, Italian, Spanish, Chinese Traditional, Japanese, and Korean.

This book describes how to install and deploy AquaLogic Interaction Portlet Suite - IMAP. It also provides instructions for upgrading and uninstalling.

## How to Use This Book

This guide has been designed to be a quick reference for users with installation experience, while also providing detailed instructions for users installing for the first time.

### Audience

This guide is written for the portal administrator who is responsible for managing portal infrastructure, including the installation and configuration of portlets that enable new services for portal users and groups.

If you are not already familiar with AquaLogic User Interaction, consider reading the Deployment Guide for BEA AquaLogic User Interaction and the Administrator Guide for AquaLogic Interaction before proceeding with installation of this product.

The user installing this software should also have strong knowledge of the web and application servers required for installation.

### Organization

This guide includes the following chapters:

- This chapter provides information on how to use this guide and describes other resources available to help install, deploy, upgrade, and administer IMAP Portlets.
- Installation Prerequisites, provides hardware and software requirements, as well as environmental and third-party software prerequisites. You must read this chapter and meet the prerequisites prior to proceeding to the installation or upgrade.
- Installing or Upgrading the IMAP Portlets, provides detailed instructions for installing, upgrading, and configuring IMAP Portlets.
- Registering and Configuring Portlets, provides detailed instructions for upgrading to IMAP Portlets 3.2 MP1.
- Troubleshooting the IMAP Portlets, provides examples of errors you might encounter and solutions to those errors.
- Uninstalling the IMAP Portlets, provides instructions for uninstalling IMAP Portlets.

### Terminology

This guide uses the term "Remote Server" to identify the Portlet Suite services in relation to intrinsic portal services. After you install the Portlet Suite software on a Remote Server host computer, the Portlet Suite services can be managed through the portal Administration tool as a Remote Server. For detailed information on managing a Remote Server in the AquaLogic Interaction portal, refer to the online help and the Administrator Guide for AquaLogic Interaction.

In some instances, the word "Gadget" appears in the user interface and documentation. "Gadget" is an earlier term for "portlet" and any references are intended to identify a portlet.

## Typographical Conventions

This book uses the following typographical conventions.

Table 1-1 Typographical Conventions
Convention | Typeface | Examples/Notes
--- | --- | ---
File names Folder names Screen elements | bold | Upload Procedures.doc to the portal. The log files are stored in the logs folder. To save your changes, click Apply Changes.
Text you enter | `computer` | Type `Marketing` as the name of your community.
Variables you enter | `computer with angle brackets (<>)` | Enter the base URL for the Remote Server. For example, `http://<my_computer>/`.
New terms Emphasis Object example names | italic | Portlets are Web tools embedded in your portal. The URI must be a unique number. The example Knowledge Directory displayed in Figure 5 shows the Human Resources folder.

## BEA Documentation and Resources

This section describes the documentation and resources provided by BEA.

Table 1-2 BEA Documentation and Resources
Resource | Description
--- | ---
Release Notes | These files are written for AquaLogic Interaction Portlet Suite - IMAP administrators. They include information about new features and known issues in the release. They are available on http://www.oracle.com/technology/documentation/index.html and on the application CD.
Online Help | The online help is written for all levels of IMAP Portlets users. It describes the user interface for IMAP Portlets and gives detailed instructions for completing tasks in IMAP Portlets. To access online help, click the help icon.
Developer Guides, Articles, API Documentation, Blogs, Newsgroups, and Sample Code | These resources are provided for developers on the BEA dev2dev site (dev2dev.bea.com). They describe how to build custom applications using AquaLogic User Interaction and how to customize AquaLogic User Interaction products and features.
Deployment Guide | This document is written for business analysts and system administrators. It describes how to plan your AquaLogic User Interaction deployment. It is available in electronic form (PDF) on http://www.oracle.com/technology/documentation/index.html.
AquaLogic User Interaction Support Center | The AquaLogic User Interaction Support Center is a comprehensive repository for technical information on AquaLogic User Interaction products. From the Support Center, you can access products and documentation, search knowledge base articles, read the latest news and information, participate in a support community, get training, and find tools to meet most of your AquaLogic User Interaction-related needs. The Support Center encompasses the following communities: Technical Support Center Submit and track support incidents and feature requests, search the knowledge base, access documentation, and download service packs and hotfixes. User Group Visit the User Group section to collaborate with peers and view upcoming meetings. Product Center Download products, read Release Notes, access recent product documentation, and view interoperability information. Developer Center Download developer tools and documentation, get help with your development project, and interact with other developers via BEA's dev2dev Newsgroups. Education Services Find information about available training courses, purchase training credits, and register for upcoming classes. If you do not see the Support Center when you log in to http://support.plumtree.com, contact ALUIsupport@bea.com for the appropriate access privileges.
dev2dev.bea.com | Download developer tools and documentation, get help with your development project, and interact with other developers via BEA's dev2dev Newsgroups.
Technical Support | If you cannot resolve an issue using the above resources, BEA Technical Support is happy to assist. Our staff is available 24 hours a day, 7 days a week to handle all your technical support needs. E-mail: ALUIsupport@bea.com Phone Numbers: U.S.A. +1 866.262.PLUM (7586) or +1 415.263.1696 Europe +44 1494 559127 France +33 1.46.91.86.79 Australia/NZ +61 2.9923.4030 Asia Pacific +61 2.9931.7822 Singapore +1 800.1811.202