home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3411 / INSTALL < prev    next >
Encoding:
Text File  |  1991-05-25  |  8.1 KB  |  244 lines
  1. -:ts=8------------------------------------------------------------------------
  2. $Id: INSTALL,v 1.2 91/05/22 22:13:21 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.        REAL_ZONE, REAL_REGION, REAL_NET, REAL_NODE, REAL_POINT
  19.        Your _real_ FIDO address
  20.        MY_ZONE, MY_REGION, MY_NET, MY_NODE, MY_POINT
  21.        Your fakenet FIDO address, if any. This is used for point
  22.        systems, e.g. 2:242/6.1's fakenet address is 2:6000/1.
  23.        Same as REAL_* for FIDO nodes.
  24.        MY_NAME
  25.        FIDO system name. (max 19 chars)
  26.     o Other systems:
  27.        REM_ZONE, REM_REGION, REM_NET, REM_NODE, REM_POINT
  28.        FIDO address of your uplink (node system) or boss node
  29.        (point system).
  30.        ECHOFEED_NET, ECHOFEED_NODE
  31.        FIDO address of feed for EchoMail, e.g. uplink or boss node.
  32.  
  33.    UNIX addresses
  34.     o Your system:
  35.        MY_HOSTNAME
  36.        Internet address, hostname part.
  37.        MY_DOMAIN
  38.        Internet address, domain part. Use ".uucp" if you don't have
  39.        a domain address.
  40.     o Other systems:
  41.        UUCPFEED
  42.        Hostname of system to send mail to.
  43.        UUCPFEED_DOMAIN
  44.        Domain Adress of UUCPFEED. (Both definitions are used by the
  45.        rmail replacement)
  46.     o FIDO domain:
  47.        FIDODOMAIN
  48.        Standard domain for FIDONET addresses. ".fidonet.org" is
  49.        the standard, so better leave this alone.
  50.  
  51.    Configuration:
  52.        LOCAL_REPLY_TO
  53.        Uncomment this define if you want additional Reply-To headers
  54.        in your messages. This enables direct reply to someone on
  55.        FIDONET via your gateway. Sample header:
  56.            Reply-To: martin_junius%f6.n242.z2@hippo.dfv.rwth-aachen.de
  57.        The addressing via `%' makes it easy to route mail via UUCP
  58.        realted programs.
  59.        ERRORS_TO
  60.        Uncomment this define if you want bounced mail send to
  61.        root or postmaster or someone else.
  62.  
  63.    Directories:
  64.        Edit the defines of spool and lib directories to meet your
  65.        taste, e.g. replace "/u/spool/fidonet" with "/usr/spool/fido"
  66.        or whatever you want. (SPOOL ... AREAS)
  67.        All spool and lib directories must be located under the
  68.        corresponding top-level directory (e.g. /u/spool/fidonet
  69.        and /u/lib/fidonet).
  70.  
  71.    Mail/News programs:
  72.        RFMAIL
  73.        Full path name of FIDOGATE's rfmail program, normally
  74.        "LIBDIR/rfmail".
  75.        RNEWS
  76.        Full path name of your news receiver, e.g. "/bin/rnews"
  77.        RMAIL
  78.        Full path name of your mail receiver, e.g. "/bin/rmail".
  79.        This may be the installed replacement.
  80.        RECVMAIL
  81.        Real unix mail receiver, if you've installed the rmail
  82.        replacement, e.g. "/bin/ormail". XENIX uses
  83.        "/usr/lib/mail/execmail", this is also automatically
  84.        recognized in rmail.c
  85.        RETURN_FAILED_MAIL
  86.            Define this if you want rfmail to return undeliverable
  87.            FIDO mail.
  88.  
  89.    System dependencies:
  90.        Define USG if you're running a System V UNIX, or BSD if you're
  91.        UNIX is more BSDish. (BSD not tested yet.)
  92.        Define LOCK_LOCKF if file locking is done via the lockf() call,
  93.        else locking() will be used.    
  94.  
  95.    The following defines are parameters for fcall, they aren't used
  96.    at all, so leave them alone!
  97.  
  98.  
  99.  
  100. 2. Edit `Makefile'
  101.  
  102.    Directories:
  103.        NEWSBINDIR
  104.        Directory of inews related programs (Cnews' anne.jones etc.).
  105.        Used for installation of msgidseq.
  106.        LIBDIR
  107.        Lib directory for FIDOGATE software, same as define in
  108.        config.h.
  109.        SPOOLDIR
  110.        Spool directory for FIDOGATE software, same as define in
  111.        config.h.
  112.        RMAILDIR
  113.        Directory where rmail is located. (/bin or /usr/bin)
  114.  
  115.    Owner/Group:
  116.        OWNER
  117.        GROUP
  118.        Owner and group name for user/group id of the installed
  119.        FIDOGATE software. rfmail is installed setuid OWNER.
  120.  
  121.    Compiler:
  122.       CC
  123.       CFLAGS
  124.       LDFLAGS
  125.       LIBS
  126.        As usual, your C compiler (e.g. cc or gcc), C compile
  127.        options, link option and additional libraries (XENIX needs
  128.        -lx).
  129.  
  130.  
  131.  
  132. 3. Edit `frecv'
  133.  
  134.    Change the define of SPOOL and the address matching patterns to
  135.    be sufficient for your system. SPOOL must be the same as in
  136.    config.h and Makefile.
  137.  
  138.  
  139.  
  140. 4. Here we go ...
  141.  
  142.    Main installation:
  143.        Compile the beast by entering
  144.            make
  145.        If everything works, you can continue the installation. Log in
  146.        as super user and enter
  147.            make install.dirs
  148.        This will create the necessary working directories for the
  149.        FIDOGATE software. Now type
  150.            make install
  151.        to copy the programs to the appropiate directories.
  152.  
  153.    rmail installation:
  154.        Type
  155.            make install.rmail
  156.        to install the replacement for rmail. This will move the
  157.        original version of rmail to `ormail' and install the
  158.        replacement as the systems rmail command.
  159.  
  160.    msgidseq installation:
  161.        Type
  162.            make install.msgidseq
  163.        to install the message id number sequencer in the news
  164.        inject directory. This program will enable the FIDOGATE
  165.        software to use the RFC `Message-Id:' in FIDO `^AMSGID'
  166.        kludges. You also must edit `anne.jones' (CNews) or
  167.        similar to use msgidseq for id generation:
  168.  
  169. *** /u/lib/newsbin/inject/anne.jones.ori    Sat Aug 18 15:51:02 1990
  170. --- /u/lib/newsbin/inject/anne.jones    Sat Aug 18 16:06:44 1990
  171. ***************
  172. *** 117,120 ****
  173.   defpath="$badsites$USER" \
  174.   deffrom="$FROM" deforg="$deforg" \
  175.   defdate="` set $date; echo $1, $3 $2 \` echo $6 | sed 's/^..//' \` $4 $5`" \
  176. ! defmsgid="`set $date; echo \<$6$2$3.\`  echo $4 | tr -d : \`.$$@$host\>`" -
  177. --- 117,124 ----
  178.   defpath="$badsites$USER" \
  179.   deffrom="$FROM" deforg="$deforg" \
  180.   defdate="` set $date; echo $1, $3 $2 \` echo $6 | sed 's/^..//' \` $4 $5`" \
  181. ! defmsgid="`echo \<\`msgidseq\`@$host\>`" -
  182.  
  183.  
  184.  
  185. 5. News forwarding
  186.  
  187.    Put something similar to
  188.  
  189. # export to fidonet
  190. f1.n6000.z2.fidonet.org:all/fidonet::/u/lib/fidonet/rfmail -n
  191.  
  192.    in your news `sys' file (CNews) to forward locally created postings
  193.    to the FIDONET receiver rfmail. The FIDONET address must be identical
  194.    to the one generated by funpack in the `Path' header.
  195.  
  196.  
  197.  
  198. 6. Areas/Alias
  199.  
  200.    Edit the file Areas for the newsgroup <-> EchoMail area conversion,
  201.    change the entries for your favorite newsgroups/areas and distribution.
  202.    Also edit the file Alias, which is used for conversion between
  203.    UNIX user names and FIDO real names.
  204.    If done, copy these files to the FIDOGATE lib directory (e.g.
  205.    "/u/lib/fidonet".
  206.  
  207.  
  208.  
  209. 7. Testing
  210.  
  211.    Copy a FIDO mail packet addressed to your system into the directory
  212.    SPOOL/in, then execute LIBDIR/funpack as user news. You should get
  213.    the unpacked messages in SPOOL/unpacked: M.* for mail and N.* for
  214.    news. Execute LIBDIR/frecv to feed them to rmail or rnews.
  215.    
  216.    Post a message to a FIDO linked newsgroup. You should find the
  217.    FIDO message in directory SPOOL as M.*. Execute fpack as user news
  218.    to create a FIDO mail packet in SPOOL/out.
  219.  
  220.  
  221.  
  222. 8. Connecting with FIDO
  223.  
  224.    At the current state, FIDOGATE isn't able to act as a mailer, so
  225.    you have to transfer FIDO mail to and from the UNIX system by some
  226.    other means.
  227.    
  228.    The solution I'm using is a seperate PC running DOS and BinkleyTerm
  229.    as a mailer. Currently the PC is a real FIDO node, online 24 hours
  230.    a day, but in former times I've used it in a dual point setup. FIDO
  231.    mail packets for the UNIX system are packed at the PC and transferred
  232.    via a direct serial line to and from the UNIX machine. This is done
  233.    on a time schedule driven by BinkleyTerm via a MSDOS implementation
  234.    of UUCP.
  235.  
  236.  
  237.  
  238. $Date: 91/05/22 22:13:21 $, Martin Junius
  239. --
  240.  _____ _____
  241. |     |___  |   Martin Junius     FIDO:    2:242/6.1   2:242/6.0
  242. | | | |   | |   Republikplatz 3   DOMAIN:  mju@dfv.rwth-aachen.de
  243. |_|_|_|_____|   D-5100 Aachen     Tel. (Voice) 0241-86931
  244.