# 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:

- Install Files on Remote Server
- Configure Remote Server

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).

1. 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.
2. 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:

1. Navigate to the directory referenced by PT_HOME and open pthome.xml in a text editor.
2. 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:

1. Deploy the ali168Samples.war file from the <PT_HOME>/ptjsr168/1.2/webapp directory using the method appropriate for your application server.
2. 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.