HP Panter 2Tier User Manual
2–Tier Installation
April 1999
This software manual is documentation for Panthert. 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 trademark of Hewlett-Packard Company.
INFORMIX and C-ISAM are registered trademarks of Informix Software, Inc.
IBM, DB2, and RISC System/6000 are registered trademarks and CICS is a trademark of International
Business Machines Corporation.
Microsoft, MS-DOS, Windows, Windows NT, SQL Server, ActiveX, and Visual C++ are registered trade-
marks and Microsoft Windows 95, Authenticode, Microsoft Transaction Server, Microsoft Access, Microsoft Internet Explorer, Microsoft Internet Information Server, Microsoft Management Console, and Microsoft Open Database Connectivity are trademarks of Microsoft Corporation.
Motif is a trademark of the Open Software Foundation, Inc.
Oracle and SQL*Net are registered trademarks and Oracle7, Oracle8, PL/SQL, Pro*C, Rdb7, and Rdb8 are
trademarks of Oracle Corporation.
Netscape and Netscape Navigator, and Netscape Fast Track Server are registered trademarks of Netscape
Communications Corporation.
Sun, SunOS, Solaris, JavaScript, JDK, and Java are trademarks and Sun Workstation is a registered trade-
mark of Sun Microsystems, Inc.
SYBASE is a registered trademark and Client-Library and DB-Library are trademarks of Sybase, Inc.
UNIX is a registered trademark in the United States and other countries, licensed exclusively through
X/Open Company Limited.
The X Window System is a trademark of the Massachusetts Institute of Technology.
Other product names mentioned in this manual may be trademarks or registered trademarks of their respective owners, and are used for identification purposes only.
Send suggestions and comments regarding this document to:
Technical Publications Manager
Prolifics http://www.prolifics.com
116 John Street support@prolifics.com
New York, NY 10038 (212) 267–7722
1997, 1998, 1999 JYACC, Inc.
All rights reserved.
Printed in USA.
Table of Contents
About this Guide vii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Organization of this Guide vii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Panther Documentation ix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Online Documentation xi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Checklist 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1 General Information 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents of the Installation Package 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Architecture 4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Which Panther Components to Install? 4. . . . . . . . . . . . . . . . . . . . . . . . . . .
For More Information 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 2 Client: Windows Installation 7. . . . . . . . . . . . . . . . . . . . . . .
Client: Pre-Installation for Windows 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardware and Software Requirements 7. . . . . . . . . . . . . . . . . . . . . . . .
Upgrading 8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Installation for Windows 9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iii
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 Environment 15. . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Installation 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at Sample Applications 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Troubleshooting 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 3 Web Application Server: Windows 19. . . . . . . . . . . . . . . . .
Web Application Server: Pre-Installation for Windows 19. . . . . . . . . . . . . .
Before Installing 20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Web Application Server: Post-Installation for Windows 21. . . . . . . . . . . . . .
Post-Installation Overview 21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing for Prolifics Web Application Server 21. . . . . . . . . . . . . . . . .
Configure the Web Application Server Environment 23. . . . . . . . . . . . .
Verify the Installation 24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at Samples 25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 4 Client: UNIX Installation 27. . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Pre-Installation for UNIX 27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardware and Software Requirements 27. . . . . . . . . . . . . . . . . . . . . . . .
File Ownership and Protection 28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Determine File Location 29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Installation for UNIX 30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Procedure 30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring the Installation 31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Post-Installation for UNIX 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-Installation Overview 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing for Prolifics 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create New Prolifics Executables 36. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Client Environment 38. . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Installation 40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at A Sample Application 40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-Installation Notes 41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Troubleshooting 41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 5 Web Application Server: UNIX 43. . . . . . . . . . . . . . . . . . . . .
Web Application Server: Pre-Installation for UNIX 43. . . . . . . . . . . . . . . . .
iv 2-Tier Installation
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 47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix A Notes for Microsoft Windows 49. . . . . . . . . . . . . . . . . . . . . .
DLLs for JPEG Decoding 49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Environment Space 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visual C++ Floating-Point Options 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Prolifics Utilities 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B Initialization and Databases 53. . . . . . . . . . . . . . . . . . . . . . .
Appendix C License Administration 57. . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing in Prolifics 58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
License Daemons and License Types 58. . . . . . . . . . . . . . . . . . . . . . . . .
Options File 59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Utilities 61. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix D License File 73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents of the License File 73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix E Error Messages 77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prolifics Installation Error Messages 77. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DLL Messages 79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Informix-Specific Messages 79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Microsoft SQL Server-Specific Messages 79. . . . . . . . . . . . . . . . . . . . .
ODBC-Specific Messages 80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Oracle-Specific Messages 80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sybase-Specific Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DLL Version Mismatch Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . .
Graph-Related Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
License Manager Error Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prolifics License-Related Messages 82. . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Informational Messages 86. . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Configuration Problem Messages 88. . . . . . . . . . . . . . . . . . . .
Daemon Software Error Messages 89. . . . . . . . . . . . . . . . . . . . . . . . . . .
Index 93. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents v
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 information:
` Pre-installation information — An overview of application architectures, the
Prolifics components which make up Panther, and requirements and
procedures necessary to install Panther.
` Installation instructions — Installing Prolifics software components on UNIX
and Windows systems.
` Post-installation notes — Instructions on verifying installation and configura-
tion, how to install the licensing software, creating new Prolifics executables
for your installation, and information about sample applications distributed
with Panther.
vii
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
KEYWORDS
numeric_value
[option_list]
{x | y}
x ...
new terms
Monospace (fixed-spaced) text is used to indicate:
` Code examples.
` Words you’re instructed to type exactly as indicated.
` Filenames, directories, library functions, and utilities.
` Error and status messages.
Uppercase, fixed-space font is used to indicate:
` SQL keywords.
` Mnemonics or Prolifics constants.
Italicized helvetica is used to indicate placeholders for information you supply.
Items inside square brackets are optional.
One of the items listed inside curly braces needs to be selected.
Ellipses indicate that you can specify one or more items, or that an element can be
repeated.
Italicized text is used:
` To indicate defined terms when used for the first time in the guide.
` Occasionally for emphasis.
Keyboard Conventions
XMIT
viii
Prolifics logical keys are indicated with uppercase characters.
2-Tier Installation
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 Enterprise Installation, and 2-Tier Installation.
New Features Guide — Information about new features in Panther, including Java
support, enhanced three-tier and web functionality, new properties, new library
functions, and, for Windows 32–bit platforms, tab controls and dockable toolbars.
Upgrade Guide — Information for upgrading from JAM to Panther.
Getting Started — Introduction to the Prolifics products and the tutorial, with
step-by-step instructions that help you get started with understanding, setting up
and developing either a two- or three-tier Prolifics application.
Developer’s Guide — Introduction and process of how to use Prolifics to build
two- and three-tier Prolifics database applications. As the major developer’s
manual, it includes information for each step of the development path.
Web Developer ’s Guide — Introduction and process of how to build and deploy a
Prolifics web application.
Using the Editors — Instructions for using the Prolifics graphical authoring
environment—the screen editor, screen and report wizards, JIF editor, menu bar
editor, and styles editor—to build two- and three-tier applications.
Programming Guide — Describes JPL, Prolifics’s scripting language, and
Prolifics’s Java programming interface. Also includes alphabetical listings of JPL
commands, built-in functions, Prolifics’s library functions, transaction manager
commands, and database commands and variables.
Reports — Instructions for using Prolifics’s report generation utility to build,
modify and run reports.
JDB — Instructions for using JDB, Prolifics’s prototyping database, and JISQL,
the interactive SQL editor for JDB. Also describes how to build SQL statements
and the SQL commands available in JDB.
About this Guide ix
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*
(for new users)
Using the Editors
Web Developer’s Guide
Reports
Additional Reference:
Quick Reference
New Features Guide
(for Prolifics upgrades)
Programming
Guide
Developer’s Guide
WebLogic Enterprise Guide
Properties Reference
(online only)
Upgrade Guide
(for JAM upgrades)
JetNet Guide
TUXEDO Guide
MTS Guide
(three-tier only)
Database Drivers
Configuration
JDB
Master Index/Glossary
Figure 1. A suggested reading path for the Panther documentation set. An asterisk (*)
indicates that there are multiple versions of the book for different environments.
JetNet Guide — Instructions for configuring and monitoring your Prolifics
three-tier JetNet application.
TUXEDO Guide — Instructions for configuring and monitoring your Prolifics
three-tier TUXEDO application.
x
2-Tier Installation
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, Prolifics
development utilities, and application variables.
Master Index/Glossary — Master index for all manuals—online and printed. Also
a reference to terms used throughout the documentation set.
Online Documentation
Panther’s documentation set is available online and included with the Panther
distribution. The books can be viewed through the DynaTextTM browser on GUI
platforms. To access the books, choose Help from within Prolifics or run
DynaText’s read-only browser by clicking on the DynaText icon or typing dtext
at the command line. For instructions on using DynaText, choose Help from within
a DynaText browser window, or refer to the Using DynaText title in the Collection
window.
Online Documentation
Using DynaText
About this Guide xi
DynaText is a full-featured online documentation system with support for:
` Text searches
After you open a title in the Collection window, the search panel is at the
bottom of the DynaText window. When you type in a search string, DynaText
lists the number of hits next to the title of each book, chapter and subsection.
Two wildcard characters are available: ? (a single character) and * (0 or more
characters). DynaText performs an exact match on the search string; you will
need to enter a wildcard if a word is used in both singular and plural contexts.
For example:
server returns: server
server* returns: server, servers, server.lib,
client/server
Common words can be on the search engine stop list or be one of the query
keywords. Either condition produces a DynaText error. Enclose the search
string in quotation marks and submit again. For example:
”use in select”
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. Choose Book⇒Search Forms (Windows)
or Search⇒Forms (Motif).
` Alternate documentation views
To automatically open the graphics, instead of displaying them as icons, on the
View menu, choose View⇒Main⇒Inline. (The default setting is Fulltext.)
xii
To view a list of tables in the documentation, on the View menu, choose
View⇒TOC⇒Tabletoc.
` Public and private annotations
You can create your own notes inside the documentation using annotations.
The annotations are stored in the directory location specified in your .ebtrc
(Motif) or dynatext.ini (Windows) file.
` Print capability
You can print any section of the documentation or its table of contents to a
PostScript printer or file. After you choose File⇒Print:
• Highlight the desired section of the documentation. (It defaults to the
current section of documentation in the book window.)
• Choose the desired print format: full text or table of contents.
• To print to a PostScript file, modify the Print Setup in Windows, or select
the Print to File check box in Motif.
Note: Unless you print an entire chapter, the introductory paragraphs will not
be printed. If you highlight Prolifics, DynaText will attempt to print the entire
documentation set.
2-Tier Installation
Online Documentation
For more information on using DynaText, refer to the Using DynaText title in the
Collection window.
Collateral
Documentation
Additional Help
The following information is also provided with your Prolifics installation:
` Online README file.
Contact Prolifics for more information on the following services:
` Product Support
` Consulting Services
` Educational Services
About this Guide xiii
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
-
install.
Satisfy hardware and software requirements for the
-
components you plan to install.
Installation
Install each Prolifics component. Windows: p. 9
-
Post-Installation
Submit request for permanent license (in the mean-
-
time, you can start using Prolifics since it is installed
with a Start-up License).
Create new Prolifics executables, if necessary. Windows: p. 13
-
Configure the client environment. Windows: p. 15
-
(Web application development only) Configure the
-
web application server environment.
p. 4
Windows: p. 7
Windows Web: p. 19
UNIX: p. 27
UNIX Web: p. 43
UNIX: p. 30
Windows Web: p. 21
UNIX: p. 33
UNIX: p. 36
UNIX: p. 38
Windows Web: p. 23
UNIX Web: p. 45
Verify installation and configuration. Windows: p. 16
-
Windows Web: p. 24
UNIX: p. 40
UNIX Web: p. 46
Look at sample applications. Windows: p. 16
-
Windows Web: p. 25
UNIX: p. 40
UNIX Web: p. 47
When you complete the appropriate steps in the installation checklist, and set up
your application environment, you are ready to build a Prolifics application.
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 the items listed below. Some of these
items may not be required or appropriate for your particular installation, and
therefore are not included in your package. For a complete list of files included in
the installation, refer to packlist.txt in the notes subdirectory of the
installation.
11
` Prolifics client and web application server executables, with corresponding
utilities, tools, and configuration files.
` JDB, the Prolifics single-user database.
3
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 requirements.
- Two-tier application
The two-tier client/server model typically separates
data from the logic of an application.
- Web application
A web application is an application deployed on the
web application server and viewed from a web
browser. The web application server works with your
HTTP server software.
Which Panther Components to Install?
For Panther, you are required to install the Prolifics client software. You can also
choose to install a web application server. Each component is described, as well as
the platforms on which each component is supported. Based on your chosen
architecture, install the appropriate Prolifics components purchased.
` Prolifics client — Provides the development and runtime environment for
building two-tier applications. Client platforms supported are:
UNIX
-
Windows 32-bit (95/98 and NT 4)
-
` Prolifics web application server — Provides the runtime environment for
client-server applications that are accessed through web browsers. Web
application server platforms supported are:
UNIX
-
Windows NT 4
-
4 2-Tier Installation
For More Information
After Panther is installed and configured, you can refer to the online documentation 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
online New Features Guide New features in Panther.
online Upgrade Guide Upgrade information from JAM to Panther.
online Configuration Prolifics variables used for configuring Prolifics on
Developer’s Guide Introduction and process of how to build database
For More Information
application, including setting up a client environment as well as a web application server.
various platforms and to your preferences. Information on GUI resource and initialization files.
applications.
online Using the Editors Basic guide to the Prolifics graphical authoring
environment.
Web Developer ’s Guide Guide to building and deploying a Prolifics web
application.
Reports Guide to using Prolifics’s report generation utility
to build, modify and run reports.
Programming Guide Guide to JPL, Prolifics’s programming language,
and using Java and C library functions in Prolifics.
online JDB Guide to JDB, Prolifics’s prototyping database, and
JISQL, the interactive SQL editor for JDB.
readme.* in the notes
subdirectory
fixlist.txt in the
notes subdirectory
Database-specific release notes detailing the setup
of your Prolifics application as a database client.
List of bugs fixed in Prolifics.
Chapter51 General Information
Client: Windows
Installation
Client: Pre-Installation for Windows
This section discusses hardware and software requirements and upgrade information 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.
22
` A maximum of 137 MB of disk space (of which 35 is for the online documen-
tation). However, the disk space required can be less depending on the options
installed. The installation checks for adequate space.
` Microsoft Windows 95/98 or Microsoft NT 4.
Note: Under Windows platforms, web application servers are only supported
on Windows NT, version 4.
7
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.3167 (1/25/99) or later.
` If you are going to add your own C functions to Prolifics, install the Microsoft
Visual C (MSVC) compiler (version 6 for Windows 95/98 and NT 4). You also
need to install the MFC (Microsoft Foundation Class) portion of MSVC along
with the compiler.
If you are installing a Prolifics client and web application server on the same
Windows NT machine, you must install them in the same directory. This allows
them to share common environment settings that point to the location of required
files. It also saves disk space.
Upgrading
If you are upgrading from an earlier version of Prolifics, install Panther in a
separate directory from previous installations, for example, C:\Panther.
The setup program unsets any existing SMVARS, SMPATH, SMTERM, SMMSGS, SMKEY,
and SMVIDEO settings in your autoexec.bat file. The setup program lets you
choose from the following three options:
` Let the setup program modify the autoexec.bat file. The existing
autoexec.bat is saved to autoexec.xxx where xxx is a three-number
extension.
` Save the required changes to autoexec.new file.
` Not make any changes for the autoexec.bat file.
After successfully installing Prolifics software, there are several post-installation
steps required to start using Prolifics. This chapter discusses licensing, building
Prolifics executables, the steps required to set up the environment for each of the
Prolifics components installed, and post-installation issues and troubleshooting
tips.
8 2-Tier Installation
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 along with a Windows-based
setup program.
To run the setup program:
1. Insert the CD-ROM in the appropriate drive.
2. If the setup program does not start automatically, choose Start⇒Run. In the
Run dialog box, type
you are installing).
D:SETUP (where D is the letter of the drive from which
Client: Installation for Windows
Choose to install the Client software.
The setup guides you through the steps to install and configure your
installation.
3. During the installation you can select a setup type. Each setup type includes
certain Prolifics components. The components are:
• Program Files — Required to run Prolifics. Contains all configuration
• Development Files — Optional. Only necessary if you want to add your
• Samples and Tutorial Files — Optional. Installs the sample applications
• Help Files and Online Documentation — Optional. Since these can be
Chapter92 Client: Windows Installation
files, utilities, and DLLs necessary to run the Prolifics development
environment.
own C code, link out certain options, link statically with a database driver,
or use Java files with the client or web application server.
VideoBiz (two-tier application), Enterprise Bank (three-tier application),
sample ActiveX controls, and the Tutorial.
quite large, consider sharing a copy across a network if disk space is a
concern. Or, if you are installing from CD-ROM, leave the files on the
CD-ROM rather than copying them to your PC.
Client: Installation for Windows
Installing a Database Driver
After you install the Prolifics client and or web application server on a machine,
you can begin the database driver installation.
To install database drivers:
1. Insert CD-ROM.
2. Choose Start⇒Run. 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
PROL4W32.INI for your database version. Choose this option if you have
not previously installed database driver software.
• Configuration — Updates PROL4W32.INI for another version of the
database. Choose this option if you already installed the database driver
and want to modify the database version in PROL4W32.INI.
Informix
6. Select or confirm the version of your database software. If your version is not
listed, choose the option Other.
If you are using a database for which DLLs are not provided (see list of provided
DLLs that follows), you must edit the makefile to link in your database, and then
recompile Prolifics using a C compiler. Refer to page 13 for information on
creating new Prolifics executables.
Since database vendors frequently update database versions, your particular
database version may not be listed in the Prolifics install program. In this case,
choose the latest version for your Prolifics database driver installation. Prolifics
provides DLLs for the currently available versions of the following database client
software:
Windows 95/98: Informix Version 7.20.TDI
Or latest version
Other
Windows NT: Informix Version 7.10
Informix Version 7.20.TDI
Informix Version 7.20.TEI
Or latest version
Other
10 2-Tier Installation
Microsoft SQL
Server
ODBC
Client: Installation for Windows
For more information, refer to readme.inf in the Prolifics notes subdirectory.
If you don’t know your Informix version, check the release number listed in the
text files provided in INFORMIXDIR\release where INFORMIXDIR is the root
Informix installation.
Windows 95/98 and NT: Microsoft SQL Server Version 6
Or latest version
Other
Windows 95/98 and NT: Microsoft Open Database Connectivity version 2
Microsoft Open Database Connectivity version 3
Or latest version
Other
If your ODBC version is 2.x or earlier, choose Version 2. ODBC version 1 is
compatible with version 2.
Oracle
Windows 95/98: Oracle Version 7 to 7.2 using OCI
Windows NT: Oracle Version 7.3 using OCI
Check for the supported version in the entry in
ORACLE_HOME\orainst\win95.rgs or ORACLE_HOME\orainst\winNT.rgs.
Note that Pro*C 1.5.x is equivalent to Oracle 7.
Chapter112 Client: Windows Installation
Oracle Version 7 to 7.2 using Pro*C
Oracle Version 7.3 using OCI
Oracle Version 7.3 using Pro*C
Oracle Version 8 using OCI
Oracle Version 8 using Pro*C
Or latest version
Other
Oracle Version 7.3 using Pro*C
Oracle Version 8 using OCI
Oracle Version 8 using Pro*C
Or latest version
Other
Client: Installation for Windows
Oracle supports two development interfaces: a C language API called OCI and an
embedded SQL language, Pro*C. Most applications can use Prolifics’s OCI or
Pro*C interfaces interchangeably. Typically, Prolifics developers use the OCI
interface unless they are linking their own custom Pro*C functions with Prolifics.
To use Oracle’s stored procedures, you must use the OCI interface.
Sybase
Windows 95/98 and NT: Sybase Version 10 using DB-Library
For versions of Sybase earlier than 10, Prolifics/Sybase requires the DB-Library
interface. With Prolifics/Sybase’s support for Sybase Open Client Version 10, two
interfaces are supported, DB-Library and CT-Library.
If you do not know your Sybase version, run the Sybase Windows program
sqlver.exe or refer to the About menu option of any of the Sybase Windows
program (for example, sybping.exe).
Sybase Version 10 using CT-Library
Sybase Version 11 using DB-Library
Sybase Version 11 using CT-Library
Or latest version
Other
12 2-Tier Installation
Client: Post-Installation for Windows
Post-Installation Overview
As part of post-installation, you need to perform the following general steps for
client installations, some of which are based on the architecture of your application. The details of the steps are provided in the pages that follow.
1. Create new Prolifics executables if required.
2. Configure the client environment (refer to page 15).
3. Verify the Prolifics installation based on what you installed (refer to page 16).
4. Look at sample applications (refer to page 16).
Create New Prolifics Executables
As part of the Prolifics installation package, a set of standard Prolifics executables
is provided. Depending on your configuration and on the platform and database
being used, you might need to create new executables. Specifically, a new
executable is required if you are using a database for which DLLs are not provided
(that is, your database is not among those listed starting on page 10).
Client: Post-Installation for Windows
To create new executables, Prolifics distributes a single makefile that can be
invoked via the command line utility, nmake. The instructions are detailed below.
Alternatively, Prolifics distributes a workspace and project files for use with
Microsoft Developer Studio. Instructions on how to use the workspace are
provided in the Release Notes.
To create a new Prolifics executable:
1. Complete the Prolifics installation process.
2. Ensure that the appropriate application variables (SMBASE, etc.) have been
applied to your environment.
3. Go to your application directory (or create one) and copy all files from the
Prolifics link subdirectory to it.
4. Edit the makefile in your application directory, commenting or uncomment-
ing lines as needed to build the appropriate executables. For further information, refer to page 14.
Chapter132 Client: Windows Installation
Client: Post-Installation for Windows
5. Uncomment the appropriate database in the makefile and edit the databasespecific
choose the correct version of your database software. For further information,
refer to page 15.
makevars.dbs (where dbs is the extension of the database) file to
Specifying the
Executables
6. Type
nmake at the command line to build the executable. By default, the
makefile in the current directory is used for the make (and nmake)
command.
7. The make process creates a new Prolifics executable, prodev32.exe. Give
the executable file a unique name to distinguish it from the distributed
executable or others that you have built differently.
8. If you built a new web application server executable (jserver), modify the
SERVER variable in your application’s initialization file to reference the new
jserver executable in its own directory. Do not overwrite the jserver
executable in the util directory.
To indicate the executables to build, edit the
makefile in your application
directory:
1. Comment or uncomment the appropriate client executables as needed (these
are uncommented by default):
PRORUN = prorun32.exe Runtime executable
PRODEV = prodev32.exe Development executable
RWRUN = rwrun32.exe Report utility
If web application server software has been installed, comment or uncomment
the server executable as needed:
JSERVER = jserver.exe Web application server executable (un-
commented by default)
2. To override the value of certain application variables such as SMBASE,
uncomment the appropriate lines in the PARAMETERS section.
3. If you have the Prolifics web application server on the same machine as other
Prolifics software, it is recommended that they be installed in the same
directory. However, if they are not in the same directory, set WEBBASE (in WEB
PARAMETERS
section) to the web application server installation directory.
4. The Prolifics debugger allows you to trace JPL and Prolifics screen events and
is installed by default for clients. If you do not wish to use the debugger,
comment the lines in the DEBUGGER PARAMETERS section.
5. If you want to add Microsoft Codeview debugging information, uncomment
the corresponding block.
14 2-Tier Installation
Client: Post-Installation for Windows
Linking in the
Database
If you are using a database for which DLLs are not provided, you must edit the
makefile in your application directory to link in the appropriate database.
To include the appropriate database in your executables:
1. Uncomment the appropriate include statement in the SELECT DATABASE
SOFTWARE
By default, JDB is uncommented. If you choose another database, you can
leave JDB uncommented (and include it in your executable), or you can
comment out JDB and include only your database.
2. Edit the corresponding
database) file to choose the correct version of your database software.
In the
section of the makefile.
makevars.dbs (where dbs is the extension of the
makevars.dbs file, verify or update the following:
• Set the flag dbs_INIT to one of the following: d, l, u, p. This flag
controls the handling for case sensitivity. The default is d. To find out
what the default is for your database engine, refer to the online databasespecific driver notes.
• In the databaseName PARAMETERS section of makevars, verify your
database engine’s version. Uncomment the appropriate block of
parameters based upon this version. Also, verify and correct the
pathnames if necessary.
• Set the flag dbs_ENGNAME to specify the default engine name.
For more information, refer to the online database-specific driver notes for
additional information on database engines and on case handling.
Configure the Client Environment
A Prolifics client provides the development environment required to build two-tier
applications. The environment must contain properly set application variables in
order to run Prolifics. To set up the development environment, complete the
following platform-specific steps. Refer to the Developer’s Guide for more details
on setting up the client environment.
For each Windows client:
Set the following variables in the following initialization files: prol4w32.ini for
Prolifics and mbedit32.ini for the menu bar editor.
` SMFLIBS — Specify the names of libraries to open automatically during
development and at runtime.
Chapter152 Client: Windows Installation
Client: Post-Installation for Windows
` JAVA_HOME and CLASSPATH — These path names are specific to Java files
and event handlers and need to be set to the location where your Java classes
sit. Additionally, you can change the defaults for SMJAVAEDITOR and
SMJAVAFACTORY and SMJAVALIBRARY. For more information, refer to the
Developer’s Guide.
Verify the Installation
After you install and configure the Prolifics client, you should verify that it starts
up properly. If Prolifics software is not installed and configured correctly, an error
message is displayed. Depending on the problem, the program might also
terminate. Refer to page 77 for a list of the more common error messages related to
system configuration, and how to resolve them.
Client
Installation
On a client machine, a correct installation is verified if you can invoke the Prolifics
editor.
To verify a Windows client installation:
Select the Panther item from the Start menu or double-click on the Panther icon.
Look at Sample Applications
Before you begin building your applications, you might want to look at the
following sample application:
VideoBiz (two-tier application)
Choose the VideoBiz sample on the Start menu. For more information on
VideoBiz, refer to the Developer’s Guide.
Troubleshooting
The information in this section is intended to provide you with additional guidance
when you encounter error messages.
Graph
Functionality
Prolifics’s graph capabilities rely upon external programs (for example, DLLs),
therefore, it is possible for Prolifics to be working properly except for the business
graph component. If you have problems with the graph functionality, check the
following:
Note: The setup program normally performs all of these steps.
16 2-Tier Installation
Client: Post-Installation for Windows
` Ensure that libsti.ini (distributed in the config directory) resides in the
Windows directory and contains the correct paths in it for the
` Ensure that libsti.dll (distributed in the util directory) can be found in a
IPT variable.
directory along the PATH.
Windows PATH
Settings
Online Help and
Manuals
Adding Panther
Documents
If you are upgrading from JAM or an earlier version of Prolifics, remember that
Prolifics’s
since the installation process inserts the Prolifics
of the
util directory must be on your PATH. Normally, this is not an issue
util directory at the beginning
PATH variable. However, the PATH might contain the older util directory. If
this is the case, manually edit the PATH specification in the autoexec.bat file to
remove the older
util directory.
Prolifics’s online help and manuals are built and displayed with DynaText by Inso
Corporation. To verify that you can access the online documents, double-click the
DynaText icon. You should see a dialog containing a list of documents available
through DynaText. If you have problems accessing the documents:
Note: The setup program normally performs all of these steps for you.
` Ensure that the Prolifics util directory is included in the PATH variable.
` Ensure that the dynatext.ini resides in the Windows directory.
` Ensure that SMBASE is set to point to your Prolifics installation.
If DynaText was previously installed, you can use your existing DynaText
configuration file (dynatext.ini) to include the Panther manuals with your
existing list of documents.
To include the Panther manuals in an existing DynaText collection:
Add the following to the COLLECTION line:
` Windows: In dynatext.ini: ProlificsInstallDir\docs = Panther
Chapter172 Client: Windows Installation
33
Web Application
Server: Windows
This chapter contains information for installing the Prolifics web application
server. For information about installing Prolifics client software, refer to page 7.
Web Application Server: Pre-Installation for Windows
Web application servers are only supported on Windows NT, version 4 or higher.
To install a web application server, an HTTP server must be configured and
running on the same system. Prolifics supports industry favorites, such as
Netscape’s Enterprise Server and Microsoft Internet Information Server.
Prolifics supports CGI, ISAPI, and NSAPI architectures. You can select one
according to your preferred configuration.
The Prolifics web application server requires a maximum of 40 MB of disk space.
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.3167 (1/25/99) or later.
19
Web Application Server: Pre-Installation for Windows
If you are installing a Prolifics client and web application server on the same
Windows NT machine, it is recommended that you install them in the same
directory. This allows them to share common environment settings that point to the
location of required files. It also saves disk space.
Before Installing
Before installing a Prolifics web application server, determine the HTTP server
name and the name of the CGI or ISAPI or NSAPI program directory. Also, verify
that your HTTP server is running. Consult your system administrator or your web
server administrator to determine the correct names. Enter the names here for
future reference:
` My HTTP server name is _____________________________________
` My HTTP server \www\scripts directory is
_________________________________________________________
The \scripts\ directory stores the server ’s gateway programs. Another common
name for this directory is cgi–bin.
20 2-Tier Installation
Loading...