Summary of the content on the page No. 1
2–Tier Installation
April 1999
Summary of the content on the page No. 2
This software manual is documentation for Panther. It is as accurate as possible at this time; however, both this manual and Panther itself are subject to revision. Prolifics and JAM are registered trademarks and JAM/TPi and Panther are trademarks of JYACC, Inc. BEA TUXEDO is a registered trademark and BEA WebLogic Enterprise is a trademark of BEA Systems, Inc. DynaText is a registered trademark of Inso Corporation. FLEXlm is a registered trademark of GLOBEtrotter Software, Inc. HP is a tradem
Summary of the content on the page No. 3
Table of Contents About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Organization of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Text Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Keyboard Conventions . . . . . . . . .
Summary of the content on the page No. 4
Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Installing a Database Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Client: Post-Installation for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Post-Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Create New Prolifics Executables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Configure the Client
Summary of the content on the page No. 5
Web Application Server: Post-Installation for UNIX . . . . . . . . . . . . . . . . 44 Post-Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Configure the Web Application Server Environment . . . . . . . . . . . . . 45 Creating Your Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Verify the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Look at Samples . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
About this Guide The Installation Guide contains complete instructions for installing Panther and for setting up the initial configuration on machines for the supported platforms. It also discusses system requirements, contents of the installation package, licensing, and linking in databases. The guide assumes that the person doing the installation is a system administrator or someone familiar with UNIX and Windows operating systems. Organization of this Guide This guide includes the following i
Summary of the content on the page No. 7
Conventions In addition, appendices provide information on modifications you can make to the distributed initialization files, background information on licensing including license utility programs, and the format and content of the password-enabled license file. Conventions The following typographical and terminological conventions are used in this guide: Text Conventions expression Monospace (fixed-spaced) text is used to indicate: Code examples. Words you’re instructed to type exactly as
Summary of the content on the page No. 8
Panther Documentation Alt+A Physical keys are indicated with initial capitalization, and keys that you press simultaneously are connected with a plus sign. Panther Documentation The Panther documentation set includes the following guides and reference material (available as indicated), as illustrated in Figure NO TAG: Installation — Instructions for installing software and licensing for Panther products in the following books: JetNet Installation, TUXEDO Installation, MTS Installation, WebLogic
Summary of the content on the page No. 9
Panther Documentation Database Drivers — Instructions for using Prolifics’s database drivers. Each driver has its own section containing the information specific to that relational database engine. Configuration — Instructions for configuring Prolifics on various platforms and to your preferences. Also includes information on GUI resource and initialization files. Installation* Getting Started* New Features Guide Upgrade Guide (for new users) (for Prolifics upgrades) (for JAM upgrades) Developer
Summary of the content on the page No. 10
Online Documentation MTS Guide — Instructions for building and deploying COM components in your Prolifics three-tier application. WebLogic Enterprise Guide — Instructions for building and deploying WebLogic Enterprise components in your Prolifics three-tier application. Quick Reference — Easy reference to all Prolifics properties and definitions associated with application objects. Also includes quick reference to database and transaction manager commands, library functions, JPL commands, Prolif
Summary of the content on the page No. 11
Online Documentation Proximity searches If desired, you can include proximity search parameters in your text searches. For example: connection within 5 words of database screen within 2 words before editor Boolean searches You can also include Boolean search parameters in your text searches using the following keywords: and, not, or. For example: procedure or module Search forms Prolifics provides additional search forms which search for library functions and for text within code examples.
Summary of the content on the page No. 12
Online Documentation For more information on using DynaText, refer to the Using DynaText title in the Collection window. The following information is also provided with your Prolifics installation: Collateral Documentation Online README file. Contact Prolifics for more information on the following services: Additional Help Product Support Consulting Services Educational Services About this Guide xiii
Summary of the content on the page No. 13
Summary of the content on the page No. 14
Installation Checklist Use this checklist to ensure that you complete the appropriate steps to install and configure your Prolifics development environment for the chosen architecture. Pre-Installation Determine the application architecture. p. 4 Based on architecture, decide which components to p. 4 install. Satisfy hardware and software requirements for the Windows: p. 7 components you plan to install. Windows Web: p. 19 UNIX: p. 27 UNIX Web: p. 43 Installation Install each Prolifics c
Summary of the content on the page No. 15
1 1 General Information In order to help you install the appropriate components, this chapter describes the contents of the Panther installation package, application architectures, and the functionality of the Prolifics software components that make up your Panther distribution. Before you begin the installation process, review the Release Notes for the latest information about Panther, including known problems. Contents of the Installation Package The Panther installation package consists of th
Summary of the content on the page No. 16
Application Architecture Database drivers for connecting to third-party relational databases, such as Oracle and Sybase. Files for C program development. Files for Java program development. License management software. Online documentation and help system; sample two-tier applications and a tutorial; and the Prolifics Gallery, which includes a variety of sample web applications. Application Architecture Choose the appropriate architecture for your application based on your require- men
Summary of the content on the page No. 17
For More Information For More Information After Panther is installed and configured, you can refer to the online documenta- tion for information on specific topics. The preface, About this Guide, contains a suggested reading path and more information about the documentation. Refer to: For: Getting Started Step-by-step instructions for building a two-tier application, including setting up a client environ- ment as well as a web application server. online New Features Guide New features in Panther
Summary of the content on the page No. 18
2 2 Client: Windows Installation Client: Pre-Installation for Windows This section discusses hardware and software requirements and upgrade informa- tion for Prolifics software running under Windows. Hardware and Software Requirements The full installation of the Panther development environment requires the following: 80486 or better processor; Pentium processor is recommended. A maximum of 137 MB of disk space (of which 35 is for the online documen- tation). However, the disk space required
Summary of the content on the page No. 19
Client: Pre-Installation for Windows 32 MB of memory. Database vendor’s client and network software installed if you are using a database other than JDB. For more information, consult the database-specific release notes online. To use Java files, you must have either JDK 1.1 (Java Development Kit) or the JRE (Java Runtime Environment), or compatible versions, installed. To compile Java programs, the JDK is required. If you are using Microsoft’s Virtual Machine for Java, use version 5.00.31
Summary of the content on the page No. 20
Client: Installation for Windows Client: Installation for 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 earlier in this chapter. This section discusses running the setup program to install a Prolifics client and database drivers under Windows. Installation Procedure Panther is supplied in compressed form on CD-ROM a
