home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / TRIAL / DSJ / README.TXT < prev    next >
Encoding:
Text File  |  1998-05-08  |  7.2 KB  |  193 lines
  1. ------------------------------------------------------------
  2. Borland Deployment Server for Java (DSJ)
  3. README.TXT
  4. Updated 04/29/98 5:53 PM
  5.  
  6. ------------------------------------------------------------
  7. CONTENTS
  8. ------------------------------------------------------------
  9.  
  10. 1. LATE CHANGES AND ADDITIONS
  11. 2. SERVER USAGE NOTES
  12. 3. CLIENT USAGE NOTES
  13. 4. RUNNING DSJ ON SOLARIS/UNIX
  14. 5. DSJ RESOURCES
  15.  
  16. ------------------------------------------------------------
  17. 1. LATE CHANGES AND ADDITIONS
  18. ------------------------------------------------------------
  19.  
  20. Changes to the DSJ Server:
  21.  
  22. * The server's JREDirectories property defaults to .\jres
  23.   (plural), not .\jre
  24.  
  25. * Four JREs are pre-installed in server, allowing immediate
  26.   use of an application's RequiredJRE property. They are
  27.   Sun Microsystems Win32 versions:
  28.   - 1.0.2
  29.   - 1.1.5
  30.   - 1.1.6
  31.   - 1.2beta3
  32.  
  33. * The installed server footprint is larger -- 34 MB --
  34.   because of the pre-installed JREs.
  35.  
  36. * An application's VersionDate property now supports and
  37.   prefers the YYYY/MM/DD format. The date may be typed in
  38.   the Application dialog box in any of the following
  39.   generally recognized date formats:
  40.     March 23, 1998
  41.     23-Mar-1998
  42.     1998/03/23
  43.   The date will be stored in the .app file and displayed in
  44.   the administration frame in YYYY/MM/DD format. If you
  45.   edit the .app file directly, you must use the YYYY/MM/DD
  46.   format.
  47.  
  48. * The dsj.toc file in the server's DatabaseDirectory
  49.   directory has been renamed to dsj.ptoc.
  50.  
  51. * Restarting the server does not create a stacked process
  52.   stub; therefore, there is no limit to server restarts.
  53.   The server's MaximumRestarts property is deprecated but
  54.   still honored; you can set it to an arbitrarily high
  55.   number (like 1000000) to avoid any warnings.
  56.  
  57. * When the server instructs the client to restart, the
  58.   client does not change its use of the console. The
  59.   application's UsesConsole property is ignored and
  60.   deprecated.
  61.  
  62. * The file jbcl.zip (listed in Table 3.1 on page 3-2 of the
  63.   DSJ User's Guide) has been replaced by two files:
  64.   jbcl2.0-rt.jar and jbcl2.0-res-rt.jar
  65.  
  66. * The classpath for the Hello sample application described
  67.   in Table 3.7 on page 3-14 of the DSJ User's Guide should
  68.   read:
  69.  
  70.     c:\jbuilder\myclasses;jgl3.1.0.jar;jbcl2.0-rt.jar;jbcl2.0-res-rt.jar;swingall.jar
  71.  
  72. Changes to the DSJ Client:
  73.  
  74. * The formerly-hidden DSJUseURLFactory property is exposed
  75.   in the dsj.properties file. It is a true/false property
  76.   that controls whether the DSJ client uses its class
  77.   loader as the URL factory, and should be set to true (the
  78.   default) unless a specific application uses its own URL
  79.   factory, which is rare.
  80.  
  81. Additions to the DSJ Server: none
  82.  
  83. Additions to the DSJ Client:
  84.  
  85. * DSJPromptForUsername is a true/false property that
  86.   controls whether the client always prompts the user for
  87.   their user name and password during startup. If you
  88.   specify a DSJUsername in the dsj.properties file or the
  89.   command line, that user name will be the default in the
  90.   dialog box. There is never a default password in the
  91.   dialog box.
  92.  
  93. ------------------------------------------------------------
  94. 2. SERVER USAGE NOTES
  95. ------------------------------------------------------------
  96.  
  97. * If an application is installed improperly on the server
  98.   (perhaps a .jar file was left off the classpath), the
  99.   problem won't appear until a client attempts to run the
  100.   application. When the client makes a request that the
  101.   server cannot fulfill, the server responds with a packet
  102.   that says the requested resource isn't available. This
  103.   failure is recorded on the client's cache for that
  104.   application. If the application is reinstalled correctly,
  105.   when the client attempts to run the application again, it
  106.   will fail again at the same point because the client's
  107.   cache says that the resource doesn't exist. To fix the
  108.   problem, the client's cache file for that application
  109.   must also be deleted.
  110.  
  111. * If you get an out of memory error (for example, when
  112.   installing an application), try restarting the server
  113.   with a larger heap. The -mx option controls the maximum
  114.   heap size. For example, you can modify the dsjserver.bat
  115.   file and change -mx48m to -mx64m.
  116.  
  117. * The "drop idle connections" option on the General page of
  118.   the Application dialog box does not work; idle
  119.   connections are never dropped.
  120.  
  121. * You cannot run more than one server on the same machine
  122.   listening to the same Port.
  123.  
  124. ------------------------------------------------------------
  125. 3. CLIENT USAGE NOTES
  126. ------------------------------------------------------------
  127.  
  128. * With the Windows 95 MS-DOS Prompt command shell, you can
  129.   only use the dsjclient.bat file to specify the
  130.   application name, for example:
  131.  
  132.     dsjclient Welcome
  133.  
  134.   You cannot specify other DSJ client properties through the
  135.   dsjclient.bat file, due to a problem with how the Windows
  136.   95 MS-DOS Prompt parses command line arguments for batch
  137.   files. To specify other client properties on the command
  138.   line, type the actual command line (see "Command line
  139.   arguments" in the DSJ User's Guide, page 2-15) instead of
  140.   using the dsjclient.bat file. For example, to specify a
  141.   different server and the application:
  142.  
  143.     java\bin\jre -Djava.compiler=javacomp -classpath java\lib\rt.jar;java\lib\i18n.jar;. borland.jax.client.Jax /DSJServer=altserver.mycompany.com /DSJApplication=Welcome
  144.  
  145.   Other command shells, such as the Windows NT command
  146.   prompt and the 4DOS command prompt running under Windows
  147.   95, do not have this limitation.
  148.  
  149. ------------------------------------------------------------
  150. 4. RUNNING DSJ ON SOLARIS/UNIX
  151. ------------------------------------------------------------
  152.  
  153. To run the DSJ server or client on Solaris (and other Unix
  154. platforms with a working 1.1.6 JDK port):
  155.  
  156. * Copy the installed files and directories from a Windows
  157.   machine.
  158.  
  159. * Convert dsjserver.bat and dsjclient.bat into shell
  160.   scripts. The exact translation depends on the shell you
  161.   are running.
  162.  
  163. * Replace all file and path separators in the shell scripts,
  164.   and in the dsj.properties file. "\" should be changed to
  165.   "/", and ";" should be changed to ":". Use the slash and
  166.   colon in the classpath when adding applications.
  167.  
  168. * The 1.1.6 JRE for Solaris has no rt.jar file; use
  169.   classes.zip instead. Copy classes.zip to DSJ's java/lib
  170.   subdirectory, and change all occurrences of rt.jar in the
  171.   classpath for the client and server to classes.zip.
  172.  
  173. ------------------------------------------------------------
  174. 5. DSJ RESOURCES
  175. ------------------------------------------------------------
  176.  
  177. Borland offers a number of newsgroups for obtaining and
  178. exchanging information on DSJ and other Borland products. To
  179. access the newsgroups, set your news reader to point to the
  180. server forums.borland.com, or visit
  181. http://www.borland.com/newsgroups
  182.  
  183.  
  184. ------------------------------------------------------------
  185. Copyright ⌐ 1998 Borland International, Inc.
  186. All rights reserved. All Borland products are trademarks or
  187. registered trademarks of Borland International, Inc. Other
  188. brand and product names used in this document and other
  189. documents and files included in this software package are
  190. trademarks or registered trademarks of their respective
  191. holders.
  192.  
  193.