home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume9 / elm2 / part03 / Instructions next >
Text File  |  1987-03-08  |  5KB  |  133 lines
  1.  
  2.                 Instructions
  3.                 ------------
  4.  
  5.             Last Update: July 17th, 1986
  6.  
  7.  
  8.     This file contains instructions on how to create and install
  9. the entire ELM mail system.  It should be read BEFORE any attempts
  10. are made at actually creating and/or installing any of the software
  11. contained herein!
  12.  
  13.     There is actually really one step needed - unpack all the shar
  14. files and then;
  15.  
  16.     $ cd <where-ever you're keeping the Elm sources>
  17.  
  18.     $ sh Configure.sh
  19.  
  20.     Answer the questions of that program,, then let it create the localized
  21. Makefiles and system definition files for you.  When it's done you can double
  22. check the configuration (or customize it further) by reading the Configuration
  23. Guide + editing the file "hdrs/sysdefs.h".  There are lots of neat features
  24. that are unique to this mailer - it's worth a quick perusal at least!
  25.  
  26.     Once you're happy with the localized files, you then need to create
  27. the documentation (so there's a bit of a catch-22 that you need to format the
  28. Configuration guide before you are happy with the localization but can't do
  29. that until you're happy with the localization...oh well).
  30.  
  31.     $
  32.  
  33.     $ make documentation
  34.  
  35.     When that's done, or even if it fails (don't worry too much about it)
  36.  
  37.     $ (make -i all >& MAKELOG) &
  38.     $ tail -f MAKELOG
  39.  
  40.     (if you're in "sh", you can use "> MAKELOG 2>&1" instead of ">& MAKELOG")
  41.  
  42. This will take a fair while, so it's recommended that you go and eat 
  43. lunch or play a game for a while!! (alternatively, spend lots of money
  44. on a really FAST machine and blink your eyes a few times...)
  45.  
  46. Assuming there are no errors during compilation (we'll have to assume
  47. that for the moment) you should now be able to list the directory "bin"
  48. and find the following files:
  49.  
  50.     "answer", "arepdaemon", "autoreply", "fastmail", "from", 
  51.     "elm", "newalias", "newmail", "printmail", and "readmsg".
  52.  
  53. next, you can install all the software on your system by;
  54.  
  55.     $ make -i install
  56.     
  57. Note: the mailer runs as setgid mail to have the ability to WRITE
  58. to the /usr/mail directory (for lock files).   If you have a different
  59. scheme at your site, feel free to set it up to use that instead.
  60.  
  61. Finally, we're just about done!   The final checks can be made
  62. by the following commands:
  63.  
  64.     $ /usr/local/bin/elm -z
  65.  
  66. should say "no mail" if nothing's in your incoming mailbox, and
  67.  
  68.     $ /usr/local/bin/elm -f test/test.mail
  69.  
  70. should read in EIGHT messages from various people.  While here, try to
  71. A)lias C)urrent message for each of the eight messages to confirm that
  72. the reply/address system is working okay.   Now try to C)hange mailboxes
  73. to the file "test/test.note" and use the '%' key to see if the mailer is
  74. generating valid return addresses for the notes (If not, then you might
  75. need to install the pathalias database - see "sysdefs.h" for more info)
  76. Change back to "test/test.mail" and Q)uit without having marked anything 
  77. for deletion...answer the questions accordingly.
  78.  
  79. If you get this far you're in Wonderful shape!  In fact, you're done!
  80.  
  81. Congratulations!  You've just installed one of the best electronic mail
  82. systems available today on your machine (if I say so myself!)
  83.  
  84. HANDY HINTS:  If you want to create a print of the entire set of
  85. sources, including this file, use the command:
  86.  
  87.     $ make listing
  88.  
  89. If, on the other hand, you just want to create a listing file of 
  90. just the ELM sources, try:
  91.  
  92.     $ make elm-listing
  93.  
  94. Also, if you have a number of machines on a network, you can rlogin
  95. to the remote machine and then do a remote install (after checking
  96. to ensure that the networking copy method in the Makefile under the
  97. target "remote-install" is correct) by typing:
  98.  
  99.     $ make -f <remote Makefile> REMOTE=<remote file system> rmt-install
  100.  
  101. (for example, if we had installed the system on machine "machx" and 
  102.  wanted to install it on "machy", with the Makefile in /src/Elm on
  103.  "machx", we could type from "machy";
  104.      $ make -f machx:/src/Elm/Makefile REMOTE=machx: rmt-install
  105.  to have it install the system on machine y!)
  106.  
  107. One final note for non-US distribution - the program might complain
  108. at link time that it can't find "crypt()".  If so, and if you cannot
  109. obtain a copy, you should merely instruct your users to not use the
  110. encrypted mail option on outgoing mail.
  111.  
  112. That's it!
  113. ----------
  114.  
  115. Oh!  One final note: if you'd like a nicely typeset copy of the documentation,
  116. feel free to drop me a line with your full (overland) mail address!!  I'll
  117. try to get it back to you within a week or two.
  118.  
  119. -----------
  120.  
  121.     Author's address:    taylor@HPLABS
  122.                 hplabs!taylor
  123.  
  124.     Mail address:        Dave Taylor
  125.                 Hewlett Packard Laboratories
  126.                 1501 Page Mill Road
  127.                 Palo Alto CA
  128.                 94304
  129.  
  130.   This document and the entire mail system is
  131.  
  132.     (C) Copyright 1986, Dave Taylor
  133.