# Installation and Upgrade Guide

# Installation Prerequisites

Before you run the AquaLogic HiPer Workspace for Retail installer, complete the following steps:

1. Read the product release notes for 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.
2. Provision host computers and configure software dependencies for your deployment. For details, see Hardware and Software Requirements.
3. If you are installing on Linux:

1. Create a directory in which to install HiPer for Retail.
2. If you do not already have a local portal user, create a new local user to run the installer. (You do not need to run the installer as the root user.)

4. Create the HiPer for Retail database. For details, see Creating the HiPer for Retail Database.
5. Complete the deployment component configuration worksheets provided in the Installation and Planning Worksheets for HiPer for Retail.

## Hardware and Software Requirements

The following tables summarize the operating system and software requirements for AquaLogic Interaction. For details on hardware and scaling, see the Deployment Guide for BEA AquaLogic User Interaction. For the most current platform support information, refer to the Interoperability Matrix: log in to: http://portal.plumtree.com, navigate to the Product Center, and click Interoperability.

Caution: | You must use the same software for the HiPer for Retail components as you use for your Plumtree Foundation components. For example, if your portal database uses SQL Server, your HiPer for Retail database must also use SQL Server.
Table 2-1 Hardware and Software Requirements
Component | Requirement
--- | ---
HiPer for Retail | Operating System Windows 2000 Server SP4 Windows 2003 Server Windows 2003 Server SP1 Red Hat Enterprise Linux 3.03 on x86 Recommended Hardware 1 Ghz or faster processor 1 GB ECC RAM or more 10 GB storage 2 GB temp directory Minimum Hardware 600 MHz Pentium III processor 512 MB RAM 4 GB storage 1 GB temp directory
ALI HiPer BAM System (Celequest) | 2 GB temp memory For a production deployment, you should run the ALI HiPer BAM System (Celequest) on a separate machine with at least 2 GB temp memory. Celequest 3.7.2.0.326 For installation instructions, refer to Installation. Java JDK 1.4.x Java JDK is needed to run JBoss. The Java JDK is available from http://java.sun.com. Once installed, set the JAVA_HOME environment variable to point to the installed location of the JDK.
Database | Oracle 9.2.0.6 Oracle 10.1.0.4 Microsoft SQL Server 2000 SP4
Note: | You must use the same database system and version for the HiPer for Retail database as you use for your portal database.
Portal | Plumtree Corporate Portal 5.0.5 Plumtree Foundation 6.0 SP1
Content Server/Publisher | Content Server 6.1 with HF #201492 (for Plumtree Corporate Portal 5.0.5) Publisher 6.2 (for Plumtree Foundation 6.0 SP1)
Browser | Internet Explorer 5.5 Internet Explorer 6.0 Netscape 7.1 Netscape 7.2 Firefox 1.5

## Creating the HiPer for Retail Database

HiPer for Retail requires a database to store metadata relating to the structure of your organization. This database must be the same version as the Portal database.

To create the HiPer for Retail database:

1. Create a user to own the HiPer for Retail database (we refer to this user as the HiPer for Retail user).
2. Create the HiPer for Retail database.
3. Grant the HiPer for Retail user owner rights to the HiPer for Retail database.