home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume9 / pc-mail-nfs / README < prev    next >
Encoding:
Text File  |  1989-11-26  |  6.4 KB  |  187 lines
  1. @(#) README 1.6 11/19/89 14:00:51
  2.  
  3. This is an extension to the pc-mail package (uucp mail for pc's) that
  4. appeared in comp.sources.misc, april 1988.  It is intended for an
  5. environment where pc-mail users mount their personal mail directories
  6. from a file server.  The programs in the present package run on the file
  7. server.  They directly access the per-user pc-mail directories and thus
  8. replace the UUCP file transfer functions of the pc-mail software.  The
  9. programs were tested with SunOS 4.0.3 and Microport System-V/AT 2.3.
  10. This software is in the public domain.
  11.  
  12. Please report any problems etc.  to the author (Wietse Venema) via one
  13. of the following e-mail addresses:
  14.  
  15.     wswietse@lso.win.tue.nl
  16.     wswietse@heitue5.bitnet
  17.  
  18. The remainder of this document describes the operation of the software,
  19. how to install the software, how to add new users, and how to migrate
  20. users from pc-mail over UUCP to pc-mail over PC-NFS.
  21.  
  22. Operation
  23. =========
  24.  
  25. The UUCP file transfer functions of the pc-mail "cico.exe" program are
  26. taken over by the following two programs that run on the file server:
  27.  
  28. pc-mail:    deliver mail to a user's mail directory (the receiving
  29.         function of the "cico.exe" program). This program is 
  30.         intended to be called by sendmail.
  31.  
  32. pc-maild:    scan user mail directories for unsent mail, and pipe it 
  33.         through the UNIX rmail command (the sending function of 
  34.         the "cico.exe" program).
  35.  
  36. Installation on the server
  37. ==========================
  38.  
  39. Build the pc-mail and pc-maild programs. In the Makefile, you can
  40. define the location of the executable programs and the pc-mail spool
  41. area, and how often the daemon program will scan user directories for
  42. unsent mail. You will probably have to do `make depend' before you
  43. can compile the programs.
  44.  
  45. Execute the following command to create a pc-mail spool area, and
  46. install the pc-mail and pc-maild programs.  You must be root.
  47.  
  48.     % make install
  49.  
  50. The output from the "make" command will depend on how you specified the
  51. path names in the Makefile:
  52.  
  53.     mkdir /var/spool/pc-mail
  54.     chmod 755 /var/spool/pc-mail
  55.     cp pc-mail pc-maild /usr/local/lib
  56.     chown root /usr/local/lib/pc-mail
  57.     chmod u+s /usr/local/lib/pc-mail
  58.  
  59. Execute the following command to install the manual pages, if you want
  60. to. 
  61.  
  62.     % make installman
  63.  
  64. Again, output from make will depend on what you specified in the
  65. Makefile:
  66.  
  67.     cp pc-mail.8 pc-maild.8 /usr/local/man/man8
  68.  
  69. Add a line with the command
  70.  
  71.     /usr/local/lib/pc-maild
  72.  
  73. to the file /etc/rc.local (the exact name of the rc script depends on
  74. your version of unix, and the exact path name of the pc-maild program
  75. depends on where you installed it).
  76.  
  77. For now, you will have to start the pc-maild program by hand (unless
  78. you wish to reboot the machine).
  79.  
  80. Add to the sendmail.cf file a line that looks like:
  81.  
  82.     Mpc,    P=/usr/local/lib/pc-mail, F=lsDFMn, S=xxx, R=yyy, A=pc-mail $u
  83.  
  84. Where xxx and yyy may be the same rewriting rules as used for the local
  85. mailer (usually defined with the "Mlocal" line).
  86.  
  87. In sendmail.cf, at the end of ruleset S0, just before the local mailer
  88. will be invoked (something like "R$*    $#local $:$1"), add a line with
  89.  
  90.     R $=X            $#pc $:$1
  91.  
  92. Use a different letter if X is already in use.  A later section
  93. describes how to convince sendmail that X is a list of login names of
  94. pc-mail users.
  95.  
  96. Adding users (server side)
  97. ==========================
  98.  
  99. Add the user to the password data base.  In the spool area on the
  100. server, create a subdirectory for the pc-mail user.  The directory must
  101. be owned by that user; for reasons of privacy, mode 0700 is recommended.
  102. In the following example, replace username by the actual login name of
  103. the user.
  104.  
  105.     % mkdir /var/spool/pc-mail/username
  106.     % chown username /var/spool/pc-mail/username
  107.     % chmod 700 /var/spool/pc-mail/username
  108.  
  109. Adding users (pc side)
  110. ======================
  111.  
  112. On the pc, adjust the AUTOEXEC.BAT, NETWORK.BAT or DRIVES.BAT files so
  113. that they contain the following commands (replacing server by the name
  114. of the NFS server host, and replacing username by the login name of the
  115. actual user):
  116.  
  117.     net name username *
  118.     net use m: \\server\var\spool\pc-mail\username
  119.     set MAILDIR=m:\
  120.  
  121. The trailing \ is needed on the last command, or the mail program will
  122. complain that it "cannot access some essential data files".
  123.  
  124. If the user had a UUCP-based pc-mail link, you can now remove the -p
  125. option from any CMAIL commands that may appear in batch files.
  126.  
  127. Reboot the pc.
  128.  
  129. If the user had a UUCP-based pc-mail link, copy the contents of the
  130. user's LOCAL mail directory to the REMOTE mail directory on the file
  131. server.  From now on the local mail directory will no longer be needed.
  132.  
  133. Test if the mail program works by creating a small mail message. Since
  134. the message will automatically be picked up by the pc-maild program the
  135. files may disappear before you had a chance to type a DIR command!
  136.  
  137. Adding users (server side again)
  138. ================================
  139.  
  140. Add the user to the list of NFS pc-mail users.  There are two ways to
  141. accomplish the same result. The list of users can be hardcoded in the
  142. sendmail.cf file, e.g.:
  143.  
  144.     CXjohn marsha
  145.  
  146. Multiple usernames on a line, and multiple CX lines are allowed.  A
  147. better way is to have sendmail read the list from an external file,
  148. by putting the following line into the sendmail.cf file:
  149.  
  150.     FX/etc/pc-mail-users %s
  151.  
  152. The /etc/pc-mail-users file should contain only a single login name per
  153. line.
  154.  
  155. Kill the sendmail daemon and restart it.
  156.  
  157. If the user had a UUCP-based pc-mail connection, you can now get rid of
  158. aliases that were needed for UUCP support.
  159.  
  160. Note that the sendmail ON THE NFS SERVER will not read the user's
  161. .forward file.  The file will still be useful, however, if the user's
  162. home directory is exported to OTHER hosts running sendmail.  In that
  163. case you will want to create a .forward file in the user's home
  164. directory containing
  165.  
  166.     username@fully-qualified-hostname
  167.  
  168. Adding users (pc side again)
  169. ============================
  170.  
  171. This step can be skipped if the user had no UUCP-based pc-mail connection.
  172.  
  173. If the user used to have a UUCP connection, pick up any mail that still
  174. resides in the UUCP spool area on the file server (the mail will now be
  175. stored in the user's private remote mail directory through the miracles
  176. of NFS). 
  177.  
  178. At this point the cico.exe program has become obsolete. You may consider
  179. to replace it by a small C program that does nothing.
  180.  
  181. Adding users (server side again)
  182. ================================
  183.  
  184. This step can be skipped if the user had no UUCP-based pc-mail connection.
  185.  
  186. The user's uucp login can be removed from the password file.
  187.