Install-Panther WebSphere


Chapter 7. Installation Tasks: UNIX

These instructions apply to both first-time installations and to upgrades from previous versions of JAM and Prolifics. Before beginning the installation, review the requirements and other pre-installation tasks discussed in Chapter 6, "Pre-Installation Tasks: UNIX."

This chapter discusses the following:


Installing Panther

The procedure described here assumes that /usr/prolifics is the Panther installation directory, often referred to as SMBASE. If you are not installing to /usr/prolifics, substitute the name of the directory you are using.

Installing Panther on UNIX requires you to copy the distribution from the delivered media. The Panther installation package comes with supported database drivers for each platform.

How to Install Panther from a CD-ROM

  1. Log in as root or with the login you devised for the installation.
  2. At the command line, type the following.
    mkdir /usr/prolifics
  3. Go to the /usr/prolifics directory by typing the following.
    cd /usr/prolifics
  4. Mount the CD-ROM device as /cdrom.
  5. In /usr/prolifics, to uncompress and extract the contents of the Panther distribution, type the following.
    zcat < /cdrom/CompressedTarFilename | tar -xvf -

    For example, the filenames for the Panther 4.25 distribution are as follows:

    Filename Product

    prlwascl425.tar.Z

    Panther WebSphere Edition Client

    prwassv425.tar.Z

    Panther WebSphere Edition Application Server Engine

    prlwaswb425.tar.Z

    Panther WebSphere Edition Web Application Broker

    prldbs425.tar.Z

    Database driver(s)

When Panther software is loaded, your regular prompt is displayed.


Configuring the Installation

After you copy the distribution, run the setup program to configure your installation.

How to Configure the Installation

  1. If you are installing the web application broker on the same machine, complete the pre-installation steps in Chapter 6.
  2. Go to the /usr/prolifics directory; to do so, type:
    cd /usr/prolifics
  3. Type Setup.

    The setup program guides you through the steps to configure your installation.

Once you finish running the setup program, refer to "Verifying the Installation."

Using the Start-up License

Panther requires licensing in order to develop and run Panther applications. A Start-Up License is provided to allow you to begin using Panther immediately while your request for a permanent license is being processed. The Start-up License is provided on a PC diskette and on paper.

If you wish to install the license from the PC diskette, you may need to mount the diskette on a PC and then transfer the Start-up License file to the computer on which you are installing Panther software, using a transfer file utility such as ftp. Copy the license.dat file to /usr/prolifics/licenses or to the /licenses subdirectory of your Panther installation.

Alternatively, enter the contents of license.dat from the paper copy provided. For more information on installing the Panther license, refer to "Obtaining Panther Licensing."

Configuring a Database Driver

Database drivers need to be installed on

How to Configure Database Drivers

Edit the [databases] section of the initialization files in the config directory of the Panther Installation.

  1. Set installed=Name of database(s).
  2. If more than one database driver is installed, set default=Name of default database.

Panther provides shared libraries for the currently available versions of the following database client software:

Database driver Version Installed=Name of database

DB2

DB2 Version 6

DB2_6

Oracle

Oracle Version 8.1.5 using Pro*C

oracle8iProC

Oracle Version 8.1.5 using OCI

oracle8iOCI

Note: Oracle supports two development interfaces: a C language API called OCI and an embedded SQL language, Pro*C. Most applications can use Panther's OCI or Pro*C interfaces interchangeably. Typically, Panther developers use the OCI interface unless they are linking their own custom Pro*C functions with Panther. To use Oracle's stored procedures, you must use the OCI interface.


What to Do Next

After successfully installing Panther software, there are several post-installation steps required to start using Panther. Chapter 8 discusses the steps required to set up licensing and the environment for each of the Panther components installed, and post-installation issues and troubleshooting tips.