home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / rsync1.exe / RSYNC1.TXT < prev   
Text File  |  1994-05-11  |  12KB  |  286 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              NetWare MHS Remote Node Utility
  5. DOCUMENT ID:        TID200044
  6. DOCUMENT REVISION:  A
  7. DATE:               11MAY94
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         RSYNC1.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare Remote MHS 2.0
  14.  
  15. ABSTRACT:
  16.  
  17. NetWare MHS Remote Node Utility (RSYNC) is a DOS executable designed to allow
  18. a NetWare Remote MHS 2.0 (RMHS) user who has installed RMHS using the
  19. "Part-time Remote User" mode to take advantage of a remote-node connection to
  20. the network to facilitate the exchange of messages.  NOTE:  If you are using
  21. NetWare Connect, please read the information in the "Using RSYNC with NetWare
  22. Connect" section of the "Solution Specifics:" field in RSYNC.TXT.
  23.  
  24. ──────────────────────────────────────────────────────────────────────────────
  25. DISCLAIMER
  26. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  27. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  28. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  29. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  30. ──────────────────────────────────────────────────────────────────────────────
  31.  
  32. SYMPTOM
  33.  
  34.      Users must dial directly into the Global MHS server for mail transfers.
  35.  
  36. SOLUTION
  37.  
  38.      Apply RSYNC.EXE to NetWare Remote MHS 2.0 installation.
  39.  
  40.      NetWare MHS Remote Node Utility (RSYNC) is a DOS executable designed to
  41.      allow a NetWare Remote MHS 2.0 (RMHS) user who has installed RMHS using
  42.      the "Part-time Remote User" mode to take advantage of a remote-node
  43.      connection to the network to facilitate the exchange of messages.  The
  44.      remote-node connection is utilized instead of dialing directly into the
  45.      Global MHS server for mail transfers.  Remote-node connections are
  46.      provided by NetWare Connect 1.0.33 or greater.
  47.  
  48.      Self-Extracting File Name:  RSYNC1.EXE     Revision:  A
  49.  
  50.      Files Included     Size     Date      Time
  51.  
  52.      \
  53.        RSYNC1.TXT         (This File)
  54.           MHS.MSG      47885   03-23-94    4:40p
  55.         RSYNC.EXE      77072   03-23-94    4:40p
  56.  
  57.  
  58.      Installation Instructions:
  59.  
  60.      To install RSYNC, you will require the following:
  61.  
  62.      ■    NetWare Remote MHS 2.0 installed in part-time user mode
  63.  
  64.      ■    NetWare Connect 1.0.33 or greater
  65.  
  66.      To install RSYNC, do the following steps
  67.  
  68.      1.   Install NetWare Remote MHS 2.0 in part-time user mode including
  69.           application software and default connectivity settings.
  70.  
  71.           Make sure the "Net MHS Tree" field is properly configured according
  72.           to the RMHS documentation. It should point to the MHS tree on the
  73.           file server  (for example, f:\mhs).
  74.  
  75.      2.   Copy RSYNC.EXE and the new MHS.MSG file into your MHS\EXE directory.
  76.  
  77.      3.   Make sure MV is set to the MHS tree on your local drive, or remove
  78.           the MV setting by executing the following DOS command:
  79.  
  80.                SET MV=
  81.  
  82.      4.   Execute RSYNC with desired optional command-line parameters.
  83.  
  84.      As an added convenience, RSYNC can be executed from a NetWare Login
  85.      Script by using the following statement:
  86.  
  87.           '#[d:path]\RSYNC
  88.  
  89.      where [d:path] is replaced by the path to the location of RSYNC on the
  90.      local hard disk.  Adding this statement will cause RSYNC to be executed
  91.      each time the user logs into the network.
  92.  
  93.      -----------------------------------------------------------
  94.                   CONFIGURING RSYNC
  95.      -----------------------------------------------------------
  96.  
  97.      RSYNC configuration is performed by using the RSETUP program that is
  98.      supplied by NetWare Remote MHS 2.0.  The RMHS configuration parameters
  99.      used by RSYNC are the following:
  100.  
  101.      ■    Net MHS Tree
  102.      ■    Threshold
  103.      ■    Application Information
  104.      ■    User Information
  105.  
  106.      In its default (no parameters) mode, RSYNC works like RMHS in providing
  107.      mail transfer services.  It transfers messages created by your messaging
  108.      application to the server and transfers messages waiting for you on the
  109.      server to your own PC.  The network path is used to specify your home
  110.      mail server. This field is specified using RSETUP.
  111.  
  112.      RSYNC also has some synchronization options for use when the laptop is
  113.      reconnected to the network.  The following options are the same as those
  114.      for RMHS:
  115.  
  116.      -E
  117.  
  118.      ■    This parameter allows part-time remote users to synchronize the MHS
  119.           directory extract files.
  120.  
  121.      ■    To synchronize the SMF-NS.XRT, extract file using  -E.
  122.  
  123.      ■    Note:  This parameter is dependent on the value of the "Net MHS
  124.           Tree" field on the RSETUP Configuration Setup screen.  If your
  125.           network mail path is changed by your administrator, you must run
  126.           RSETUP to modify the "Net MHS Tree" field to reflect this change.
  127.  
  128.      ■    Following the extract file synchronization process, RSYNC will
  129.           continue with its normal processing (uploading messages if -Y is
  130.           also used or downloading messages if no other option is specified).
  131.  
  132.      ■    Novell recommends that you perform an "RSYNC -E" before
  133.           disconnecting the workstation from the network for remote use.  This
  134.           ensures that the extract files are up to date before going remote.
  135.  
  136.      -Y
  137.  
  138.      ■    This option signals RSYNC to upload messages sent since the last
  139.           time you connected to the server. This prevents messages from
  140.           getting stuck on your PC until the next time you disconnect from the
  141.           network.
  142.  
  143.      ■    Novell recommends that you perform an "RSYNC -Y" immediately after
  144.           reconnecting your workstation to the network (that is, when
  145.           switching from Remote to Network mode).
  146.  
  147.           This is best achieved by placing the following line in your NetWare
  148.           Login script:
  149.  
  150.               #[d:path]\RSYNC -Y
  151.  
  152.           Note:[d:path] is replaced by the path to the location of RSYNC on
  153.           the local hard disk.  Adding this RSYNC also supports the following
  154.           command line settings:
  155.  
  156.           -Tnnnn
  157.           This option overrides the size threshold you configured with RSETUP.
  158.           Messages greater than the size (in KB) you specify here, will remain
  159.           on your MHS server.  If you enter 0, all messages are accepted.
  160.  
  161.      -S
  162.  
  163.      ■    This option specifies that you will send mail only, rather than
  164.           sending and receiving mail.
  165.  
  166.      -Vn
  167.  
  168.      ■    This option indicates the level of information that will be reported
  169.           to the log file.  Enter a number from 0 to 9, with 9 being the most
  170.           information.  This is useful when troubleshooting problems.  These
  171.           messages are sent to RMHS.LOG as message #0.
  172.  
  173.  
  174.      -Q[2]
  175.  
  176.      ■    This option will run RSYNC in quiet mode or silent mode. Use -Q to
  177.           run RSYNC in quiet mode.  In quiet mode, RSYNC displays on error
  178.           messages to the screen.  Use -Q2 to run RSYNC in silent mode.  In
  179.           silent mode, RSYNC does not display any information to the screen.
  180.  
  181.      -Ffilename
  182.  
  183.      ■    This option indicates the name of the ASCII file you have created
  184.           which includes any valid command-line parameters.
  185.  
  186.      -M["dos path to MHS directory tree"]
  187.  
  188.      ■    This parameter overrides the DOS MV environment variable.  This
  189.           option must be used when running RMHS.EXE from a directory other
  190.           than MHS\EXE.
  191.  
  192.           Example:  RSYNC -M"c:\apps"
  193.  
  194.           where the MHS tree is located at c:\apps\mhs.
  195.  
  196.      Solution Specifics:
  197.  
  198.      Uncorrected Features and General Restrictions
  199.  
  200.      The following lists features, with operational anomalies, that could not
  201.      be corrected before this release of the software and general restrictions
  202.      of which you need to be aware:
  203.  
  204.      ■    The RSYNC utility supports partial message recovery.  For mail
  205.           transfers that terminated prematurely, this feature allows the
  206.           aborted transfer to resume at the point of  termination.
  207.  
  208.           When this situation arises, the remote workstation may retain
  209.           temporary files in the MHS directory tree.  These files will
  210.           generally have a ".$$$" or ".PAR" file extension and are used by
  211.           RSYNC to resume the message transfer during the next session.
  212.  
  213.           Due to network server security, message uploads to the MHS server's
  214.           SND directory can only be recovered to the last file transferred,
  215.           while message downloads to the user's remote mailbox can be
  216.           recovered to the byte.
  217.  
  218.           Repeated message upload failures can leave "orphaned" attachments in
  219.           the MHS\MAIL\PARCEL directory.  Your administrator should remove
  220.           files in this directory that do not correspond to a message file in
  221.           the MHS\MAIL\SND directory.
  222.  
  223.           Interrupted message uploads (due to pressing the <Esc> key or loss
  224.           of communication) during the final message copying phase can cause
  225.           .BAD messages to be generated in the SND directory by the MHS
  226.           server.  The MHS server will generate undeliverable notification
  227.           messages to the administrator or postmaster.  These .BAD messages
  228.           can be identified by a <lf> character (ASCII - 0A hex) in the very
  229.           first byte of the message.
  230.  
  231.      ■    When using RSYNC with NetWare Connect, some abnormal connection
  232.           termination's can occur when modem speeds are set higher than 19,200
  233.           BPS.  This may be due to characters being lost at higher modem
  234.           speeds.  In this case, try selecting a lower modem speed to reduce
  235.           the possibility of any character loss.
  236.  
  237.           Please note that no performance penalty occurs in using a 19,200 BPS
  238.           port speed with modems which support carrier speeds less than or
  239.           equal to 14,400 BPS.
  240.  
  241.      Using RSYNC with NetWare Connect
  242.  
  243.           When using RSYNC utility with NetWare Connect, some abnormal
  244.           connection termination's can occur when modem speeds are set higher
  245.           than 19,200 BPS.  This may be due to characters being lost at higher
  246.           modem speeds.  In this case, try selecting a lower modem speed to
  247.           reduce the possibility of any character loss.
  248.  
  249.           It should be noted that there is no performance penalty in using a
  250.           19,200 BPS port speed with modems that support carrier speeds less
  251.           than or equal to 14,400 BPS.
  252.  
  253.           When using RSYNC with NetWare Connect's Software Compression
  254.           feature, abnormal connection termination's can sometimes occur. If
  255.           you experience abnormal connection terminations, disable the
  256.           Software Compression feature using the following steps:
  257.  
  258.           1.   Load the LSL and NRN device drivers.
  259.           2.   Run DIALCON utility.
  260.           3.   Select the "Configure Port" operation.
  261.           4.   Press <Enter> twice to select default path for NET.CFG.
  262.           5.   Select your serial driver in the "Configure Driver" screen.
  263.           6.   Using arrow keys, move to the "Software Compression" field.
  264.           7.   Press <Enter> and select the "Disabled" setting.
  265.           8.   Press <Esc> and select "Yes" to save the new configuration.
  266.           9.   Press <Alt>+<F10> to exit the DIALCON utility.
  267.           10.  Unload NRN using the "NRN u" command.
  268.  
  269.           The new configuration takes effect next time you load "NRN."
  270.  
  271.      For more detail on configuring NetWare Connect, see your NetWare Connect
  272.      Administration Guide.
  273.  
  274.      If you have questions on RSYNC, call Novell Technical Support
  275.      (800-NETWARE, outside the U.S., call 801-429-5588).
  276.  
  277. ────────────────────────────────────────────────────────────────
  278. Any trademarks referenced in this document are the property of their
  279. respective owners.  Consult your product manuals for complete trademark
  280. information.
  281. ────────────────────────────────────────────────────────────────
  282.  
  283.  
  284.  
  285.  
  286.