citadel/docs/inetmailsetup.txt

   1 Citadel/UX Internet E-mail setup instructions (native Citadel/UX version)
   2
   3 This document explains how to set up your citadel as an Internet e-mail
   4 capable system. Once you are through with this document you should be able to
   5 have your users send mail from, and receive mail to
   6 systemname@system.citadel.org. For example to send e-mail to a user at
   7 Uncensored! BBS via e-mail you would do the following:
   8 mail patriot@uncensored.citadel.org
   9
  10 To set this up is almost insanely simple.
  11
  12   1. Check for the existance of a current MTA (sendmail, qmail, etc):
  13      If you see something similar to the following you're running an MTA
  14      already and you'll need to shut it down:
  15
  16
  17  smw @ pixel % telnet localhost 25
  18  Trying 127.0.0.1...
  19  Connected to localhost.
  20  Escape character is '^]'.
  21  220 pixel.citadel.org ESMTP Sendmail 8.9.3/8.9.3; Wed, 15 Mar 2000 19:00:53 -0500
  22
  23
  24
  25
  26      The above shows that pixel is running Sendmail version 8.9.3 and the
  27 current date. What this means is that Pixel is running the MX version of
  28 bbs e-mail, which is described in inetmailsetupmx.txt.
  29
  30 If you get a 'connection refused' message when you telnet to port 25 there's
  31 nothing running and you should be able to continue. You might also want to
  32 turn off POP (try the above test substituting 110 for 25) and IMAP (port 143)
  33 and use Citadel's POP and IMAP services.
  34
  35 The POP and IMAP services will ONLY allow retrieval of mail for Citadel users.
  36 For those of you who are running some kind of mail transport agent
  37 (as Pixel is, above) or POP server, the following will show how to remove
  38 it from a RedHat Linux system:
  39
  40
  41                                Removing Sendmail
  42
  43           First cd to /etc/sysconfig.
  44           As root, change (I don't recommend actively removing files
  45           unless you REALLY know what you're doing) the sendmail file to
  46           sendmail.old or move it from that directory completely.
  47           Shut down sendmail.
  48           You can either reboot or /etc/rc.d/init.d/sendmail stop, OR do a
  49           ps and kill sendmail manually. Your method of choice is up to you.
  50
  51                              Removing POP and IMAP
  52
  53           cd /etc and edit inetd.conf. Look for a few lines similar to:
  54
  55                  # Pop and imap mail services et al
  56                  #
  57                  #pop-2   stream  tcp     nowait  root    /usr/sbin/tcpd ipop2d
  58                  #pop-3   stream  tcp     nowait  root    /usr/sbin/tcpd ipop3d
  59                  #imap    stream  tcp     nowait  root    /usr/sbin/tcpd imapd
  60
  61
  62           If they're already commented out you're good to go for the
  63           Citadel/UX server to take over pop. If not, you'll want to
  64           comment them out.
  65
  66   2.Ensure you have the correct FQDN in (.A)ide (S)ystem (G)eneral
  67      This is explained in siteconfig.txt.
  68   3.Add any alias FQDN's in (.A)ide (S)ystem (I)nternet
  69      Explained in inetsiteconfig.txt.
  70   4.Add a Smart Host, if you need one.
  71   5.Restart your Citadel/UX server.
  72
  73
  74
  75 Some definitions:
  76
  77      FQDN: Fully Qualified Doman Name:
  78      If your system were called 'test' on the foobar.com network, and you
  79      had an entry on the internet by which you could get to your system
  80      your FQDN would be test.foobar.com. For the most part, most FQDNs
  81      will be your bbsname.citadel.org. Coordinate that with Freakdog on
  82      DogpoundII (telnet://dogpound2.citadel.org).
  83
  84      Alias FQDN:
  85      Other names by which your system can be called.
  86
  87      Smart Host:
  88      An internet host that relays your mail for you, or a host to which
  89      you would send ALL your mail which could go out via an MX record.
  90
  91
  92
  93 Citadel will look for an existing pop/smtp server on startup. If they don't
  94 exist (and you've configured them as shown in siteconfig.txt) citadel should
  95 fire them up at start time. You can check your logs to be sure, or you can
  96 start the  server from a shell and watch it load. It should look similar to
  97 this:
  98
  99
 100 smw @ pixel % ./citserver
 101
 102 Multithreaded message server for Citadel/UX
 103 Copyright (C) 1987-2000 by the Citadel/UX development team.
 104 Citadel/UX is free software, covered by the GNU General Public License, and
 105 you are welcome to change it and/or distribute copies of it under certain
 106 conditions.  There is absolutely no warranty for this software.  Please
 107 read the 'COPYING.txt' file for details.
 108
 109 Loading citadel.config
 110 Opening databases
 111 This is GDBM version 1.8.0, as of May 19, 1999.
 112 Checking floor reference counts
 113 Creating base rooms (if necessary)
 114 Registered a new service (TCP port 504)
 115 Registered a new service (TCP port 0)
 116 Initializing loadable modules
 117 Registered server command CHAT (Begin real-time chat)
 118 Registered server command PEXP (Poll for express messages)
 119 Registered server command GEXP (Get express messages)
 120 Registered server command SEXP (Send an express message)
 121 Registered server command DEXP (Disable express messages)
 122 Registered a new session function (type 0)
 123 Registered a new x-msg function (priority 0)
 124 Loaded module: $Id$
 125 Registered a new session function (type 1)
 126 Registered a new message function (type 201)
 127 Registered a new message function (type 202)
 128 Registered server command REGI (Enter registration info)
 129 Registered server command GREG (Get registration info)
 130 Registered a new user function (type 100)
 131 Loaded module: $Id$
 132 Server-hosted upgrade level is 5.62
 133 Loaded module: $Id$
 134 Registered server command EXPI (Expire old system objects)
 135 Registered server command FSCK (Check message ref counts)
 136 Loaded module: $Id$
 137 citserver: Can't bind: Address already in use
 138 ERROR: could not bind to TCP port 25.
 139 Registered a new service (TCP port 0)
 140 Registered a new session function (type 50)
 141 Loaded module: $Id$
 142 citserver: Can't bind: Address already in use
 143 ERROR: could not bind to TCP port 110.
 144 Registered a new session function (type 0)
 145 Loaded module: $Id$
 146 Registered a new message function (type 202)Loaded module: $Id:
 147 serv_inetcfg.c,v 1.2 2000/02/03 03:57:35 ajc Exp $
 148 Registered server command RWHO (Display who is online)
 149 Registered server command HCHG (Masquerade hostname)
 150 Registered server command RCHG (Masquerade roomname)
 151 Registered server command UCHG (Masquerade username)
 152 Registered server command STEL (Enter/exit stealth mode)
 153 Loaded module: $Id$
 154 Changing uid to 513
 155 Starting housekeeper thread
 156
 157 Notice the two error lines below:
 158 citserver: Can't bind: Address already in use
 159 ERROR: could not bind to TCP port 110.
 160
 161 This means that Citadel couldn't start up pop services. Generally this
 162 only happens if there's something on this port. In this case it's Pixel's pop
 163 server (incidentally, PixelBBS uses Citadel/UX for pop).  You'll find the same
 164 is true for IMAP, which runs on port 143.
 165
 166 citserver: Can't bind: Address already in use
 167 ERROR: could not bind to TCP port 25.
 168
 169 This occurs whenever something is on port 25. In this case sendmail is
 170 there. Make SURE you've followed the above steps to remove sendmail/pop and
 171 start your server again.