background image

iv

2-Tier Installation

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

. . . . . . . . . . . . . . . . . 

Содержание Panter 2Tier

Страница 1: ...2 Tier Installation April 1999...

Страница 2: ...tabase 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...

Страница 3: ...line 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 Informat...

Страница 4: ...ation 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...

Страница 5: ...tration 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 Pr...

Страница 6: ...dows operating systems Organization of this Guide This guide includes the following information Pre installation information An overview of application architectures the Prolifics components which mak...

Страница 7: ...ames 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...

Страница 8: ...ng 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 applicat...

Страница 9: ...ades New Features Guide for Prolifics upgrades Quick Reference Database Drivers Configuration Using the Editors Web Developer s Guide Properties Reference online only Master Index Glossary Additional...

Страница 10: ...n 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 windo...

Страница 11: ...ulltext 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...

Страница 12: ...g DynaText title in the Collection window The following information is also provided with your Prolifics installation Online README file Contact Prolifics for more information on the following service...

Страница 13: ......

Страница 14: ...Submit request for permanent license in the mean time you can start using Prolifics since it is installed with a Start up License Windows Web p 21 UNIX p 33 Create new Prolifics executables if necess...

Страница 15: ...on 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 appropriat...

Страница 16: ...n 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 a...

Страница 17: ...rious platforms and to your preferences Informa tion on GUI resource and initialization files Developer s Guide Introduction and process of how to build database applications online Using the Editors...

Страница 18: ...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 Howeve...

Страница 19: ...nstall 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 ear...

Страница 20: ...se 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 certa...

Страница 21: ...led the database driver and want to modify the database version in PROL4W32 INI 6 Select or confirm the version of your database software If your version is not listed choose the option Other If you a...

Страница 22: ...y 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 Windows 95 98 Oracle Version 7 to 7 2 using OCI Oracle Version 7...

Страница 23: ...st use the OCI interface Windows 95 98 and NT Sybase Version 10 using DB Library Sybase Version 10 using CT Library Sybase Version 11 using DB Library Sybase Version 11 using CT Library Or latest vers...

Страница 24: ...ight 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 pa...

Страница 25: ...n 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...

Страница 26: ...abase engine refer to the online database specific driver notes In the databaseName PARAMETERS section of makevars verify your database engine s version Uncomment the appropriate block of parameters b...

Страница 27: ...nt 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...

Страница 28: ...s 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 containi...

Страница 29: ...n 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 sele...

Страница 30: ...stalling 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...

Страница 31: ...the web server environment refer to page 23 4 Verify the web application server installation refer to page 24 5 Look at samples refer to page 25 Licensing for Prolifics Web Application Server The Pro...

Страница 32: ...t for each machine Follow the directions for the method of receipt Note In the following procedures replace references to SMBASE with the full pathname of the Prolifics installation directory To insta...

Страница 33: ...tion c flexlm license dat Configure the Web Application Server Environment To ensure that your Prolifics application can be viewed on a web browser complete the following platform specific steps most...

Страница 34: ...it starts up properly on web application server machines If Prolifics software is not installed and configured correctly an appropriate error message is displayed Depending on the problem the program...

Страница 35: ...cations you might want to look at the following sample applications QuickStart QuickStart provides step by step instructions on building and deploying sample applications on the web Choose QuickStart...

Страница 36: ...Hardware and software requirements File ownership and protection Location of files For web application development refer to page 43 for information about installing a Prolifics web application server...

Страница 37: ...e they are installed the files distributed with Prolifics software should not be modified except under special circumstances for example to create a new executable To prevent inadvertent changes to th...

Страница 38: ...set up do not change it since users are likely to embed the directory name in makefiles shell scripts and so forth The default installation directory is usr prolifics If your system layout does not pe...

Страница 39: ...ate database drivers from the supplied media 2 Run the setup program to configure the installation 3 Install the Start up License The installation process might require several additional steps depend...

Страница 40: ...Configuring the Installation After you copy the distribution from the tape run the setup program to configure your installation To configure the installation 1 If you are installing the web applicatio...

Страница 41: ...bdirectory of your Prolifics installation Alternatively enter the contents of license dat from the paper copy provided The following additional procedures might be required to configure Prolifics on a...

Страница 42: ...lifics The Prolifics installation includes a Start up License that lets you use Prolifics and run Prolifics applications immediately The temporary license license dat is located in the licenses subdir...

Страница 43: ...file 1 If you received license files via e mail copy them to the licenses directory prodev lic client development license and proweb lic web application server if applicable Proceed to Step 4 2 If yo...

Страница 44: ...n 5 0 or higher of the license manager daemon lmgrd Note The web application server does not require the license daemon To determine the version of lmgrd At the command line type ProlificsInstallDir u...

Страница 45: ...ild the appropriate executables For further informa tion refer to page 37 5 Uncomment the appropriate database in the makefile and edit the database specific makevars dbs where dbs is the extension of...

Страница 46: ...on 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 DEBUGG...

