home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / TRIAL / INTRCLNT / _SETUP.LIB / Install.txt < prev    next >
Encoding:
Text File  |  1997-11-14  |  6.5 KB  |  169 lines
  1.  
  2.            Install readme file for InterClient 1.12
  3.  
  4.        (c) 1997 InterBase, Inc. All rights reserved.
  5. _________________________________________________________________
  6. Contents:
  7.  
  8.      I.  Installation Note for Windows NT and 95
  9.     II.  Uninstalling on Windows NT and 95
  10.    III.  Installation Note for Solaris and HP-UX
  11.     IV.  Installation Options
  12.      V.  Testing your Local Installation
  13.     VI.  Software Expiration
  14.  
  15. __________________________________________________________________
  16. Installation Note for Windows NT and 95
  17.  
  18.   If you have a previous release of InterClient installed on
  19.   this machine, you MUST uninstall it before continuing.
  20.  
  21. __________________________________________________________________
  22. Uninstalling on Windows NT and 95.
  23.  
  24.   Before uninstalling, you should first stop the InterServer 
  25.   service or application if it is running, and then remove the 
  26.   service using the InterServer Configuration Utility.
  27.  
  28.   When uninstalling on NT, use the add/remove program icon in
  29.   the NT control panel.  On Windows 95, there is an uninstall 
  30.   icon in the InterClient program group if InterServer was 
  31.   previously installed.
  32.  
  33. __________________________________________________________________
  34. Installation Note for Solaris and HP-UX
  35.  
  36.   After the download files have been extracted using the tar
  37.   command (tar -xvf InterClientV10.tar), a directory will
  38.   be created named interclient_install_temp_dir containing
  39.   the following files.
  40.  
  41.     install.sh      : the installation program
  42.     interclient.tar : components to be extracted by install.sh
  43.  
  44.   The installation process creates a log file of the installation 
  45.   session.  It is important to retain the log file in the
  46.   installation directory.  
  47.    - It contains the configuration information specific to your 
  48.      site necessary to complete the installation.
  49.    - It contains a log of your installation choices. It will be 
  50.      required should you require technical support. 
  51.  
  52.   On both UNIX and 95/NT, the following entry must occur in the
  53.   /etc/services file or the NIS services map:
  54.  
  55.             interserver 3060/tcp
  56.  
  57.   You must add this line manually.
  58.  
  59.   On both UNIX and 95/NT, the following entry must occur in the
  60.   /etc/services file or the NIS services map:
  61.  
  62.     interserver 3060/tcp
  63.  
  64.   You must add this line manually.
  65.  
  66.   An entry in the /etc/inetd.conf file is also required:
  67.  
  68.     interserver stream tcp nowait root /usr/interclient/bin/interserver interserver
  69.  
  70.   You must add this line manually also.
  71.  
  72.   After adding these entries, either reboot the system or restart the
  73.   inet daemon.  To restart the inet daemon, use the ps command to
  74.   discover the process id of the inetd process:
  75.  
  76.      ps -e | grep inetd
  77.   or 
  78.      ps -ax | grep inetd
  79.  
  80.   The number in the output column 'PID' is the process id of the inet 
  81.   daemon.  Use the process id with the following command to restart the 
  82.   inet daemon:
  83.  
  84.     kill -HUP <PID>
  85.  
  86.   After installing, be sure to add /usr/interclient/interclient.jar 
  87.   to your CLASSPATH.
  88.  
  89. __________________________________________________________________
  90. Installation Options
  91.  
  92. During installation you will be prompted to choose one of the 
  93. following.
  94.  
  95.    o Development Environment
  96.  
  97.       This selection installs the full development environment.
  98.        - InterClient classes are installed for local JDBC development.
  99.        - InterServer is installed for local or remote access to an InterBase
  100.          server.
  101.  
  102.    o Development and Web Deploy Environment
  103.  
  104.       This selection installs the full development environment
  105.       as above.  In addition the InterClient classes and documentation
  106.       are copied to the document root directory of your web server.
  107.        - InterClient classes are installed for local JDBC development.
  108.        - InterServer is installed for local or remote access to an InterBase
  109.          server.
  110.        - In addition, InterClient classes are copied to the 
  111.          document root directory of your Web server.
  112.  
  113.    o Deploy to Web Server Only
  114.  
  115.       This selection installs the InterClient classes and documentation
  116.       only to the document root directory of your Web server.
  117.        - InterServer is installed for use by local or remote clients.
  118.        - InterClient classes are copied to the document root directory 
  119.           of the Web server.
  120.  
  121.    o Client Development Only
  122.  
  123.       This selection installs the InterClient classes and documentation
  124.       on the local client for use in local Java application development
  125.       against a remote server with a separately installed InterServer.
  126.        - InterClient classes are installed for local development.
  127.  
  128. __________________________________________________________________
  129. Testing your Local Installation
  130.  
  131.   First, verify that the installation automatically appended your
  132.   CLASSPATH with <install-dir>/interclient.jar.
  133.  
  134.   Second, on Windows NT/95, select the InterServer Configuration 
  135.   Utility icon in the InterClient program group and start the
  136.   InterServer service or application (usually, but not necessarily,
  137.   on your InterBase server).  On Unix the interserver service is 
  138.   started automatically by inetd if your /etc/services and 
  139.   /etc/inetd.conf are configured properly.
  140.  
  141.   Finally, on Windows NT/95, select the Communication Diagnostics
  142.   icon from the InterClient program group.  If Java is installed
  143.   on your local machine and interclient.jar is in your CLASSPATH,
  144.   then a GUI will appear for making a test connection using the
  145.   locally installed driver.  Alternatively, and on Unix, you may
  146.   invoke the Communiation Diagnostics Utility from the command line
  147.     java interbase.interclient.utils.CommDiag
  148.  
  149.   Note: the instructions outlined above are not relevant for testing
  150.   the deployment of InterClient applets from a web server.
  151.   See Readme.txt for instructions on testing an applet configuration.
  152.  
  153. __________________________________________________________________
  154. Software Expiration
  155.  
  156.   This product release of InterClient will expire, but continue to 
  157.   function, on Dec 31, 1988. 
  158.  
  159.   Expired product releases of InterClient will accept connections,
  160.   but will tag the connection with an ExpiredDriverWarning.
  161.   Expired beta releases of InterClient may throw an 
  162.   ExpiredDriverException and refuse connections.
  163.  
  164.   Upon expiration, it is suggested that you upgrade both InterClient
  165.   and InterServer driver components by downloading a recent release 
  166.   from http://www.interbase.com.
  167.  
  168. ---------------------------------END----------------------------------
  169.