Prolifics Panter 2Tier, Installation Manual

Page 1: ...2 Tier Installation April 1999...

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

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

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

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

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

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

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

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

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

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

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

Page 13: ......

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Page 55: ...Setup Manager is accessed from the following URL ______________________________________________________ Creating Your Web Application The Prolifics Web Setup Manager guides you through configuring yo...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Page 100: ......