home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / TRIAL / INTRCLNT / _SETUP.LIB / Readme.txt < prev    next >
Encoding:
Text File  |  1997-11-14  |  5.8 KB  |  143 lines
  1. InterClient 1.12
  2. Last modified : Nov 6, 1997
  3.  
  4. Contents:
  5.      I.  What is InterClient?
  6.     II.  How Does InterClient Differ from DataGateway?
  7.    III.  Compatibilities
  8.     IV.  Configuration
  9.      V.  Testing an Applet Configuration
  10.  
  11. __________________________________________________________________
  12. What is InterClient?
  13.  
  14. InterClient is an all Java JDBC driver for InterBase,
  15. and is now available for free download from
  16. http://www.interbase.com
  17.  
  18. InterClient is a networked driver, meaning that
  19. it incorporates a JDBC remote protocol for exchanging and 
  20. caching data between client and server.  
  21. This allows for a browser enabled client with NO
  22. preinstalled client libraries (such as ODBC) 
  23. to access InterBase data across the net.
  24. This differs from a JDBC bridge which maps from the JDBC API
  25. to some native RDBMS vendor API or ODBC.  
  26. A JDBC bridge implementation relies on the RDBMS vendor's 
  27. native API for the actual exchange and caching of data 
  28. between server and client.
  29.  
  30. The advantage of a networked driver over a bridge implementation
  31. is that the client is 100% pure Java, thereby providing for 
  32. cross-platform, robust, and secure applets.
  33. Whereas a bridge implementation requires some binary code to be
  34. pre-loaded on each client machine, contrary to the notion of an applet.
  35.  
  36. The JDBC remote protocol employed by InterClient is
  37. streamlined for JDBC data access, and is database independent
  38. except in cases where InterBase access can be optimized or
  39. proprietary InterBase features may be leveraged.
  40.  
  41. __________________________________________________________________
  42. How Does InterClient Differ from DataGateway?
  43.  
  44. The Borland DataGateway product was derived from InterClient,
  45. building on its database independence.  The difference between
  46. InterClient and DataGateway is the backend database API
  47. to which the server component communicates. In the case of 
  48. InterClient, the backend API is the InterBase native API.
  49. In the case of DataGateway, the backend API is the BDE (Borland
  50. Database Engine).  InterClient is optimized for InterBase access.
  51.  
  52. __________________________________________________________________
  53. Compatibilities
  54.  
  55. Neither InterBase nor InterServer need to be installed on 
  56. the client machine, nor even InterClient if running applets.
  57.  
  58. InterClient 1.1 is compatible with the
  59.    Java Runtime Environment (JRE) 1.1
  60.  
  61. InterServer 1.1 has been tested with
  62.    InterBase 4.x and 5.0
  63.    Windows 95 and NT 4.0
  64.    Solaris 2.x including 2.6
  65.    HP-UX 10.x
  66.  
  67. __________________________________________________________________
  68. Configuration 
  69.  
  70.   On both Windows and Unix, the following 
  71.   entry must appear in the services file.
  72.  
  73.             interserver 3060/tcp
  74.  
  75.   The TCP/IP services file was modified as a part of the 
  76.   installation.  You can add the above line manually if you
  77.   decided not to have setup make the modifications for you.
  78.  
  79.   The services file can be located as follows:
  80.    *  Windows NT         <WINDOWS_DIR>\system32\drivers\etc\services
  81.    *  Windows 95         <WINDOWS_DIR>\services
  82.    *  Unix               /etc/services or an NIS services map
  83.         
  84.   For Unix only, an entry in the /etc/inetd.conf file is also required:
  85.  
  86.     interserver stream tcp nowait root /usr/interclient/bin/interserver interserver
  87.  
  88.   The CLASSPATH environment variable should be updated to include
  89.           <INSTALL_DIR>\interclient.jar
  90.  
  91.   These configurations should be performed automatically by the
  92.   Windows install program.  The class path configuration for 
  93.   UNIX must be performed manually.
  94.  
  95. __________________________________________________________________
  96. Testing an Applet Configuration
  97.  
  98.   See Install.txt for basic instructions on testing your local
  99.   machine configuration for running InterClient applications.
  100.   
  101.   CommDiag may also be run as an applet on clients in which neither
  102.   the JDK nor InterClient is installed.  Using a Java enabled browser,
  103.   browse CommDiag.html or CommDiagForNetscape.html off a web server
  104.   which has InterClient deployed.  If you run InterClient applets
  105.   such as CommDiag through a browser, then you may need to remove the 
  106.   interclient.jar from your local CLASSPATH to avoid a security 
  107.   exception.
  108.  
  109.   You may also run CommDiag through the appletviewer:
  110.     unset CLASSPATH
  111.     appletviewer CommDiag.html
  112.   You may need to unset your CLASSPATH temporarily in your command
  113.   session when viewing a local applet, otherwise you could receive a
  114.   java.lang.IllegalAccessError.  CommDiag.html contains
  115.   an applet tag which references the interclient.jar archive.
  116.  
  117.   Untrusted applets are not allowed to open network connections to 
  118.   arbitrary hosts, except for the host that provided the .class files. 
  119.   This is either the host where the html page came from, 
  120.   or the host specified in the codebase parameter in the applet tag,
  121.   with codebase taking precendence. Therefore, untrusted applets,
  122.   will only operate if InterServer is installed on the same web 
  123.   server host that serves the interclient.jar file.  If you choose
  124.   to deploy InterServer on another host then you must digitally
  125.   sign your applet together with the interclient.jar file so
  126.   that the entire applet is trusted.
  127.  
  128.   Be sure to name the originating host exactly as it was specified 
  129.   when the applet was loaded into the browser. 
  130.   That is, if you load an HTML page using the URL 
  131.     http://foo.state.edu/~me/CommDiag.html
  132.   then your applet will be able to connect to its host only by using
  133.   the name foo.state.edu in the jdbc URL
  134.     jdbc:interbase://foo.state.edu//databases/employee.gdb
  135.   Using the IP address for foo.state.edu won't work, and using a
  136.   "shorthand" form of the host name, like foo.state instead of 
  137.   foo.state.edu, won't work.
  138. __________________________________________________________________
  139.  
  140.  
  141.  
  142.  
  143.