home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / JAVA_ALL / RMI_OS / README-W.TXT < prev    next >
Encoding:
Text File  |  1997-02-26  |  5.9 KB  |  162 lines
  1.         Installing the RMI package on a Win32 system
  2.         ==============================================
  3.  
  4.     *******************************************************************
  5.     ***                                                             ***
  6.     *** Remember: to run this release, you need to have JDK 1.0.2.  ***
  7.     ***                 Earlier releases will fail.                 ***
  8.     ***                                                             ***
  9.     *******************************************************************
  10.  
  11. Installing the RMI package
  12. --------------------------
  13.  
  14. (1) Download the zip file(s) to your local machine
  15.  
  16. The RMI zip file is called "rmi-prebeta1-win32-x86.zip".
  17.  
  18. If you also want to run the version of the HotJava Browser modified to
  19. be compatible with RMI and Object Serialization, you need to download
  20. its zip file as well: "hotjava-1_0prebeta1rmi-win32-x86.zip".
  21.  
  22. NOTE: The example commands below assume that you have downloaded the
  23. zip files to a directory on your local machine called "C:\downloads".
  24. If you are following these examples, replace this path with the actual
  25. location where you downloaded the zip files.
  26.  
  27.  
  28. (2) Install the zip file contents
  29.  
  30. Create a directory where you want RMI to be installed, "cd" to it, and
  31. unzip the RMI zip file.  For example, if you want to install RMI in the
  32. directory "C:\rmi", you might execute the following:
  33.  
  34.     C:\> mkdir \rmi            (create the RMI directory)
  35.     C:\> cd \rmi            (make sure you are inside of it)
  36.     C:\RMI> unzip C:\downloads\rmi-prebeta1-win32-x86.zip
  37.  
  38. If you are installing HotJava as well, "cd" to where you want its
  39. directory to be installed.  The HotJava zip file automatically creates
  40. everything in a single subdirectory, so you do not need to create it.
  41. For example, if you want to install HotJava in the directory "C:\HotJava",
  42. you might execute the following:
  43.  
  44.     C:\RMI> cd \            (make sure you are at root directory)
  45.     C:\> unzip C:\downloads\hotjava-1_0prebeta1rmi-win32-z86.zip
  46.  
  47.  
  48. (3) Set environment variables for running RMI
  49.  
  50. Because the Prebeta release of RMI is not installed in the JDK 1.0.2,
  51. it needs modification to three environment variables to function
  52. properly:
  53.  
  54.     (a) RMIHOME
  55.  
  56.     The RMIHOME variable must be set to the directory where you
  57.     installed RMI.  If you used the location in the example above,
  58.     then it would need to be set as follows:
  59.  
  60.         C:\> set RMIHOME=C:\rmi
  61.  
  62.     (b) PATH
  63.  
  64.     Your system PATH variable must include the bin subdirectory
  65.     of the RMI installation  (i.e., %RMIHOME%\bin) so that the
  66.     shared library for Object Serialization (OBJIO.DLL) and the
  67.     RMI command line utilities (rmic, rmiregistry, and serialver)
  68.     can be located.  You can append the RMI bin directory to the
  69.     current PATH as follows:
  70.  
  71.         C:\> set PATH=%RMIHOME%\bin;%PATH%
  72.  
  73.     (The %PATH% expression implies substitution of the current
  74.     value of the PATH variable, thus appending the RMI bin
  75.     directory to the beginning of the current PATH.)
  76.  
  77.     Note that since RMI requires JDK 1.0.2 as well, the bin
  78.     directory for your JDK 1.0.2 installation must be in
  79.     the PATH.
  80.  
  81.     If you are also installing HotJava as well, the bin
  82.     directory for the JDK 1.0.2 *must* be in the PATH *before*
  83.     the bin directory for HotJava.  For example, if your
  84.     JDK 1.0.2 is installed in the directory C:\java, you
  85.     could set your PATH correctly as follows:
  86.  
  87.         C:\> set PATH=%RMIHOME%\bin;C:\java\bin;C:\HotJava\bin;%PATH%
  88.  
  89.     This is tedious to type in, so in this case you would surely
  90.     want to put this all in a BAT script or change your default system
  91.     PATH as described below.
  92.  
  93.     (c) CLASSPATH
  94.  
  95.     Finally, your CLASSPATH variable must include the file "rmi.zip"
  96.     in the "lib" directory of the RMI installation.  If CLASSPATH
  97.     is not currently set, you could just set it to this as follows:
  98.  
  99.         C:\> set CLASSPATH=%RMIHOME%\lib\rmi.zip
  100.  
  101.     If your CLASSPATH already has other directory that you want to
  102.     keep as well, you could append to it as follows:
  103.  
  104.         C:\> set CLASSPATH=%RMIHOME%\lib\rmi.zip;%CLASSPATH%
  105.  
  106.     Note that if your CLASSPATH explcitly refers to classes from
  107.     version of the JDK older than 1.0.2, then the JDK 1.0.2's
  108.     appletviewer or the RMI version of HotJava could crash.
  109.     Remove these old classes from your CLASSPATH before using
  110.     those programs.
  111.  
  112. All these modifications to environment variables could be combined in
  113. a BAT script that you would run before working with RMI.  For example,
  114. using the directory locations chosen above and including the HotJava
  115. installation, the script might be called "set-rmi-env.bat" and look
  116. something like this:
  117.  
  118.     @echo off
  119.     echo Setting environment variables for working with RMI Prebeta...
  120.     set RMIHOME=C:\rmi
  121.     set PATH=C:\rmi\bin;C:\java\bin;C:\HotJava\bin;%PATH%
  122.     set CLASSPATH=C:\rmi\lib\rmi.zip
  123.  
  124. Most conveniently, you could put these commands in your AUTOEXEC.BAT
  125. file (Windows 95) or modify your default system or user environment
  126. variables (Windows NT) so that your environment would be ready to use
  127. RMI when you started up Windows 95 or logged in to Windows NT.
  128.  
  129.  
  130. To get started, try running our examples.  For instructions see:
  131.  
  132.    rmi\examples\hello\README.txt
  133.    rmi\examples\stock\README.txt
  134.  
  135.    
  136. Applets in a Browser
  137. --------------------
  138.  
  139. The only browser that can run RMI applets with this release is the
  140. HotJava browser that is available from our site.  It is identified as
  141. version "HotJava 1.0 preBeta1 (RMI)".  When you install HotJava, you
  142. must be sure that your executable search path "PATH" has the bin
  143. directory for the JDK *before* the bin directory for HotJava, or the
  144. RMI utilities will fail (see above regarding PATH).
  145.  
  146.  
  147. Support
  148. -------
  149.  
  150. Users of both RMI and object serialization can discuss issues and tips
  151. with other users via the mailing list rmi-users@java.sun.com.  You can
  152. subscribe by sending an email message containing the line
  153.  
  154.     subscribe rmi-users 
  155.  
  156. to listserv@java.sun.com, and unsubscribe by sending a message
  157. containing the line
  158.  
  159.     unsubscribe rmi-users
  160.  
  161. Support questions can be sent to rmi-support@java.sun.com.
  162.