home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / tulp-3.0.3 / part01 / INSTALL < prev    next >
Text File  |  1993-04-15  |  7KB  |  183 lines
  1.                      The Unix Listserv Program
  2.                           Version 3.0.0
  3.                  Installation and Operations Guide
  4.  
  5.      Copyright (C) 1991,1992  Kimmo Suominen, Christophe Wolfhugel
  6.  
  7. 1) Installation / Customization
  8.  
  9. - Create a user named "listserv" on your system, preferably in its own
  10.   group (this makes it easier to give access to maintenance users).
  11.   You may of course choose another user if you wish.
  12.  
  13.   The user should *not* have any special privileges. It is *not* an
  14.   administrative user.
  15.  
  16.   You may wish to disable logins on that account, and allow access
  17.   only with rlogin (to avoid having a shared password).
  18.  
  19.   It is also a nice idea to put listserv's home directory on a stable
  20.   file system, ie. where there are few risks of running out of space.
  21.   In the current release, TULP gives an undefined (which could be
  22.   mail loops, but we did not test this) behavior if the file system it's
  23.   running on is full. Do not put the directory on a file system
  24.   which is vital for the system.
  25.  
  26.   Create the directory expl in listserv's home directory. If you
  27.   prefer using another organization, you'll have to change the
  28.   adequate defines in conf.h and Makefile.
  29.  
  30.   TULP's binaries and scripts will be put in /usr/local/etc, all
  31.   service files will be in ~/expl and we suggest that you put
  32.   the sources in ~/src.
  33.  
  34. - Login as root and create some mail aliases (described method
  35.   is for Sendmail). Aliases are generally stored in /usr/lib/aliases
  36.   or /etc/aliases, some sites may have another location, anyway the
  37.   system administrator should know about it.
  38.  
  39.   You must create 3 service aliases:
  40.      listman:          address of the listserv manager (you!)
  41.      listserv-request: listman
  42.      list-errors:      where errors should be reported (generally also you).
  43.   These two aliases must of course *not* point to Listserv otherwise you'll
  44.   create a deadly loop.
  45.  
  46.   If you have decided not to use the -request facility in conf.h then
  47.   you do not need the listserv-request alias. It is strongly
  48.   discouraged not to use the -request facility.
  49.  
  50.   Ask your system administrator to add "listserv" to the list of
  51.   trusted users, with Sendmail this will allow listserv to send mail
  52.   while defining the appropriate From envelope. With other MTAs,
  53.   please consult their manuals in order to arrive to the same result.
  54.  
  55.   If you wish to use the test list, also add an alias:
  56.      test:          "|/usr/local/etc/deliver test"
  57.  
  58.   And finally alias listserv to the deliver package:
  59.      listserv:      "|/usr/local/etc/deliver listserv"
  60.  
  61. - Issue a newaliases in order to refresh the database. Also rebuild
  62.   your frozen Sendmail configuration file if any. The Sendmail
  63.   daemon should be restarted in order to be sure that all modifications
  64.   have been taken into account.
  65.  
  66. - You'll now have to edit the configuration file conf.h in order to
  67.   set the parameters according to your system and to your wishes.
  68.  
  69.   Parse this file carefully in order not to miss anything. If in
  70.   future runs you see CPU loops on the Listserv process then maybe
  71.   there is a problem with the signal handling on your system.
  72.   In this case you may wish to define NO_SIGUSR1 in conf.h, you'll
  73.   also need to modify the 'deliver' script in order to have it
  74.   not calling 'kilst' anymore'.
  75.  
  76. - Edit helpfile in order to fill it in with your local adresses.
  77.   You can also add whatever you'd like to. For example, on my
  78.   production version on grasp1.univ-lyon1.fr I have explanations
  79.   on how to retrieve the FAQ archives via the listserv.
  80.  
  81. - Check and modify Makefile according to your system. On AIX 3.1,
  82.   -D_BSD does not need to be added (if you have compilation errors,
  83.   then it's that you have wrong options).
  84.  
  85.   Don't forget to put the proper directories.
  86.  
  87. - Edit and customize 'deliver' and 'rc.tulp' according to your
  88.   system.
  89.  
  90. - Issue 'make all' in order to compile all the stuff.
  91.  
  92. - Once compiled and linked successfully, issue a make 'install'.
  93.   That will copy the executables and scripts to the right place.
  94.  
  95.   Verify that 'kilst' is setuid to listserv (no danger, check the source
  96.   to get the confirmation).
  97.  
  98.  
  99. - Copy helpfile, lists and test.* to ~/expl. If you wish to
  100.   create new lists, refer to the latter comments and also to tulp(5).
  101.  
  102. The installation of TULP in now ready, you can now create your lists
  103. and start the application.
  104.  
  105.  
  106. 2) Running TULP
  107.  
  108. TULP should be started preferably with the /usr/local/etc/rc.tulp
  109. script.
  110.  
  111. The daemon should immediately go into background (except if DEBUG was
  112. defined in the Makefile). You should now have the 'test' list ready
  113. for use with one subscriber: the list-manager (listman).
  114.  
  115. Important eventss are filed to the syslog or to the fakesyslog you have
  116. defined.
  117.  
  118. The world-readable file /usr/local/etc/tulp.pid exists as long as the
  119. listserv is active. It's there to indicate the current pid to the
  120. kilst program.
  121.  
  122. You may wish to create a file listname.n in order to enable the
  123. usage of the X-Sequence: field in the header of the resent messages.
  124.  
  125.  
  126. 3) Listserv shutdown
  127.  
  128. Normal shutdown is obtained when sending kill -15 to the listserv pid.
  129. shutdown generally does not take more than a few seconds, but when
  130. relaying a message it can be much longer.
  131.  
  132.  
  133. 4) Creating a list (delete is reverse operation)
  134.  
  135. Creating a list is easy.
  136.  
  137. - Choose the list name in order to be at most MAX_FILE-2 long (this name
  138.   if called 'listname' for the following text).
  139.  
  140.   In fact it should not be longer than 12 characters as, too bad,
  141.   Posix only requires 14 characters long filenames. If the names
  142.   are longer, you'll be system specific.
  143.  
  144. - Go to ~/expl and create 'listname.w' containing the welcome
  145.   message that will be sent to every new subscriber.
  146.   Create 'listname.u' and put in it any user you wish to subscribe
  147.   immediately (see test.u format), otherwise just 'touch listname.u'.
  148.   The file *must* exist. Create the file listname.n if you wish
  149.   to have Sequence numbers.
  150.   If you wish to have archiving, issue 'mkdir listname'.
  151.   Verify that these files are mode 700.
  152.  
  153.   Customize the header of list.u (see file tulp(5)) according to your
  154.   needs.
  155.  
  156. - The file list.n, if existing contains the number (in text) of the next
  157.   message. If present, the X-Sequence: field will be added to every
  158.   forwarded message.
  159.  
  160. - Edit the file lists and add the new list if you wish to have that list
  161.   appear in the catalog.
  162.  
  163. - Edit (as root) /usr/lib/aliases and alias the new list name to the
  164.   deliver script and refresh the aliases database.
  165.   Also put the -request alias (to a human) if you have choosen
  166.   the adequate compilation option in conf.h.
  167.   Exemple:
  168.         tulp:           "|/usr/local/etc/deliver tulp"
  169.         tulp-request:   listman
  170.  
  171. The new list is ready, you don't need to restart the listserv.
  172.  
  173. Don't forget to subscribe to the new list, specifying address 'listname@host'
  174. as subscriber email.
  175.  
  176.  
  177. 5) Miscellaneous
  178.  
  179. This listserv is used successfully in coordination with C-News in order
  180. to establish a full bi-directionnal gateway between mailing lists and
  181. Usenet newsgroups. This works fine only if listserv if the 'head' of
  182. the gatewayed list/group.
  183.