> Installation and Upgrade Guide > Installation - Unix and Linux

Installation and Upgrade Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

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

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

  Back to Top       Previous  Next