Installation and Upgrade Guide

Installation

This chapter explains how to install and configure the AquaLogic Interaction JSR-168 Container on all supported platforms.

Before installing, confirm that your system meets the requirements. For details, see Installation Prerequisites.

The installation process involves two steps:

In addition, samples illustrating how to use the JSR-168 Container can be installed:

Install the JSR-168 Container Samples

Install Files on Remote Server

Follow the steps below to install the JSR-168 Container on your remote server (host computer).

Ensure the PT_HOME environment variable has been set correctly. If PT_HOME has not been previously set, create a directory for PT_HOME. Set the PT_HOME environment variable to this directory.
Extract the JSR-168 Container distributable to PT_HOME.

On Linux and UNIX, the distributable is ali-jsr168-container-1_2-unix.tgz.
On Windows, the distributable is ali-jsr168-container-1_2-win.zip.

Configure Remote Server

The steps required to configure the remote server vary depending on whether the PT_HOME directory existed prior to installation, or if the PT_HOME directory had to be created.

If the PT_HOME directory already existed:

Navigate to the directory referenced by PT_HOME and open pthome.xml in a text editor.
Add the following code within the pthome element (between <pthome> and </pthome>).

Note: The <path> and <configpath> elements must reflect the fully qualified path to the ptjsr168 directories. Forward slashes must be used regardless of operating system.

<product name="ptjsr168">
<install version="1.2">

<path>C:/bea/alui/ptjsr168/1.2</path>
<configpath>C:/bea/alui/ptjsr168/1.2/settings/config</configpath>

</install>
</product>

If the PT_HOME directory did not exist:

Copy the pthome.xml file from <PT_HOME>/ptjsr168/1.2/settings/config to the root <PT_HOME> directory.

Install the JSR-168 Container Samples

To install the JSR-168 Container samples:

Deploy the ali168Samples.war file from the <PT_HOME>/ptjsr168/1.2/webapp directory using the method appropriate for your application server.
Migrate the jsr-168.pte server package using the method appropriate for the version of AquaLogic User Interaction installed. For details on importing server packages, see the Administrator Guide for AquaLogic Interaction.

The JSR-168 Container server package is <PT_HOME>/ptjsr168/1.2/serverpackages/jsr-168.pte.

After the resource package is imported, a JSR-168 folder will appear in portal administration that includes the JSR-168 Remote Server, two Web Services (RSSPortletWebService and JspPortletWebService), and two portlets (RSSPortlet and JspPortlet). These portlets do not require any configuration.

Note:

Before placing the portlets on a page, edit the JSR-168 Remote Server object and change the Remote Server URL to the correct address of the host computer.

Note:

The sample RSSportlet contains an admin preference page that allows you to save your proxy server settings. You must configure your application server to work with a proxy server setting. Follow the documentation for your application server to configure the proxy server setting.