Page 3 - Table of Contents
iii Table of Contents About this Guide vii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Organization of this Guide vii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conventions viii . . . . . . . . . . . . . . . . . ....
Page 6 - About this Guide; Organization of this Guide
vii About this Guide The Installation Guide contains complete instructions for installing Panther and forsetting up the initial configuration on machines for the supported platforms. It alsodiscusses system requirements, contents of the installation package, licensing, andlinking in databases. The g...
Page 7 - Conventions; Text Conventions
Conventions viii 2-Tier Installation In addition, appendices provide information on modifications you can make to thedistributed initialization files, background information on licensing includinglicense utility programs, and the format and content of the password-enabledlicense file. Conventions Th...
Page 8 - Panther Documentation
Panther Documentation About this Guide ix Physical keys are indicated with initial capitalization, and keys that you presssimultaneously are connected with a plus sign. Panther Documentation The Panther documentation set includes the following guides and referencematerial (available as indicated), a...
Page 10 - Online Documentation; Using DynaText
Online Documentation About this Guide xi MTS Guide — Instructions for building and deploying COM components in yourProlifics three-tier application. WebLogic Enterprise Guide — Instructions for building and deploying WebLogicEnterprise components in your Prolifics three-tier application. Quick Refer...
Page 12 - Additional Help
Online Documentation About this Guide xiii For more information on using DynaText, refer to the Using DynaText title in theCollection window. The following information is also provided with your Prolifics installation: ` Online README file. Contact Prolifics for more information on the following ser...
Page 14 - Installation Checklist
1 Installation Checklist Use this checklist to ensure that you complete the appropriate steps to install andconfigure your Prolifics development environment for the chosen architecture. Pre-Installation - Determine the application architecture. p. 4 - Based on architecture, decide which components t...
Page 15 - General Information; Contents of the Installation Package
3 General Information In order to help you install the appropriate components, this chapter describes thecontents of the Panther installation package, application architectures, and thefunctionality of the Prolifics software components that make up your Pantherdistribution. Before you begin the inst...
Page 16 - Application Architecture
Application Architecture 4 2-Tier Installation ` Database drivers for connecting to third-party relational databases, such asOracle and Sybase. ` Files for C program development. ` Files for Java program development. ` License management software. ` Online documentation and help system; sample two-t...
Page 17 - For More Information
For More Information Chapter 5 1 General 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 asuggested reading path and more information about the documenta...
Page 18 - Hardware and Software Requirements
7 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 require...
Page 19 - Upgrading
Client: Pre-Installation for Windows 8 2-Tier Installation ` 32 MB of memory. ` Database vendor ’s client and network software installed if you are using adatabase other than JDB. For more information, consult the database-specificrelease notes online. ` To use Java files, you must have either JDK 1...
Page 20 - Client: Installation for Windows; Installation Procedure
Client: Installation for Windows Chapter 9 2 Client: Windows Installation Client: Installation for Windows These instructions apply to both first-time installations and to upgrades fromprevious versions of JAM and Prolifics. Before beginning the installation, reviewthe requirements and other pre-ins...
Page 21 - Installing a Database Driver; Informix
Client: Installation for Windows 10 2-Tier Installation 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 dial...
Page 22 - ODBC
Client: Installation for Windows Chapter 11 2 Client: Windows Installation 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 thetext files provided in INFORMIXDIR\release where INFORMIXDIR is the...
Page 23 - Sybase
Client: Installation for Windows 12 2-Tier Installation Oracle supports two development interfaces: a C language API called OCI and anembedded SQL language, Pro*C. Most applications can use Prolifics’s OCI orPro*C interfaces interchangeably. Typically, Prolifics developers use the OCIinterface unles...
Page 24 - Post-Installation Overview
Client: Post-Installation for Windows Chapter 13 2 Client: Windows Installation Client: Post-Installation for Windows Post-Installation Overview As part of post-installation, you need to perform the following general steps forclient installations, some of which are based on the architecture of your ...
Page 26 - Configure the Client Environment
Client: Post-Installation for Windows Chapter 15 2 Client: Windows Installation 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. Uncom...
Page 27 - Verify the Installation; Look at Sample Applications
Client: Post-Installation for Windows 16 2-Tier Installation ` 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 classessit. Additionally, you can change the defaults for SMJAVAEDITOR and SMJAVAFACTORY and SMJA...
Page 29 - Web Application; Web Application Server: Pre-Installation for Windows
19 Web Application Server: Windows This chapter contains information for installing the Prolifics web applicationserver. 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 Win...
Page 30 - Before Installing
Web Application Server: Pre-Installation for Windows 20 2-Tier Installation If you are installing a Prolifics client and web application server on the sameWindows NT machine, it is recommended that you install them in the samedirectory. This allows them to share common environment settings that poin...
Page 31 - Web Application Server: Post-Installation for Windows; Licensing for Prolifics Web Application Server
Web Application Server: Post-Installation for Windows Chapter 21 3 Web Application Server: Windows Web Application Server: Post-Installation for Windows Refer to page 9 for information on running the setup program to install Prolificssoftware under Windows. You will be prompted during the installati...
Page 33 - Configure the Web Application Server Environment
Web Application Server: Post-Installation for Windows Chapter 23 3 Web Application Server: Windows 3. Create the license.dat : Choose Start ⇒ Run, and type: SMBASE\licenses\create_license All .lic files for the machine are merged into a single license.dat file in the licenses directory and the Start...
Page 35 - Look at Samples
Web Application Server: Post-Installation for Windows Chapter 25 3 Web Application Server: Windows ` Run the application in your browser: http:// serverName / program_directory / applicationName If you get the message “No Service Requested!” you were successful. Look at Samples Before you begin buil...
Page 37 - File Ownership and Protection
Client: Pre-Installation for UNIX 28 2-Tier Installation ` Running Prolifics under character mode has no special requirements. ` The supported version of Motif for AIX 4.3, HPUX 11, and Solaris 7 is Motif2.1; for all other platforms, it is Motif 1.2.x. For information on obtaining your Motif version...
Page 38 - Determine File Location
Client: Pre-Installation for UNIX Chapter 29 4 Client: UNIX Installation Determine File Location After deciding who is going to own the Prolifics files ( root or a dummy login ID), determine where they will be installed (referred to as the Prolifics installationdirectory or SMBASE ). Once this direc...
Page 39 - Client: Installation for UNIX
Client: Installation for UNIX 30 2-Tier Installation Client: Installation for UNIX These instructions apply to both first-time installations and to upgrades fromprevious versions of JAM and Prolifics. Before beginning the installation, reviewthe requirements and other pre-installation steps discusse...
Page 40 - Configuring the Installation
Client: Installation for UNIX Chapter 31 4 Client: UNIX Installation 4. Mount the CD-ROM device as /cdrom . 5. In /usr/prolifics , to uncompress and extract the contents of the Panther distribution, type: zcat < /cdrom/ CompressedTarFilename | tar –xvf – On HPUX, type: zcat < /cdrom/” Compress...
Page 42 - Licensing for Prolifics
Client: Post-Installation for UNIX Chapter 33 4 Client: UNIX Installation Client: Post-Installation for UNIX After successfully installing Prolifics software, there are several post-installationsteps required to start using Prolifics. This chapter discusses licensing, buildingProlifics executables, ...
Page 45 - Create New Prolifics Executables
Client: Post-Installation for UNIX 36 2-Tier Installation Create New Prolifics Executables As part of the Prolifics installation package, a set of standard Prolifics executablesis provided. Depending on your configuration and on the platform and databasebeing used, you might need to create new execu...
Page 49 - Look at A Sample Application
Client: Post-Installation for UNIX 40 2-Tier Installation This assumes that you are using setup script files in your application directory.If you are using setup script files in the installation directory, replace applicationDir with the full pathname to the Prolifics config directory, for example, ...
Page 50 - Post-Installation Notes; Troubleshooting
Client: Post-Installation for UNIX Chapter 41 4 Client: UNIX Installation Post-Installation Notes The following additional information might be required to configure and runProlifics software on your system. Several character-mode specific utilities, mbedit.cm (menu bar editor) and showkey.cm (key t...
Page 52 - Web Application Server: Pre-Installation for UNIX
43 Web Application Server: UNIX This chapter contains information for installing the Prolifics web applicationserver. For information about installing Prolifics client software, refer to page 27. Web Application Server: Pre-Installation for UNIX To run a Prolifics web application server, an HTTP ser...
Page 53 - Web Application Server: Post-Installation for UNIX
Web Application Server: Post-Installation for UNIX 44 2-Tier Installation If you plan to install a Prolifics web application server on UNIX, you must create auser account called proweb . To prepare your UNIX system for installing a web application server: 1. Add a user called proweb (this name assig...
Page 55 - Creating Your Web Application
Web Application Server: Post-Installation for UNIX 46 2-Tier Installation • Server — Full pathname of the jserver program in the util subdirectory of the installation directory. • SMBASE — Full pathname of the Prolifics installation directory. • PATH — Full pathname to the util subdirectory of the i...
Page 57 - DLLs for JPEG Decoding
49 Notes for Microsoft Windows The information in this appendix provides troubleshooting notes for installing andrunning Prolifics on Microsoft Windows. DLLs for JPEG Decoding WECJLIB.DLL is a dynamic link library which performs JPEG decoding. There are two versions of the DLL. The version that come...
Page 58 - Environment Space; Using Prolifics Utilities
Environment Space 50 2-Tier Installation Environment Space If COMMAND.COM runs out of environment space when you issue a SET command, add the following line to your CONFIG.SYS file: SHELL=C:\COMMAND.COM /E:1000 /P If COMMAND.COM resides on a different drive or directory, modify the line accordingly....
Page 65 - Licensing in Prolifics; License Daemons and License Types
Licensing in Prolifics 58 2-Tier Installation ` lmstat — Monitors the status of all licensing activity. ` lmswitchr — Switches the log file for the specified feature. ` lmver — Reports the FLEXlm version of a library or binary. Licensing in Prolifics Prolifics components use local or remote licensin...
Page 66 - Options File; License Types
Options File License Administration Appendix 59 C file. However, there might be other license daemons managing other licensefiles. lmgrd runs on the license host. ` Vendor daemon ( prold ) — Works with lmgrd to dispense tokens. Each feature of a floating (development client) license has a limited nu...
Page 68 - FLEXlm Utilities; Example
FLEXlm Utilities License Administration Appendix 61 C but is not meant to be human readable. If the filename starts with a plus character(+), the file will be opened in append mode. The REPORTLOG line has the following format: REPORTLOG filename RESERVE RESERVE reserves the specified number of licen...
Page 69 - lmcksum; Performs a checksum of a license file
FLEXlm Utilities 62 2-Tier Installation lmcksum Performs a checksum of a license file lmcksum [–k] [–c license_file ] Force the encryption code checksum to be case-sensitive (in general, lmcksum is not case-sensitive) and not prompt for any input. Name of license file to checksum. By default lmcksum...
Page 70 - lmdiag; Diagnoses licensing problems
FLEXlm Utilities License Administration Appendix 63 C lmdiag Diagnoses licensing problems lmdiag [–c license_file ] [–n] [ feature ] Name of license file to diagnose. If this switch is not specified, lmdiag looks for the environment variable LM_LICENSE_FILE . If the environment variable is not set, ...
Page 71 - lmdown; Takes down license daemons; Description
FLEXlm Utilities 64 2-Tier Installation lmdown Takes down license daemons lmdown [–c license_file ] [–q] Use the specified license_file . If this switch is not specified, lmdown looks for the environment variable LM_LICENSE_FILE . If the environment variable is not set, lmdown looks for the file /us...
Page 72 - Starts up the license manager daemon
FLEXlm Utilities License Administration Appendix 65 C lmgrd Starts up the license manager daemon lmgrd [–2] [–b] [–c license_file ] [–d] [–l logfile ] [–p] [–s interval ] [–t timeout ] Specify V2 startup arguments, in contrast to the –b switch. This switch is required if you intend to use the –p swi...
Page 73 - lmhostid
FLEXlm Utilities 66 2-Tier Installation lmhostid Prints the correct hostid value on any machine supported by FLEXlm lmhostid [ type ] The type of the hostid to print. type must be one of long , idmodule , ether , or string , and is currently used only on HP and SCO systems. On HP, type specifies the...
Page 74 - lmremove; Removes a user license and returns it to the license pool
FLEXlm Utilities License Administration Appendix 67 C lmremove Removes a user license and returns it to the license pool lmremove [–c license_file ] [ feature ] [ user ] [ host ] [ display ] Use the specified license file. If this switch is not specified, lmremove looks for the environment variable ...
Page 75 - lmreread; Tells the license daemon to reread the license file
FLEXlm Utilities 68 2-Tier Installation lmreread Tells the license daemon to reread the license file lmreread [–c license_file ] Use the specified license file. If this switch is not specified, lmreread looks for the environment variable LM_LICENSE_FILE . If the environment variable is not set, it l...
Page 76 - Reports status on license manager daemons and feature usage
FLEXlm Utilities License Administration Appendix 69 C lmstat Reports status on license manager daemons and feature usage lmstat [–a] [–A] [–c license_file ] [–f [feature] ] [–l [reg_expression] ] [–s [server] ] [–S [daemon] ] [–t timeout ] Display everything. List all active licenses. Use the specif...
Page 77 - lmswitchr
FLEXlm Utilities 70 2-Tier Installation lmswitchr Switches the FLEXadmin log file (REPORTLOG) for the specified feature lmswitchr [ feature ] [ new-file ] Any feature this daemon supports. New file pathname. The FLEXlm daemons create an ASCII log file on stdout . There are several pro- cesses in a p...
Page 78 - lmver; Reports the FLEXlm version of a library or binary
FLEXlm Utilities License Administration Appendix 71 C lmver Reports the FLEXlm version of a library or binary lmver [ filename ] Use the specified license file. If a filename is not specified, lmver looks for the environment variable LM_LICENSE_FILE . If the environment variable is not set, lmver lo...
Page 79 - License File; Contents of the License File
73 License File This appendix describes the basic format and content of the password-enabledlicense file. If you already have a license file in place, either from a previous version of JAM orProlifics, or from another application that uses FLEXlm, you can combine licensefiles by inserting the licens...
Page 82 - Error Messages; Prolifics Installation Error Messages
77 Error Messages Prolifics Installation Error Messages A Prolifics installation was not successful if you receive an error message and theprogram terminates. The following messages describe some of the more commonerror messages and how to resolve them. Recurring errors: Occasionally, errors describ...
Page 84 - DLL Messages; Informix-Specific Messages
DLL Messages Error Messages Appendix 79 E UNIX: Make sure that the variable is exported (via the export sh/ksh command or setenv csh command). SMVARS: No such file or directory Cause: SMVARS is not set correctly. Action: Check that the full pathname (including drive letter under Windows) of the file...
Page 85 - ODBC-Specific Messages
DLL Messages 80 2-Tier Installation ODBC-Specific Messages Cannot load DLL odb2dm32.dll Cannot load DLL odb3dm32.dll Cannot load DLL tmodb132.dll Cause: Windows is unable to find the Prolifics database driver DLLs or the ODBC software. Action: Check that the Prolifics util directory is on the PATH ....
Page 86 - Sybase-Specific Messages; Graph-Related Messages
Graph-Related Messages Error Messages Appendix 81 E Sybase-Specific Messages Cannot load DLL db10dm32.dll Cannot load DLL ct10dm32.dll Cannot load DLL db11dm32.dll Cannot load DLL ct11dm32.dll Cannot load DLL tmsyb132.dll Cause: Windows is unable to find the Prolifics database driver DLLs or the Syb...
Page 87 - Prolifics License-Related Messages
License Manager Error Messages 82 2-Tier Installation Prolifics License-Related Messages The messages described in this section can appear when the screen editor isinvoked. Prolifics License Manager: Bad date in license file. Cause: The date on one of the FEATURE or INCREMENT lines is not correct. A...
Page 91 - FLEXlm Informational Messages
License Manager Error Messages 86 2-Tier Installation FLEXlm Informational Messages The following messages are generated by FLEXlm license management software,and are provided courtesy of the FLEXlm Programmer ’s Guide. Connected to node Cause: This daemon is connected to its peer on node . CONNECTE...
Page 93 - FLEXlm Configuration Problem Messages
License Manager Error Messages 88 2-Tier Installation SIGCHLD received. Killing child servers. Cause: Vendor daemon logs this message when a shutdown is requested by the license daemon. Started name Cause: License daemon logs this message whenever it starts a new vendor daemon. Trying connection to ...
Page 94 - Daemon Software Error Messages
License Manager Error Messages Error Messages Appendix 89 E NO DAEMON line for name Cause: Vendor daemon logs this error if it cannot find its own DAEMON name in the license file. Action: Edit license file. NO DAEMON lines, exiting Cause: License daemon logs this message if there are no DAEMON lines...
Page 97 - Index
93 Index A Application, samples, 16, 40 Windows, 25 autoexec.bat, 8 C C compiler, 28 Character–mode, 28 Client configuring environment of UNIX, 38Windows, 15 executables, 14, 37license–related messages, 84licensing, 59supported platforms, 4 CONFIG.SYS, 50 Create license, error messages, 85 create_li...