# Installation Guide

# Installation

This chapter describes how to install the AquaLogic Interaction WSRP Consumer 1.1.

Note: | There is no upgrade path to WSRP Consumer 1.1. To move from WSRP Consumer 1.0 to 1.1, you must install WSRP Consumer 1.1 and then recreate your portlets.

To install the WSRP Consumer:

1. Install the WSRP Consumer components. For details, see Installing the WSRP Consumer Components,
2. Start the WSRP Consumer service or daemon. For details, see Starting the WSRP Consumer.
3. Import the WSRP Consumer server package into your AquaLogic Interaction deployment. For details, see Importing the Server Package.
4. Verify your installation. For details, see Verifying the Installation.

## Installing the WSRP Consumer Components

This section describes how to install the WSRP Consumer components. The WSRP Consumer has two components: The main WSRP Consumer service and an Image Service component. The Image Service component must be installed on the AquaLogic Interaction Image Service.

### Launching the WSRP Consumer Installer

Launch the WSRP Consumer installer appropriate for your platform:

- On Unix, the installer is WSRPConsumer_v1-1.sh.

Note: | The installer is a graphical, X-Windows client when run in interactive mode. If you are running the installer on a remote terminal, verify you DISPLAY is set appropriately.

- On Windows, the installer is WSRPConsumer_v1-1.exe.

### Completing the Installer Wizard Pages

The following table describes the WSRP Consumer installer wizard pages. The installer wizard pages that appear may vary based on your configuration choices. If the installer setting does not apply to your configuration, the installer does not display the wizard page.

Table 3-1 WSRP Consumer Installer Wizard Pages
Wizard Page | Description
--- | ---
Introduction | This installer wizard page provides a brief description of the installer and describes how to run the installer in silent mode.
Choose Components | Select the components you are installing on this host. If you have an AquaLogic Interaction Portal, the Image Service files must be installed to an ALI Image Service directory.
Choose Install Folder | The install directory for the WSRP Consumer component. The default is recommended.
Configuration Manager - Port and Password or Configuration Manager - Update | If the Configuration Manager is not installed on this host, the Configuration Manager is installed by the installer. Type the port and password for the Configuration Manager. or If the Configuration Manager is already installed on this host, you may keep its settings or update the port and password. To update the port and password, check the box next to Update password and port. Then, click Next.
Path to Image Service Files | Install the Image Service files to the same location as the AquaLogic Interaction Image Service files.
Pre-Installation Summary | Review the installation summary before continuing.
Launch Configuration Manager | Follow instructions to launch the Configuration Manager and complete configuration of the WSRP Consumer Application Settings.
Note: | Configuration of the WSRP Consumer port is not necessary if the default port is acceptable in your environment.
If you change the WSRP Consumer port, you must also change the port in the Remote Server object for the WSRP Consumer. For more information on editing Remote Server objects, consult the AquaLogic Interaction online help.
Application Settings Confirmation | Select Yes and confirm that you have updated the WSRP Consumer configuration in the Configuration Manager.
Install Complete | Click Done to exit the installer.

## Starting the WSRP Consumer

This section describes how to the start the WSRP Consumer. It is divided into two sections:

- Starting the WSRP Consumer Windows Service
- Starting the WSRP Consumer Unix Daemon

### Starting the WSRP Consumer Windows Service

The WSRP Consumer service is started and stopped using the Windows service manager. To start the WSRP Consumer service:

1. Open the Windows service manager. From Windows, select Start | Control Panel | Administrator Tools | Services.
2. Start the BEA ALI WSRP Consumer.

### Starting the WSRP Consumer Unix Daemon

The WSRP Consumer daemon is started and stopped using a shell script. To start the WSRP Consumer daemon:

1. From your shell, navigate to the WSRP Consumer bin directory:

install_dir`/ptwsrp/1.1/bin/`

2. Start the WSRP Consumer daemon using wsrpconsumerd.sh:

`./wsrpconsumerd.sh start`

## Importing the Server Package

The WSRP Consumer server package creates a Remote Server and a Web Service object for the WSRP Consumer.

In your AquaLogic Interaction Portal, import the WSRP Consumer server package. The server package is:

install_dir`/ptwsrp/1.1/serverpackages/WSRPConsumerWebService.pte`

For details on importing server packages into your portal, see the AquaLogic Interaction online help.

## Verifying the Installation

You can verify your installation by navigating to the WSRP Consumer status page. To do this, navigate to

`http://`host`:`port`/wsrp/`

using a browser. The following message is displayed:

AquaLogic Interaction WSRP Consumer 1.1 is started.

Note: | The default port is 21020.

You can further verify the WSRP Consumer by creating a WSRP portlet. For details, see Creating a WSRP Portlet on AquaLogic Interaction.