home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / maillist / !MailList_Docs_Install < prev    next >
Encoding:
Text File  |  1995-04-23  |  8.5 KB  |  224 lines
  1. Installing !MailList
  2. ====================
  3.  
  4. Upgrading from v0.09 or earlier
  5. -----------------------------
  6.  
  7. When installing from v0.09 you can simply remove the old application and
  8. replace it with the application in this archive. The application should then
  9. run without problems. There is no need to UNREGISTER your previous version
  10. if you have already REGISTERED it with v0.06 or later . If you have not yet
  11. REGISTERED your robot then follow the instructions at the end of this file.
  12.  
  13.    You do NOT need to use the !UnInstall feature .
  14.           ^^^
  15. After installing you should send a new QUOTA request from your root-account
  16. as the information may have gotten lost. This was fixed in v0.10.
  17.  
  18. The rest of the document describes installation of MailList from scratch.
  19.  
  20. Upgrading from versions v0.10, v0.10a [with(out) FCO #001, FCO #002]
  21. --------------------------------------------------------------------
  22.  
  23. You are very strongly urged to upgrade your copy of Newsbase to version 0.54
  24. or later. Earlier versions of Newsbase may not work correctly with this
  25. version of MailList. MailList v0.11 requires at least NewsBase v0.54
  26.  
  27. Upgrading from v0.11, v0.11a~c
  28. ------------------------------
  29.  
  30. No special actions ned to be taken.
  31.  
  32. New Installation
  33. ----------------
  34.  
  35. If a user 'maillist' exists you have to delete this user first! MailList
  36. uses this username for it's Robots. MailList uses the existance of the user
  37. 'maillist' to flag the installation of MailList. If the user exists MailList
  38. assumes it has already installed itself on your system.
  39.  
  40. In this manual I assume that you are familiar with the operation and control
  41. of the RiscOS desktop and that you have some basic knowledge of how to send
  42. and receive e-mail via the InterNet.
  43.  
  44. What does MailList offer?
  45. -------------------------
  46.  
  47. MailList offers three basic services:
  48.  
  49. o Management of mailing-lists.
  50.         The idea was taken from LISTSERV for BITNET, ListProcessor for UN*X
  51.         and MajorDomo (Perl), to write an application that could allow you
  52.         to manage mailing-lists under the RiscOS desktop. Provided ofcourse
  53.         that your Archimedes is a node on the InterNet (via UUCP or TCP/IP)
  54.  
  55. o A simple mail-server.
  56.         As a spin-off of the mailing-list I decided to also integrate a
  57.         simple mail-server robot into MailList. The mail-server robot is a
  58.         separate service from the mailing-list. You don't need to create any
  59.         mailing-lists to be a mail-server site and vice versa. MailList
  60.         handles both separately.
  61.  
  62. o A simple scheduler.
  63.         Mail and news articles can be scheduled to be sent out at a give
  64.         date and interval. This is useful for regular postings (FAQ) or
  65.         birthday greetings, etc.
  66.  
  67. What do you need?
  68. -----------------
  69.  
  70. For MailList to run you need: 
  71.  
  72. o An Acorn RISC computer (Archimedes or RiscPC) connected to the Internet.
  73.   This can be via a modem (SLIP, PPP, UUCP) or a TCP/IP card. Provided that
  74.   NewsBase knows how to deal with the transport.
  75.  
  76. NOTE: If you are using UUCP-transport you are strongly advised to configure
  77.       it to use 'smail'! 'sendmail' behaves somewhat erratic at times. And
  78.       don't ask ME how to do this!
  79.  
  80. o 160kB of memory for MailList to run in. 
  81.  
  82. o !NewsBase v0.53 or later 
  83.  
  84. o A news/mail reader. Preferably !TTFN v0.36 or later
  85.  
  86. o !NewsDir. This is required by NewsBase so you probably have it already.
  87.  
  88. o A LARGE harddisc ;-)
  89.  
  90. o Subscribe yourself to the mailing-list about MailList by sending e-mail
  91.   To:      maillist@cray-3.xs4all.nl
  92.   Subject: SIGNON MAILLIST-L
  93.   Leave the body of the message empty as it will be ignored by the robot.
  94.   'maillist-l' is a mailing-list which is used for the discussion of bugs,
  95.   new features, problems, questions etc. of MailList.
  96.  
  97.  
  98. Installing
  99. ----------
  100.  
  101. Copy !MailList to a convenient spot on your harddisc. Preferably in the same
  102. directory where you keep !NewsBase, !TTFN and !NewsDir.
  103.  
  104. If you are going to use the mail-server option, then you should also edit
  105. the !Run file and change the definition of the variable
  106. <MailList$MailServerDir> to a sensible path for your machine. 
  107.  
  108. Double-click on the !MailList icon and watch MailList install itself
  109. automagically.
  110.  
  111. Do you have "Username access control" enabled in the "Configure users"
  112. setup of NewsBase? If so, you will have to change the 'Group no' of the
  113. user maillist to 0. Otherwise, MailList won't be able to read mail from it's
  114. mailing-lists. You have to do this manually for security reasons on your
  115. part. 
  116.  
  117. That's all there is to it.
  118.  
  119.  
  120. Conventions
  121. -----------
  122.  
  123. In the text below when I use <host> or <user> I mean the following:
  124.  
  125. An address on Internet should be RFC-822 compliant and looks something like
  126. this:
  127.  
  128.         someone@machine.subdomain.domain
  129.  
  130. With <host> I mean the right part of your host's Internet address. In our
  131. example:
  132.  
  133.         <host> stands for   machine.subdomain.domain
  134.         <user> stands for   someone
  135.  
  136. In the text <host> stands for the hostname of YOUR machine on which
  137. MailList is running.
  138.  
  139. MailList assumes you have a <user> called 'root' defined on your machine.
  140.  
  141. With 'host-owner' I mean you. Assuming that you own/maintain the machine on
  142. which MailList is running.
  143.  
  144. With 'list-owner' I mean the person who maintains the mailing-list. This is
  145. usually the same person as the host-owner. But it is possible that someone
  146. else is the list-owner. It is not even neccessary that the list-owner has a
  147. mailbox on the <host>. A list-owner of a list on your <host> can be living
  148. on the other side of the world. To MailList that doesn't matter.
  149.  
  150. With 'subscriber' I mean any person who is subscribed to the mailing-list.
  151.  
  152.  
  153. How to make MailList do something
  154. ---------------------------------
  155.  
  156. When MailList is running you may notice that it has no user-interface. There
  157. are no apparent configuration options. The menu only has the standard Info
  158. and Quit items. So how *do* you tell MailList what it should do?
  159.  
  160. Well, being a mailing-list robot MailList is controlled entirely by sending
  161. it e-mail. When MailList installed itself on your system, it created a new
  162. user called 'maillist'. By sending e-mail to this user you can talk to
  163. MailList. The e-mail sent to maillist@<host> is called a 'request'. The
  164. Subject:-field of the e-mail message is used to convey the request to
  165. MailList. MailList will usually ignore the rest of the message unless
  166. specified explicitly in the documentation.
  167.  
  168. Requests are subdivided into 4 groups:
  169.  
  170. o Requests for host-owners
  171.         MailList recognizes a host-owner as the person who can send mail
  172.         from the address root@<host>, The socalled root-account on your
  173.         <host>. Since the owner/maintainer of the machine (you) is usually
  174.         the only person who can send mail from that address, this is a safe
  175.         assumption.
  176.  
  177. o Requests for list-owners
  178.         You, the host-owner, will have to tell MailList the
  179.         list-owner's Internet-address of the newly created mailing-list.
  180.         Mail received from that address will from then on be seen as mail
  181.         from the list-owner.
  182.  
  183. o Requests for subscribers
  184.  
  185. o Requests for me :-)
  186.         To keep all MailList Robots up-to-date on what is going on elsewhere
  187.         in the world, I have added a class of requests that allow me and the
  188.         Robots to talk to oneanother. These requests can only be generated
  189.         from <maillist@cray-3.xs4all.nl>. Read the file 'CyberTalk' for more
  190.         info.
  191.  
  192. To get an overview of all the requests that are accepted by this version of
  193. MailList send e-mail to maillist@<host> and give it the Subject: HELP
  194.  
  195. Requests are case-insensitive. In this manual requests are in capitals.
  196.  
  197.  
  198.  
  199. To Batch Or Not To Batch
  200. ------------------------
  201.  
  202. If memory on your machine is tight (eg. 2MB) you may notice that MailList,
  203. NewsBase and TTFN cannot run simultaneously. The best solution then is to
  204. install more memory. However, if this is not an option you can use !Alarm to
  205. start MailList on a given time. Send the request SET BATCH to
  206. maillist@<host> to make MailList process it's jobs in batches. Sending the
  207. request SET NOBATCH will make MailList a 'normal' multitasking application.
  208.  
  209. When MailList is configured to BATCH it will process all outstanding
  210. requests and mail queued for it's mailing-lists and then quit until it is
  211. started again.
  212.  
  213.  
  214. After installation
  215. ------------------
  216.  
  217. After MailList has installed itself you may want to send *your* MailList
  218. Robot (maillist@<host>) the request REGISTER. This registers your host as a
  219. user of !MailList. There are no financial consequences involved in this.
  220. Registering your host will enable you to get new updates of the software
  221. quicker. And perhaps even automatically without (or with minimum)
  222. intervention.
  223.  
  224.