home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2636 / INSTALL < prev    next >
Encoding:
Text File  |  1991-01-31  |  7.3 KB  |  217 lines
  1. -:ts=8------------------------------------------------------------------------
  2. $Id: INSTALL,v 1.1 91/01/26 15:36:52 mj Exp $
  3. ------------------------------------------------------------------------------
  4.  
  5.                             F  I  D  O  G  A  T  E
  6.                                      ----
  7.                         Gateway Software UNIX <-> FIDO
  8.  
  9.  
  10.                           Installation Instructions
  11.  
  12. ------------------------------------------------------------------------------
  13.  
  14. 1. Edit `config.h'
  15.  
  16.     FIDONET addresses
  17.      o Your system:
  18.         Change the REAL_{ZONE,REGION,NET,NODE,POINT} defines to your
  19.         real FIDONET address, e.g. 2:242/6.1.
  20.         Chnage the MY_{ZONE,REGION,NET,NODE,POINT} defines to your
  21.         fake address, if you're a point system, e.g. 2:6000/1. Must
  22.         be the same as REAL_* for a FIDO node.
  23.         Define MY_NAME as the name of your FIDO system (max. 19 chars).
  24.      o Other systems:
  25.             Change the REM_{ZONE,REGION,NET,NODE,POINT} defines to the
  26.             FIDONET address, where mail packets are send to (Default for
  27.             fpack). Put bossnode here for point systems.
  28.             Define ECHOFEED_{NET,NODE} as the address of your FIDO
  29.             EchoMail feed, i.e. bossnode for point systems.
  30.  
  31.     UNIX addresses
  32.      o Your system:
  33.         Define MY_HOSTNAME as the UNIX hostname of your system.
  34.         (Same as UUCP hostname)
  35.         Define MY_DOMAIN as the address domain of your system, e.g.
  36.         ".uucp".
  37.      o Other systems:
  38.         Change UUCPFEED to the name of the UUCP system you want mail
  39.         to be routed to. Change UUCPFEED_DOMAIN to the domain of this
  40.         system. (Both definitions are used by the rmail replacement.)
  41.      o FIDO domain:
  42.         Change FIDODOMAIN to the domain you want to use for FIDO
  43.         domain addresses. (".fidonet.org" is the standard)
  44.  
  45.     Directories:
  46.         Edit the defines of spool and lib directories to meet your
  47.         taste, e.g. replace "/u/spool/fidonet" with "/usr/spool/fido"
  48.         or whatever you want. (SPOOL ... AREAS)
  49.  
  50.     Mail/News programs:
  51.         Change RFMAIL to the full path of the FIDOGATE rfmail program,
  52.         normally "LIBDIR/rfmail".
  53.         Change RNEWS to the full path of the news receiver, normally
  54.         "/usr/bin/rnews".
  55.         Change RMAIL to the full path of the mail receiver, normally
  56.         "/usr/bin/rmail" or "/bin/rmail". (This may be the installed
  57.         replacement)
  58.         If you want to install the rmail replacement, change RECVMAIL
  59.         to the full path of the real mail receiver, normally
  60.         "/usr/bin/ormail" (the renamed original rmail) or
  61.         "/usr/lib/mail/execmail" for XENIX (done automatically in
  62.         rmail.c).
  63.         Define RETURN_FAILED_MAIL if you want rfmail to return
  64.         undeliverable FIDO mail.
  65.  
  66.     System dependencies:
  67.         Define USG if you're running a System V UNIX, or BSD if you're
  68.         UNIX is more BSDish. (BSD not tested yet.)
  69.         Define LOCK_LOCKF if file locking is done via the lockf() call,
  70.         else locking() will be used.    
  71.  
  72.     The following defines are parameters for fcall, leave them alone!
  73.  
  74.  
  75.  
  76. 2. Edit `Makefile'
  77.  
  78.     Directories:
  79.         Change NEWSBINDIR to the directory, where the inews related
  80.         programs are found (CNews' anne.jones etc.). Used for the
  81.         installation of msgidseq.
  82.         Change LIBDIR to the directory, where you want to put the
  83.         FIDOGATE executables.
  84.         Change SPOOLDIR to the top level spool directory. (Must be
  85.         the same as in config.h!)
  86.         Change RMAILDIR to the directory, where rmail is to be found
  87.         (normally "/usr/bin").
  88.  
  89.     Owner/Group:
  90.         Change OWNER/GROUP to the user/group id for the FIDOGATE
  91.         directories and files. (Normally `news')
  92.  
  93.     Compiler:
  94.         Change CC to your C compiler (or comment it out).
  95.         Change CFLAGS and LDFLAGS to the compilation/linking
  96.         flags (e.g. `-g' for debug information).
  97.         Change LIBS to the libraries to link with. (e.g. XENIX
  98.         needs -lx)
  99.  
  100.  
  101.  
  102. 3. Edit `frecv'
  103.  
  104.     Change the define of SPOOL and the address matching patterns to
  105.     be sufficient for your system. SPOOL must be the same as in
  106.     config.h and Makefile.
  107.  
  108.  
  109.  
  110. 4. Here we go ...
  111.  
  112.     Main installation:
  113.         Compile the beast by entering
  114.             make
  115.         If everything works, you can continue the installation. Log in
  116.         as super user and enter
  117.             make install.dirs
  118.         This will create the necessary working directories for the
  119.         FIDOGATE software. Now type
  120.             make install
  121.         to copy the programs to the appropiate directories.
  122.  
  123.     rmail installation:
  124.         Type
  125.             make install.rmail
  126.         to install the replacement for rmail. This will move the
  127.         original version of rmail to `ormail' and install the
  128.         replacement as the systems rmail command.
  129.  
  130.     msgidseq installation:
  131.         Type
  132.             make install.msgidseq
  133.         to install the message id number sequencer in the news
  134.         inject directory. This program will enable the FIDOGATE
  135.         software to use the RFC `Message-Id:' in FIDO `^AMSGID'
  136.         kludges. You also must edit `anne.jones' (CNews) or
  137.         similar to use msgidseq for id generation:
  138.  
  139. *** /u/lib/newsbin/inject/anne.jones.ori    Sat Aug 18 15:51:02 1990
  140. --- /u/lib/newsbin/inject/anne.jones    Sat Aug 18 16:06:44 1990
  141. ***************
  142. *** 117,120 ****
  143.   defpath="$badsites$USER" \
  144.   deffrom="$FROM" deforg="$deforg" \
  145.   defdate="` set $date; echo $1, $3 $2 \` echo $6 | sed 's/^..//' \` $4 $5`" \
  146. ! defmsgid="`set $date; echo \<$6$2$3.\`  echo $4 | tr -d : \`.$$@$host\>`" -
  147. --- 117,124 ----
  148.   defpath="$badsites$USER" \
  149.   deffrom="$FROM" deforg="$deforg" \
  150.   defdate="` set $date; echo $1, $3 $2 \` echo $6 | sed 's/^..//' \` $4 $5`" \
  151. ! defmsgid="`echo \<\`msgidseq\`@$host\>`" -
  152. ! #
  153. ! # defmsgid changed for FIDO gateway software
  154. ! # Original version:
  155. ! # defmsgid="`set $date; echo \<$6$2$3.\`  echo $4 | tr -d : \`.$$@$host\>`" -
  156.  
  157.  
  158.  
  159. 5. News forwarding
  160.  
  161.     Put something similar to
  162.  
  163. # export to fidonet
  164. f1.n6000.z2.fidonet.org:all/fidonet::/u/lib/fidonet/rfmail -n
  165.  
  166.     in your news `sys' file (CNews) to forward locally created postings
  167.     to the FIDONET receiver rfmail. The FIDONET address must be identical
  168.     to the one generated by funpack in the `Path' header.
  169.  
  170.  
  171.  
  172. 6. Areas/Alias
  173.  
  174.     Edit the file Areas for the newsgroup <-> EchoMail area conversion,
  175.     change the entries for your favorite newsgroups/areas and distribution.
  176.     Also edit the file Alias, which is used for conversion between
  177.     UNIX user names and FIDO real names.
  178.     If done, copy these files to the FIDOGATE lib directory (e.g.
  179.     "/u/lib/fidonet".
  180.  
  181.  
  182.  
  183. 7. Testing
  184.  
  185.     Copy a FIDO mail packet addressed to your system into the directory
  186.     SPOOL/in, then execute LIBDIR/funpack as user news. You should get
  187.     the unpacked messages in SPOOL/unpacked: M.* for mail and N.* for
  188.     news. Execute LIBDIR/frecv to feed them to rmail or rnews.
  189.     
  190.     Post a message to a FIDO linked newsgroup. You should find the
  191.     FIDO message in directory SPOOL as M.*. Execute fpack as user news
  192.     to create a FIDO mail packet in SPOOL/out.
  193.  
  194.  
  195.  
  196. 8. Connecting with FIDO
  197.  
  198.     At the current state, FIDOGATE isn't able to act as a mailer, so
  199.     you have to transfer FIDO mail to and from the UNIX system by some
  200.     other means.
  201.     
  202.     The solution I'm using is a seperate PC running DOS and BinkleyTerm
  203.     as a mailer. Currently the PC is a real FIDO node, online 24 hours
  204.     a day, but in former times I've used it in a dual point setup. FIDO
  205.     mail packets for the UNIX system are packed at the PC and transferred
  206.     via a direct serial line to and from the UNIX machine. This is done
  207.     on a time schedule driven by BinkleyTerm.
  208.  
  209.  
  210.  
  211. $Date: 91/01/26 15:36:52 $, Martin Junius
  212. --
  213.  _____ _____
  214. |     |___  |   Martin Junius     FIDO:    2:242/6.1   2:242/6.0
  215. | | | |   | |   Republikplatz 3   DOMAIN:  mju@dfv.rwth-aachen.de
  216. |_|_|_|_____|   D-5100 Aachen     Tel. (Voice) 0241-86931
  217.