# Installation and Upgrade Guide

# Installation - Unix and Linux

This chapter explains how to install and configure the AquaLogic Interaction JSR-168 Consumer on a Unix or Linux operating system for use with AquaLogic Interaction.

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

The installation process includes three steps:

- Install Files on Remote Server
- Configure Remote Server
- Import Resource Package (Web Services and Portlets)

## Install Files on Remote Server

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

1. Check to see if the PT_HOME variable has been set by entering the following command:

    echo $PT_HOME

2. If the PT_HOME variable exists, unzip the jsr-168_java.tgz file to the location returned.
   If the PT_HOME variable does not exist, create a directory called /opt/bea/alui and unzip the jsr-168_java.tgz file to that location.
3. Deploy the PtPortletContainer.war file in the $PT_HOME/ptjsr168/1.1/webapp folder using the method appropriate for your application server.

## Configure Remote Server

The steps required to configure the remote server are different depending on the results of step 1 under Install Files on Remote Server above.

If the PT_HOME variable already exists:

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: If the PT_HOME directory is not /opt/bea/alui, change the `<path>` and `<configpath>` elements to reflect the correct location.

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

    <path>/opt/bea/alui/ptjsr168/1.1</path>
    <configpath>/opt/bea/alui/ptjsr168/1.1/settings/config</configpath>

    </install>
    </product>

If the PT_HOME variable does not exist:

1. Copy the pthome.xml file from opt/bea/alui/ptjsr168/1.1/settings/config to the root /opt/bea/alui directory.
2. Set the PT_HOME environment variable by entering the following commands:

    PT_HOME='/opt/bea/alui'
    export PT_HOME

## Import Resource Package (Web Services and Portlets)

Use the ptmigration.sh script to import the JSR-168 Consumer Web services and portlets into the portal. The ptmigration.sh is located in your portal bin directory:

    cd $PT_HOME/ptportal/<ver>/bin

Where `<ver>` is your portal version (for example, 6.0).

You must provide appropriate input values to the ptmigration.sh script. The parameters are:

    [username] [password] -import [import file name] [log file name] <-noacls> <-overwriteremoteservers> <-createnewobjectinstances>

For example,

    ./ptmigration.sh Administrator "" \ -import $PT_HOME/ptjsr168/1.1/serverpackages/jsr-168.pte migration.log

This command imports the resource package assuming the administrator password is blank ("") and the jsr-168.pte file is in the specified location ($PT_HOME/ptjsr168/1.1/serverpackages/). Any issues with the import will be written to migration.log.

After the resource package is imported, a JSR-168 folder will appear in portal administration that includes the JSR-168 Remote Server, three Web Services (GooglePortletWebService, RSSPortletWebService and JspPortletWebService), and three portlets (GooglePortlet, 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.