home *** CD-ROM | disk | FTP | other *** search
/ Delphi 5 for Professionals / DELPHI5.iso / IB5 / IntrClnt / Install.txt < prev    next >
Encoding:
Text File  |  1998-09-21  |  5.4 KB  |  150 lines
  1. Installation Notes (Install.txt)
  2. InterClient 1.50
  3. Last modified September 21, 1998
  4.  
  5. Contents:
  6.     I.   Important Note for JBuilder Users
  7.     II.  Installation Note for Windows NT and 95/98
  8.     III. Uninstalling on Windows NT and 95/98
  9.     IV.  Installation Options
  10.     V.   Distributed Jar Files
  11.     VI.  Testing your Local Installation
  12.     VII. Software Expiration
  13.     VIII.Installation Note for Solaris and HP-UX
  14.  
  15. __________________________________________________________________
  16. Important Note for JBuilder Users
  17.   
  18.   Please exit JBuilder before continuing with the InterClient install.
  19.   JBuilder must *not* be running in order for the InterClient
  20.   Install to properly modify JBuilder INI settings. 
  21.   For information on configuring INI settings manually, see the
  22.   file JBuilderNotes.txt after installation.
  23.  
  24. __________________________________________________________________
  25. Installation Note for Windows NT and 95/98
  26.  
  27.   If you have a previous release of InterClient installed on
  28.   this machine, you MUST uninstall it before continuing.
  29.  
  30. __________________________________________________________________
  31. Uninstalling on Windows NT and 95/98
  32.  
  33.   Before uninstalling, you should first stop the InterServer 
  34.   service or application if it is running, and then remove the 
  35.   service using the InterServer Configuration Utility.
  36.  
  37.   When uninstalling on NT, use the add/remove program icon in
  38.   the NT control panel.  On Windows 95, there is an uninstall 
  39.   icon in the InterClient program group if InterServer was 
  40.   previously installed.
  41.  
  42. __________________________________________________________________
  43. Installation Options
  44.  
  45.   During installation you will be prompted to choose components
  46.   to install.  By default all of the following components are
  47.   installed:
  48.  
  49.     InterClient
  50.       The pure Java JDBC client library which communicates with
  51.       a server-side InterServer.
  52.     InterServer
  53.       A remote access server for InterBase.  This is a middleware 
  54.       service which acts as a proxy between InterClient and InterBase.
  55.       The service is tailored for InterBase remote access via JDBC.
  56.     Documentation
  57.       HTML documentation for the all-Java InterClient JDBC driver.
  58.  
  59. __________________________________________________________________
  60. Distributed Jar Files
  61.  
  62.   interclient-core.jar
  63.      The JDBC driver with only the default English text resources.
  64.      No utilities included in the core jar.
  65.   interclient-res.jar
  66.      Locale-specific resource bundles.
  67.   interclient-utils.jar
  68.      Currently consists of the communications diagnostics utility.
  69.   interclient.jar
  70.      JDBC driver, all resources, and utilities.  
  71.  
  72.   The Windows install automatically appends interclient.jar
  73.   to your user's classpath.  You must modify your classpath 
  74.   manually on Unix.
  75.  
  76. __________________________________________________________________
  77. Testing your Local Installation
  78.  
  79.   See the Troubleshooting section of the InterClient Help html for 
  80.   detailed instructions on testing your machine configuration for
  81.   running InterClient applications using 
  82.  
  83.     java interbase.interclient.utils.CommDiag
  84.  
  85.   and for instructions on testing your applet configuration using
  86.  
  87.     CommDiag.html
  88.  
  89. __________________________________________________________________
  90. Software Expiration
  91.  
  92.   This release of InterClient will expire, but continue to 
  93.   function, on December 30, 2000. 
  94.  
  95.   Expired product releases of InterClient accept connections,
  96.   but the connection is tagged with an ExpiredDriverWarning.
  97.   Expired beta releases of InterClient may throw an 
  98.   ExpiredDriverException and refuse connections.
  99.  
  100.   Upon expiration, it is suggested that you upgrade both InterClient
  101.   and InterServer driver components by downloading a recent release 
  102.   from http://www.interbase.com.
  103.  
  104. __________________________________________________________________
  105. Installation Note for Solaris and HP-UX
  106.  
  107.   After the download files have been extracted using the tar
  108.   command (tar -xvf InterClient.tar), a directory is created
  109.   named interclient_install_temp_dir containing the following files:
  110.  
  111.     install.sh      : the installation program
  112.     interclient.tar : components to be extracted by install.sh
  113.  
  114.   The installation process creates a log file of the installation 
  115.   session.  It is important to retain the log file in the
  116.   installation directory.  
  117.    - It contains the configuration information specific to your 
  118.      site necessary to complete the installation.
  119.    - It contains a log of your installation choices. It will be 
  120.      required should you require technical support. 
  121.  
  122.   The following entry must occur in the /etc/services file or 
  123.   the NIS services map:
  124.  
  125.     interserver 3060/tcp
  126.  
  127.   An entry in the /etc/inetd.conf file is also required:
  128.  
  129.     interserver stream tcp nowait root /usr/interclient/bin/interserver interserver
  130.  
  131.   After adding these entries, either reboot the system or restart the
  132.   inet daemon.  To restart the inet daemon, use the ps command to
  133.   discover the process id of the inetd process:
  134.  
  135.      ps -e | grep inetd
  136.   or 
  137.      ps -ax | grep inetd
  138.  
  139.   The number in the output column 'PID' is the process id of the inet 
  140.   daemon.  Use the process id with the following command to restart the 
  141.   inet daemon:
  142.  
  143.     kill -HUP <PID>
  144.  
  145.   After installing, be sure to add /usr/interclient/interclient.jar 
  146.   to your CLASSPATH.
  147.  
  148. __________________________________________________________________
  149.  
  150.