Страница 47: ...he file or set the EBTRC variable to point to it refer to Step 4 Prolifics X resource file used by the Prolifics client Copy to each user s app defaults directory if there is one or to the user s home...

Страница 48: ...SMBASE licenses license dat LD_LIBRARY_PATH Identifies directories to search when looking for shared libraries On HPUX use SHLIB_PATH in place of LD_LI BRARY_PATH On AIX use LIBPATH LD_LIBRARY_PATHsho...

Страница 49: ...the value of SMTERM as needed Overriding other application variables for a given user can be implemented in the same way Verify the Installation After you install and configure the Prolifics client y...

Страница 50: ...ey showkey xm 2 Copy the character mode utilities to the utility name having no extension For example cp mbedit cm mbedit cp showkey cm showkey Troubleshooting The information in this section is inten...

Страница 51: ...ave problems accessing the documents Ensure that the Prolifics util directory is included in the PATH variable Ensure that the ebtrc can be accessed Do this by either placing a copy of it in your home...

Страница 52: ...f the industry favorites such as Netscape s Enterprise Server and Apache Server Prolifics supports CGI ISAPI and NSAPI architectures You can select one according to your preferred configuration If you...

Страница 53: ...the web home directory home proweb You may need to assign the same permissions to all of the parent directories as well 4 In your web home directory create an ini subdirectory Make sure that it has r...

Страница 54: ...pplication server executables reside in your HTTP server s CGI directory otherwise copy them from SMBASE util websetup web setup manager jwsamp sample application executable 2 Confirm that the followi...

Страница 55: ...Setup Manager is accessed from the following URL ______________________________________________________ Creating Your Web Application The Prolifics Web Setup Manager guides you through configuring yo...

Страница 56: ...sted you were successful Look at Samples Before you begin building your applications you might want to look at the following sample applications QuickStart QuickStart provides step by step instruction...

Страница 57: ...ression Labs ECL In the version of the DLL provided with Prolifics images are rendered using ordered dithering The enhanced version of the DLL supports Hi Color and Tru Color display hardware With suc...

Страница 58: ...er or the Start menu The problem arises because Windows s notion of the current directory is hidden from the user By default all Prolifics s utilities are designed to be run from the DOS command line...

Страница 59: ...A Run the utilities from DOS Note The utilities listed are distributed as Microsoft C QuickWin applications If you are interested in the behavior of QuickWin applications refer to the QuickWin chapte...

Страница 60: ...ization file For Windows 95 98 and Windows NT Database and Version Settings Microsoft Open Database Connectivity ODBC Version 2 databases installed odbc dbms odbc driver odb2dm32 dll model tmodb132 dl...

Страница 61: ...base Version 11 using CT Library databases installed sybase dbms sybase driver ct11dm32 dll model tmsyb132 dll For Windows 95 98 Database and Version Settings Informix Version 7 20 TDI databases insta...

Страница 62: ...cle dbms oracle driver emb8dm32 dll model tmora132 dll For Windows NT Database and version Settings Informix Version 7 10 databases installed informix dbms informix driver inf7dmnt dll model tminf132...

Страница 63: ...nd version Settings Oracle Version 8 using OCI databases installed oracle dbms oracle driver ora8dmnt dll model tmoral132 dll Oracle Version 8 using Pro C databases installed oracle dbms oracle driver...

Страница 64: ...ense options file and the following FLEXlm license administration utilities provided with Prolifics lmcksum Performs a checksum of a license file lmdiag Diagnoses licensing problems lmdown Gracefully...

Страница 65: ...ose a different scheme if your license administrator recommends it In this case the setup program requests contact information and the Prolifics License Desk will contact you or your license administr...

Страница 66: ...floating license is associated with the Prolifics development executable and not with an actual machine it is possible for a developer to use more than one license For example if a developer is runnin...

Страница 67: ...format INCLUDE EXCLUDE feature USER HOST DISPLAY GROUP name NOLOG NOLOG causes messages of the specified type to be filtered out of the daemon s log file Specifying a NOLOG option reduces the amount...

Страница 68: ...c feature USER HOST DISPLAY GROUP name TIMEOUT TIMEOUT sets up a minimum idle time after which a user s license is lost if it is not being used This can prevent users from wasting a license by keeping...

Страница 69: ...at lmcksum prints a line by line checksum for the file as well as an overall file checksum If the license file contains lmcksum nn attributes the bad lines are indicated lmcksum ignores all fields tha...

Страница 70: ...ath lmdiag first prints information about the license then attempts to check out each license If the checkout succeeds lmdiag indicates this If the checkout fails lmdiag gives you the reason for the f...

Страница 71: ...license daemons to shut down lmdown sends a message to every license daemon asking it to shut down The li cense daemons write out their last messages to the log file close the file and exit All licens...

Страница 72: ...to them before sending to a client Useful when clients are accessing licenses from another domain Available in lmgrd v2 4 and later Specify the output log file to use Specify that the lmdown and lmre...

Страница 73: ...SCO systems On HP type specifies the ID module the machine id as returned from the uname command or the Ethernet address The HP default is long uname On SCO long specifies the pre 3 0 default which w...

