Installation Tasks: Windows

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

This chapter discusses the following topics:

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

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

Insert the CD-ROM in the appropriate drive.
If the setup program does not start automatically, choose Start=>Run. In the Run dialog box, type d:\setup (where d is the letter of the drive from which you are installing).
Choose to install the client, application server engine, or web application broker, if required. The setup guides you through the steps to install and configure your installation.
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.

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).
If licensing is required, you are prompted to insert the Start-Up License diskette.
You are prompted for the licensing-related information. The information is used to obtain a permanent license file and includes contact information and the 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 page -- when you receive your permanent license.

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

Installing a Database Driver

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

Installing a database driver updates your Panther Windows client initialization file (prol4w32.ini) and, if applicable, your Panther application server file (panther.ini).

If your Panther application includes COM components, the technologies which deploy these components (COM, DCOM, MTS) require database access using ODBC. You must install the ODBC driver provided by your database vendor. Support for ODBC databases is built into the Prolifics DLLs.

How to Install a Database Driver

Insert the CD-ROM.
If the setup program does not start automatically, choose Start=>Run. In the Run dialog box, type d:\setup (where d is the letter of the drive from which you are installing).
Choose to install database drivers.
Select appropriate database.
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.

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. Prolifics provides DLLs for the currently available versions of the following database client software for Windows 98, Windows NT, and Windows 2000:

Database Driver			Version
ODBC			Microsoft Open Database Connectivity version 2 Microsoft Open Database Connectivity version 3 Other
Oracle			Oracle Version 7.3 using OCI Oracle Version 7.3 using ProC Oracle Version 8.0.3 using OCI Oracle Version 8.0.3 using ProC Oracle Version 8.1.5 using OCI Oracle Version 8.1.5 using Pro*C Other
Informix			ESQL/C 7.20 TDI ESQL/C 9.20 (Client SDK 2.20) Other
Sybase			Sybase Version 10 using DB-Library Sybase Version 10 using CT-Library Sybase Version 11 using DB-Library Sybase Version 11 using CT-Library Other
Ingres			OpenIngres 1.2 (ESQL/C) Other
MS SQL Server			Microsoft SQL Server Version 6 Microsoft SQL Server Version 7 Other

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 -4- 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.