home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume3 / dnamail / dnamail.doc < prev    next >
Text File  |  1989-02-03  |  9KB  |  232 lines
  1. 1) Intro
  2.  
  3.   Dnamail and dnamaild allow a Sun computer with the Sunlink/DNI software
  4.   to send and receive mail from VMS computers (may work with other DECnet
  5.   computers, but hasn't been tested).
  6.  
  7.   These programs cooperate with the sendmail program, so that users
  8.   do not need to use any special commands to send and receive mail.
  9.   This means that 'mailtool' may be used to read and compose messages.
  10.   Dnamail may also be used independently of sendmail, although message
  11.   editing is lacking.
  12.  
  13. 2) Installation
  14.  
  15.   >>    The DNI software has a bug that needs to be fixed before
  16.   >>    dnamail will work.  The bug is related to failure to read/write
  17.   >>    zero-length records.  You can get the patch from Sun 
  18.   >>    (bug #1007228), and possibly from the sun archives at rice.edu.
  19.   >>    You could possibly get them from me, but save this as a last resort.
  20.  
  21.   Look over 'Makefile' and 'dnamail.h'.  If you want to have dnamaild
  22.   run 'standalone', then uncomment the STANDALONE definition in
  23.   dnamail.h.  When dnamaild is compiled with the STANDALONE option, then
  24.   it will not automatically be called from dnaserver, but must be run
  25.   before you expect any mail to show up.  It will handle one mail connection
  26.   and then exit.  Obviously, this option is not too useful, but it helps
  27.   if you are trying to debug.
  28.  
  29.   Do 'make all'.  This should make the executables 'dnamail' and 'dnamaild'.
  30.  
  31.   Put the executables into /usr/sunlink/dna, or use a symbolic link.
  32.  
  33.   Add the following line to /usr/sunlink/dna/dnaserver.reg (if you want
  34.   to run dnamaild 'standalone', then you shouldn't do this):
  35.  
  36.      27    MAIL    /usr/sunlink/dna/dnamaild
  37.  
  38.   Modify sendmail.cf appropriately and restart sendmail.
  39.  
  40.   Test...  Before making sendmail.cf changes, you can try
  41.   running dnamail directly - just type /usr/sunlink/dna/dnamail.
  42.   After making the sendmail.cf changes, you can test by just sending
  43.   mail.
  44.  
  45. 3) Sendmail.cf changes
  46.  
  47.   In order to have dnamail and dnamaild cooperate with sendmail, changes
  48.   must be made to /usr/lib/sendmail.cf. 
  49.  
  50.   >>  If you have made changes to sendmail.cf before, or no someone
  51.   >>  who has, then the modifications will be relatively straightforward.
  52.   >>  If you don't fit into the above category, then I suggest that you
  53.   >>  read the 'Sendmail Installation and Operation' tutorial in the
  54.   >>  Sun system administrators guide to familiarize yourself with
  55.   >>  sendmail.
  56.  
  57.   On the Sun installation tape(s), sendmail.cf came in two forms,
  58.   sendmail.main.cf and sendmail.subsidiary.cf.  With dnamail, there
  59.   are four combinations - main, subsidiary, sub_decnet, and main_decnet.
  60.   Remember to make a symbolic link to the correct file on each machine
  61.   (see the Sun system administrators manual).
  62.  
  63.   'diff' output is included in this distribution showing the changes to
  64.   be made to the original sendmail.main.cf and sendmail.subsidiary.cf
  65.   so that they will handle DECnet.  If you have not changed your
  66.   original .cf much from the original SMI-3.2 version, then the patches
  67.   may work as is.  If not, then use the patches and the following
  68.   instructions as a guide.  Even if patch works, you still need
  69.   to read these instructions (two other files need changing).
  70.  
  71.   Briefly - use patch to create new version of the .cf files.  Then for
  72.   every Sun that runs DNI, uncomment the 'DSdnahost' line for it (use
  73.   a private copy!).
  74.  
  75.   REMEMBER:  Make backups of the original .cf files!!  It also helps
  76.              to comment each of the lines you changed.
  77.  
  78.   Here are the basic changes.  Anything that looks like multiple spaces
  79.   should actually be a tab.
  80.  
  81.   - in /etc/hosts, add 'dnahost' as an alternate name for the machine
  82.     you want to be the DECnet relay.  For example, my site has:
  83.  
  84.     192.9.200.1    nova dnahost
  85.  
  86.     If you have more than one machine running Sunlink/DNI, then pick
  87.     one machine to be the relay for machines without Sunlink/DNI.
  88.  
  89.   - Edit a file called "/usr/sunlink/dna/dnahosts" to contain a list of
  90.     all VMS/DECnet nodes you want to send mail to, one node per line.
  91.     You do not need to have ALL the VMS machines listed, just the ones
  92.     you want to send mail to (a listed machine can deliver mail to a machine
  93.     that you didn't list).
  94.  
  95.   - Add the following lines somewhere near the beginning of sendmail.main.cf
  96.     and sendmail.subsidiary.cf.
  97.  
  98.     # Major decnet relay (relayed by #ether)
  99.     DSdnahost
  100.     # get list of decnet machines we want to be able to send mail to
  101.     FS/usr/sunlink/dna/dnahosts
  102.  
  103.     The DS line defines a macro, $S, to be the name of the machine that will
  104.     actually connect to DECnet.  Any machine that can't handle DECnet mail
  105.     will forward any DECnet mail to this machine to handle it instead.
  106.     If all your machines are on DECnet, then you don't need to do this.
  107.     If you already have a $S macro (search for ^DS in vi), then choose an
  108.     unused macro instead.
  109.  
  110.     The FS line defines a class, $S, that defines the VMS nodes
  111.     we can send mail to with dnamail.
  112.    
  113.   - Add 'dna' as a trusted user.  Look for the following lines in
  114.     sendmail.main.cf and sendmail.subsidiary.cf:
  115.  
  116.     Troot
  117.     Tdaemon
  118.     Tuucp
  119.  
  120.     and add the following line to these:
  121.  
  122.     Tdna
  123.  
  124.   - In sendmail.main.cf (only), look for the following lines (in ruleset 0):
  125.  
  126.     # resolve UUCP domain
  127.     R<@$-.uucp>:$+        $#uucp    $@$1 $:$2    @host.uucp:...
  128.  
  129.     and add these next lines BEFORE them:
  130.  
  131.         ####################################################
  132.         #  If $S (decnet gateway) is defined, then forward to $S, else
  133.         #  resolve to dna mailer.
  134.         ####################################################
  135.         R$+<@$=S>        $?S $#ether $@$S $:$2!$1 $| $#dna $@$2 $:$1 $.
  136.         R$+<@$=S.uucp>        $?S $#ether $@$S $:$2!$1 $| $#dna $@$2 $:$1 $.
  137.  
  138.     (If you aren't using 'S' as the macro for 'dnahost', then subsitute
  139.     in the macro letter you are using).
  140.  
  141.   - In sendmail.subsidiary.cf (only), look for the following lines
  142.     (in ruleset 0):
  143.  
  144.         # optimize names of known ethernet hosts
  145.         R$*<@$*$%y.LOCAL>$*    $#ether $@$3 $:$1<@$2$3>$4    user@host.here
  146.  
  147.     and add these next lines BEFORE them:
  148.  
  149.         ####################################################
  150.         #  If $S (decnet gateway) is defined, then forward to $S, else
  151.         #  resolve to dna mailer.
  152.         ####################################################
  153.         R$+<@$=S>        $?S $#ether $@$S $:$2!$1 $| $#dna $@$2 $:$1 $.
  154.         R$+<@$=S.uucp>        $?S $#ether $@$S $:$2!$1 $| $#dna $@$2 $:$1 $.
  155.  
  156.     (If you aren't using 'S' as the macro for 'dnahost', then subsitute
  157.     in the macro letter you are using).
  158.  
  159.   - Add the following lines to sendmail.main.cf and sendmail.subsidiary.cf
  160.     (at the end of the file, or grouped with the other mailer definitions):
  161.  
  162.     ############################################################
  163.     ############################################################
  164.     #####
  165.     #####        DECnet Mailer specification
  166.     #####
  167.     #####    Messages processed by this configuration are assumed to leave
  168.     #####   the internet domain.  Hence, they may not necessarily correspond
  169.     #####    to RFC822 in all details.
  170.     #####
  171.     ############################################################
  172.     ############################################################
  173.  
  174.     Mdna,    P=/usr/sunlink/dna/dnamail, F=mnSF, S=14, R=24,
  175.         A=dnamail -f $f -n $h $u
  176.  
  177.     S14
  178.     # none needed
  179.     S24
  180.     # none needed
  181.  
  182.   - Now copy sendmail.main.cf to sendmail.main_decnet.cf.  Also copy
  183.     sendmail.subsidiary.cf to sendmail.sub_decnet.cf.  Edit both of
  184.     these new files and change the following line:
  185.  
  186.     DSdnahost
  187.  
  188.     to:
  189.  
  190.     # DSdnahost
  191.  
  192.     (this comments the line out).  This one line should be the only change.
  193.     Now for each machine that is a valid DECnet node, make a link from
  194.     sendmail.cf (in /private/usr/lib for standard installations) to
  195.     sendmail.main_decnet.cf or sendmail.sub_decnet.cf.  Depending upon
  196.     whether the machine is a main mail machine or not, use one of the
  197.     following commands:
  198.  
  199.     ln -s /usr/lib/sendmail.main_decnet.cf /private/usr/lib/sendmail.cf
  200.     or
  201.     ln -s /usr/lib/sendmail.sub_decnet.cf /private/usr/lib/sendmail.cf
  202.  
  203.   That's it!! After making the changes, you need to restart sendmail.
  204.   Since sendmail does not have the capability of 're-reading' the 
  205.   configuration file, you will have to stop the currently running
  206.   sendmail, and then run it again (as root) with the same parameters
  207.   as the old invocation (usually, /usr/lib/sendmail -bd -q1h).
  208.  
  209. 4) Usage
  210.  
  211.   If the installation has gone smoothly, everything should
  212.   be nearly transparent to users.
  213.  
  214.   To send mail from Sun to VAX, use an address like:
  215.  
  216.     vmsnode!user
  217.  
  218.   To send mail fromt VAX to Sun, use an address like:
  219.  
  220.     SUNNODE::"user"
  221.  
  222.   The quotes (") are necessary so that VMS mail does not convert
  223.   everything to uppercase.  Longer addresses are just as easy:
  224.  
  225.     SUNNODE::"node1!node2!..."
  226.  
  227.   (In this case, leaving off the quotes causes the '!' to be treated as
  228.   comment characters).  To set mail to be forwarded from the vax, you will
  229.   have to use 3 quotes instead of one:
  230.  
  231.     SET FORWARD SOMESUN::"""someuser"""
  232.