Install-Panther WebSphere

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 steps discussed in Chapter 3, "Pre-Installation Tasks: Windows."

This chapter discusses the following topics:

• Running the setup program to install a client, an application server engine, or a web application broker.

• Installing an ODBC or Oracle database driver. DB2 support is available through ODBC.

Installing the Software

Panther is supplied in compressed form on CD-ROM along with a Windows-based setup program. You can choose to install the client, application server engine, or web application broker.

How to Run the Setup Program

1. Insert the CD-ROM in the appropriate drive.
2. If the setup program does not start automatically, choose StartRun. In the Run dialog box, type d:\setup (where d is the letter of the drive from which you are installing).
3. Choose to install the client, application server engine, or web application broker. The setup guides you through the steps to install and configure your installation.
4. During the installation you can select a setup type.

   • Typical—Program files, samples and tutorial files, and development files.

   • Compact—Program files.

   • Custom—The software components to install, including online documentation.

     The Panther software components are as follows.

   • Program Files—Required to run Panther. Contains all configuration files, utilities, and DLLs necessary to run the Panther development environment.

   • Development Files—Optional. Only necessary if you want to add your own C code, link out certain options, or link statically with a database driver.

   • Samples and Tutorial Files—Optional. Installs the sample applications and the Tutorial.

   • Online Documentation—Optional. Because these files can be quite large, consider sharing a copy across a network if disk space is a concern. Or, use the online documentation CD instead of copying them to your PC.

5. You are prompted for a user name. Specify the user account (login) name (up to 31 characters in length). A value is required to run the development executable (prodev).
6. You are prompted to insert the Start-Up License diskette.
7. You are prompted for the licensing-related information. The information is used to obtain a permanent license file and includes contact information and serial number that is located on the media label.

   Note: Panther software is installed with a Start-up License, provided on a separate diskette, which lets you get started. You will need to request a permanent license. Refer to "Obtaining Panther Licenses" when you receive your permanent license.

8. Repeat the setup program to install the other software components.
9. When the setup program is complete, reboot your system to set the new application variables.

---

Installing a Database Driver

After you install the Panther application server engine and/or client on a machine, you can begin installing the database driver.

Installing a database driver updates your Panther Windows client initialization file (prol5w32.ini) and your Panther application server file (panther.ini).

How to Install a Database Driver

1. Insert the CD-ROM.
2. If the setup program does not start automatically, choose StartRun. In the Run dialog box, type d:\setup (where d is the letter of the drive from which you are installing).
3. Choose to install database drivers.
4. Select appropriate database.
5. Select from the following options:

   • Complete Install—Copies the driver files to your PC and configures the initialization file for your database version. Choose this option if you have not previously installed database driver software.

   • Configuration—Updates your initialization file for another version of the database. Choose this option if you already installed the database driver and want to modify the existing database version.

6. Select or confirm the version of your database software. If your version is not listed, choose Other.

Because database vendors frequently update database versions, your particular database version may not be listed in the Panther install program. In this case, choose the latest version for your Panther database driver installation. Panther provides DLLs for the currently available versions of the following database client software:

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 5, "Post-Installation Tasks: Windows," 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.