home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / mr2i160.zip / MR2ILDA.DOC < prev    next >
Text File  |  1995-11-12  |  7KB  |  151 lines
  1.  
  2. The MR/2 ICE Local Deliver Agent (LDA) - MR2ILDA.EXE
  3. ====================================================
  4.  
  5. This LDA, when used as the "MLocal" parameter to sendmail, will deliver 
  6. mail in a manner that allows MR/2 ICE to be used in SMTP-mode.  
  7.  
  8. There is another mode that makes this LDA run in POP3D compatibility 
  9. mode.  In this mode, mr2ilda.exe can be used as a replacement for the 
  10. shareware utility POP3D's mailsrt.exe LDA.  This is not meant to be a 
  11. feature in itself (although it could be, I guess), but will allow the
  12. Secant Technologies POP3 daemon to easily replace POP3D as POP server,
  13. if desired.  Secant's POP3 daemon will be released shortly as shareware.
  14.  
  15. The default mode for Mr2iLDA is "simple mode".  This delivers mail into 
  16. the "MAIL" sub directory of the defined ETC directory.  MR/2 ICE's 
  17. settings for "mail directory" defaults to this directory when the SMTP 
  18. read mode is clicked.
  19.  
  20.  
  21. ===================================================================
  22.                           N  O  T  E  S
  23. ===================================================================
  24. MR/2 ICE has been reported to work just fine with existing setups
  25. that make use of the freeware LDA "deliver.exe".  If you are using
  26. this already in conjunction with some other mailer, try MR/2 ICE
  27. without changing the sendmail configuration.  Just point the SMTP
  28. settings to the directory where new mail is delivered.
  29.  
  30. LAMAIL users should find that MR/2 ICE is a "snap in" replacement
  31. for it, too.  MR/2 will work very well with sendmail's previously
  32. configured to deliver to LAMAIL.  For these users, selecting
  33. SMTP reading in the ICE settings should be all that's required.
  34.  
  35. ULTIMAIL users should be aware that their sendmail uses a
  36. configuration file called "sendmail.uml".  See the specific
  37. example, below.
  38. ===================================================================
  39.  
  40. To install MR2iLDA, simply modify your ETC\sendmail.cf file to contain 
  41. the following line:
  42.  
  43.   Mlocal, P=c:\mr2i\mr2ilda.exe, F=lsDFMP, S=10, R=0, A=-S $u
  44.  
  45. WHERE c:\mr2i reflects the directory in which mr2ilda resides.  The
  46. -S parameter specifies SIMPLE delivery mode and should be present
  47. even though it is the default mode.  Everthing after the A= is passed
  48. to mr2ilda.exe when mail arrives, the $u is replaced by sendmail with 
  49. the target user's name.
  50.  
  51. ULTIMAIL users will need to edit the file ETC\sendmail.uml.  The
  52. existing LDA line will look something like:
  53.  
  54.   Mlocal, P=c:\umail\umailer.exe, F=lsDFP, S=10, R=20, [and so on]
  55.   
  56. Comment out the umailer.exe line by preceeding the line with a couple
  57. of "#" signs and add the mr2ilda.exe line shown above.
  58.                 
  59.  
  60. Command line parameters (case insensitive):
  61.  
  62. -Afname Address file to use when in POP3 delivery mode.  The 
  63.         default in this mode is to use the file "mailaddr"
  64.         in the directory where mr2ilda.exe resides.
  65.  
  66. -S      Specifies "simple" mode (default).  Mail is delivered 
  67.         to the "MAIL" sub directory of the specified ETC path.
  68.  
  69. -P      Specifies POP3D mode                                    
  70.                                 
  71. -D      Debug mode.  This will output various "extra" messages
  72.         to the sendmail screen to facilitate locating problems.
  73.                                 
  74. -Ffname File name containing mail to be delivered.  If not 
  75.         specificed, the default is to accept the message from
  76.         stdid (sendmail's delivery mode).
  77.  
  78. -V      Verbose mode.  Will output some additional informational
  79.         messages to the sendmail screen.                                
  80.  
  81.  
  82. Optional POP3D mode
  83. ===================
  84. This mode will actually place mail into directories based on a user-name 
  85. lookup into an address table.  By default, the user index file used is
  86. called "mailaddr" and should be in the same directory as mr2ilda.exe.  
  87. This file can be specified on the command line by using the -A flag.
  88.  
  89. An example mailaddr file might look like this:
  90.  
  91.         deadmail        d:\mail\deadmail
  92.         nick            d:\mail\nick            nick
  93.         john            d:\mail\john            password
  94.         fred            d:\mail\fred            fredster
  95.                 
  96. where the first column is the email name to match (part preceeding the 
  97. "@" sign.  For example, for nick@secant.com, the user name is nick).  
  98. The second column specifies the directory in which to deposit incoming 
  99. mail.  The last column is an (optional) POP3 password.  It is not used 
  100. by MR2iLDA, but allows the same file to be used by POP3d and/or Secant 
  101. Technologies' POP3 Server.
  102.  
  103. Mail not matching any user in the index is delivered to the first user 
  104. name in the index.      Optionally, a user name of "*" may be used to match 
  105. ANY name.  This should be the LAST line of the index file, and will
  106. subsequently receive all "unknown addressee" mail instead of the first 
  107. user.
  108.  
  109. I believe this utility to be an excellent replacement for the 
  110. MAILSRT.EXE that comes with POP3D, at least comparing it to the version 
  111. we used to use.  It will not crash on long lines AND will not lose mail 
  112. on a file-name-from-time collision. Oh, yes, MAILSRT would throw out a 
  113. message occassionally, if two messages arrived at the same second and 
  114. thus were given the same file name.  I've already confirmed that MR2iLDA 
  115. handles this properly.
  116.  
  117.  
  118. QUICK START
  119. ===========
  120.  
  121. 1.      Edit your sendmail.cf file and insert the "MLocal" line shown above.  
  122.         Make sure to comment out the existing MLocal entry by placing a "#" 
  123.         in front of the line.  USE THE SYSTEM E EDITOR, as sendmail.cf is 
  124.         sensitive to tab-formatting and the E editor does not mess this file 
  125.         up.
  126.         
  127. 2.      Make sure the ETC environment variable is set correctly.
  128.  
  129. 3.      Restart your sendmail daemon (shutdown, then reboot the system if
  130.         you don't know how).
  131.         
  132. 4.      Configure MR/2 ICE.  Options->Settings->Network.  Click the 
  133.         "SMTP Read" radio button.  The SMTP group box "mail path" should
  134.         be set to the MAIL sub directory of your ETC directory.  Confirm
  135.         this, close the settings notebook.
  136.         
  137. 5.      Send yourself a test message.  Did it work? :)
  138.  
  139.  
  140. NOTES:
  141. ===== 
  142.  
  143. o       MR2iLDA will create a MAIL sub directory off of ETC, if one
  144.         does not exist.
  145.  
  146. o       File names will be 8 characters of hex/numeric, with an extension
  147.         of ".rcv".  If a collision occurs, the base file name will remain
  148.         the same, but the extension will be .001 (or .002 if that file
  149.         exists, and so on...)
  150.         
  151.