home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 May / PCWorld_1999-05_cd.bin / software / Vyzkuste / inprise / INTRCLNT_15 / DATA.Z / Readme.txt < prev    next >
Text File  |  1998-09-21  |  5KB  |  125 lines
  1. Readme (Readme.txt)
  2. InterClient 1.50
  3. Last modified September 21, 1998
  4.  
  5. Contents:
  6.     I.   Where's the Documentation?
  7.     II.  What is InterClient?
  8.     III. How Does InterClient Differ from DataGateway and Other Drivers?
  9.     IV.  Compatibilities
  10.     V.   How to Obtain InterClient Updates
  11.     VI.  Configuration
  12.     VII. Testing Your Configuration
  13.  
  14. __________________________________________________________________
  15. Where's the Documentation?
  16.  
  17. The complete HTML documentation can be accessed from the file 
  18. index.html in your InterClient docs directory.  On Windows, the 
  19. InterClient program group contains an icon for the InterClient
  20. documentation. 
  21.  
  22. __________________________________________________________________
  23. What is InterClient?
  24.  
  25. InterClient is an all-Java JDBC driver for InterBase.
  26.  
  27. InterClient is a networked driver, meaning that it incorporates a 
  28. JDBC remote protocol for exchanging and caching data between 
  29. client and server.  This allows for a browser enabled client with 
  30. no preinstalled client libraries (such as ODBC) to access 
  31. InterBase data across the net.  This differs from a JDBC bridge 
  32. which maps from the JDBC API to some native RDBMS client API or
  33. ODBC.  A JDBC bridge implementation relies on the RDBMS client
  34. library for the actual exchange and caching of data between
  35. server and client.
  36.  
  37. The advantage of a networked driver over a bridge implementation
  38. is that the client is 100% pure Java, thereby providing for 
  39. cross-platform, robust, and secure applets.  Whereas a bridge 
  40. implementation requires some binary code to be pre-loaded on each 
  41. client machine, contrary to the notion of an applet.
  42.  
  43. The JDBC remote protocol employed by InterClient is streamlined 
  44. for JDBC data access, and is database independent except in cases 
  45. where InterBase access can be optimized or proprietary InterBase 
  46. features may be leveraged.
  47.  
  48. __________________________________________________________________
  49. How Does InterClient Differ from DataGateway and Other Drivers
  50.  
  51. The DataGateway Broker was derived from InterClient.  But
  52. DataGateway's server speaks BDE on the backend or middle tier.
  53. InterServer speaks ISC on the server backend or middle tier.
  54. Also, since InterClient/InterServer is middleware intended only
  55. for InterBase, it can be, and is, streamlined for InterBase.
  56. Being an all Java type 3 driver provides much more flexibility than
  57. a type 4 jdbc driver (which is pinned to a legacy protocol).
  58. These things give rise to a driver which we believe to be the fastest
  59. driver on the market today, often being orders of magnitude faster
  60. than drivers such as jConnect and dbANYWHERE.
  61.  
  62. __________________________________________________________________
  63. Compatibilities
  64.  
  65. Neither InterBase nor InterServer need to be installed on 
  66. the client machine, nor even InterClient if running applets.
  67.  
  68. InterClient 1.50 is compatible with the
  69.    Java Runtime Environment (JRE) 1.1
  70.    InterServer 1.50 and InterBase 5.x
  71.  
  72. InterServer 1.50 has been tested with
  73.    Windows 95/98 and NT 4.0
  74.    Solaris 2.5.x
  75.    HP-UX 10.x
  76.  
  77. __________________________________________________________________
  78. How to Obtain InterClient Updates
  79.  
  80. Periodic revisions are made available on the InterBase web site
  81. at http://www.interbase.com.
  82.  
  83. __________________________________________________________________
  84. Configuration 
  85.  
  86.   On both Windows and Unix, the following 
  87.   entry must appear in the services file.
  88.  
  89.             interserver 3060/tcp
  90.  
  91.   The TCP/IP services file was modified as a part of the 
  92.   installation.  You can add the above line manually if you
  93.   decided not to have setup make the modifications for you.
  94.  
  95.   The services file can be located as follows:
  96.    *  Windows NT         <WINDOWS_DIR>\system32\drivers\etc\services
  97.    *  Windows 95/98      <WINDOWS_DIR>\services
  98.    *  Unix               /etc/services or an NIS services map
  99.         
  100.   For Unix only, an entry in the /etc/inetd.conf file is also required:
  101.  
  102.     interserver stream tcp nowait root /usr/interclient/bin/interserver interserver
  103.  
  104.   The CLASSPATH environment variable should be updated to include
  105.           <INSTALL_DIR>\interclient.jar
  106.  
  107.   These configurations should be performed automatically by the
  108.   Windows install program.  The class path configuration for 
  109.   Unix must be performed manually.
  110.  
  111. __________________________________________________________________
  112. Testing Your Configuration
  113.  
  114.   See the Troubleshooting section of the InterClient Help html for 
  115.   detailed instructions on testing your machine configuration for
  116.   running InterClient applications using 
  117.  
  118.     java interbase.interclient.utils.CommDiag
  119.  
  120.   and for instructions on testing your applet configuration using
  121.  
  122.     CommDiag.html
  123.  
  124. __________________________________________________________________
  125.