Страница 74: ...to remove a single user s license for a specified feature This might be required in the case where the licensed user is run ning the software on a node that subsequently crashed This situation can som...

Страница 75: ...ile from the command line or the default file if none specified only to find the license daemon to send it the command to reread the license file The license daemon always rereads the original file th...

Страница 76: ...Display the status of the specified server nodes List all users of the specified daemon s features Specify the timeout interval in seconds during which daemons must complete their connections to each...

Страница 77: ...ile pointer so this log file cannot be changed after the vendor daemons have been started since each process has a copy of the current offset etc There is another way to switch the log file output dat...

Страница 78: ...ame is not specified lmver looks for the environment variable LM_LICENSE_FILE If the environment variable is not set lmver looks for the file usr local flexlm licenses license dat If the filename is s...

Страница 79: ...me path FEATURE product daemon name version exp_date number password ISSUED date SN serial number HOSTID hostid ck checksum INCREMENT product daemon name version exp_date number password ISSUED date S...

Страница 80: ...format FEATURE product daemon name version exp_date number password ISSUED date SN serial number HOSTID hostid ck checksum product Name of the product with which the license is associated in this cas...

Страница 81: ...application server or Jserver prolifics web mgr dispatcher or prolifics client UNIX clients daemon name Name of the daemon always prold version Highest version number of product 4 for Prolifics exp_d...

Страница 82: ...n which is the required format used by Prolifics If the ASCII version of smvars has been edited be sure to run var2bin to convert it to binary format Otherwise Prolifics is not aware of the changes an...

Страница 83: ...bles can be set in the environment rather than depending on values set in an SMVARS defined file If Prolifics can t find a required variable specification in either the environment or in the SMVARS fi...

Страница 84: ...load DLL INF7DMNT DLL Cannot load DLL INF7DMN4 DLL Cannot load DLL TMINF132 DLL Cause Windows is unable to find the Prolifics database driver DLLs or the Informix software Action Check that the Proli...

Страница 85: ...dll Cannot load DLL or73dm32 dll Cannot load DLL em73dm32 dll Cannot load DLL ora8dm32 dll Cannot load DLL emb8dm32 dll Cannot load DLL ora7dmnt dll Cannot load DLL emb7dmnt dll Cannot load DLL oxa7dm...

Страница 86: ...current Prolifics util directory with the correct cktbl16 dll is in the PATH or copy cktbl16 dll to the Windows directory Graph Related Messages If graph widgets are not displaying correctly the follo...

Страница 87: ...cense file or contact your system administrator The two codes can help locate the problem Prolifics License Manager Cannot connect daemon prold with license server Cause There is no DAEMON line in the...

Страница 88: ...r system administrator Prolifics License Manager malloc call failed Cause License manager could not allocate memory that it needed The most likely cause is that the program s heap has been corrupted A...

Страница 89: ...inue editing and can save any screens that are currently open in the editor but must restart Prolifics prodev before you can pick any New and Open menu options Prolifics License Manager FLEXlm key dat...

Страница 90: ...ilenames of the license files in SMBASE licenses Your license files should have one of the following names proserv lic Prolifics application server prodev lic development client proweb lic web applica...

Страница 91: ...feature has passed its expiration date IN feature by user N licenses used d hh mm ss Cause user at d hh mm ss IN server died feature by user N licenses used d hh mm ss Cause user has checked in N lic...

Страница 92: ...ST name RESERVE feature for USER name Cause A license of feature is reserved for either user name or host name Action None Restarted xxx internet port nnn Cause Vendor daemon xxx was restarted at inte...

Страница 93: ...ure name Cause Specified feature name has a bad encryption code Action Check the password received from Prolifics CANNOT OPEN options file file Cause Options file specified in the license file could n...

Страница 94: ...se of an attempt to run more than one copy of the daemon on a single node Action Locate the other daemon that is running via a ps command and kill it with kill 9 Unknown host hostname Cause hostname s...

Страница 95: ...ould not send its PID to the top level server in the hierarchy Action Report error to Prolifics technical support f do notify called with no valid feature Cause Internal inconsistency error Action Rep...

Страница 96: ...returning a reservation to the free reservation list it could not find the listhead of features select message Cause An error in a select system call was detected Action Report error to Prolifics tech...

Страница 97: ...CONFIG SYS 50 Create license error messages 85 create_license utility 23 34 D Database driver Informix 10 installing on UNIX 30 installing on Windows 10 Microsoft SQL Server 11 ODBC 11 Oracle 11 Sybas...

Страница 98: ...nostics 63 file contents 73 read file 68 remove user 67 REPORTLOG 60 schemes 58 status 69 types 59 version of file 71 License administration 57 utilities 61 License file location of 23 35 requesting 2...

Страница 99: ...15 39 SMTERM 39 40 Start up License backup 23 34 Sybase error messages 81 versions supported 12 T Two tier application 4 U UNIX requirements client 27 verifying installation of client 40 Upgrade on U...

Страница 100: ......

Отзывы: