Aerospace Software Ltd.

Citadel Basics How-to Guide

For Mandriva Linux 2009

Scope

This guide describes the basic configuration of Citadel. You can download a fully installed virtual machine from the citadel.org web site and run it on VMware, but you need to do the network configuration yourself still. This guide should get you going.

Note that to run ANY mail server, the network must be configured right, else it won't work. The Easy Install script will set Citadel up properly for you provided that the network is configured right before your start.

DNS

Your mail server must have a FQDN. I'm not sure where Ubuntu sets that, on Redhat-ish systems, it is in /etc/sysconfig/network. If you don't run a DNS, then the server won't receive mail directly since it needs a MX record. If the server doesn't have a hostname and IP address in a DNS, then you can define it in /etc/hosts and then it will be able to send mail.

Test the DNS settings with dig:

Forward:
# dig example.com

MX:
# dig example.com MX

Reverse:
# dig example.com PTR

Don't bother installing the mail server, until the DNS resolves properly!

Network Settings

Assuming that you don't want to run a DNS and want to use Citadel to act as a slave and fetch mail from your ISP mail server and deliver mail to your ISP mail server, check the following things:

/etc/sysconfig/network (may be different for Ubuntu):

HOSTNAME=mail.example.com

/etc/hosts:

127.0.0.1 localhost.localdomain localhost
192.168.1.2 mail.example.com

Test the hostname:

# hostname

You must see the FQDN mail.example.com

Citadel Standalone Settings

You can configure all Citadel features using Webcit:

In Internet Configuration, set the Local Host Aliases to example.com.
In Internet Configuration, set Masqueradable Domains to example.com
In Site Configuration, set Node Name to mail
In Site Configuration, set Fully Qualified Domain Name to example.com
In Site Configuraton Network Services, set Server IP Address to 0.0.0.0

Now restart networking and restart Citadel and hopefully it will be able to send and receive mail.

Citadel Local Mailer (Smart Host) Settings

You can configure all Citadel features using Webcit:

In Internet Configuration, set the Local Host Aliases to example.com.
In Internet Configuration, set Masqueradable Domains to example.com
In Internet Configuration, set Smart Hosts to mail.yourisp.net
In Site Configuration, set Node Name to mail
In Site Configuration, set Fully Qualified Domain Name to example.com
In Site Configuraton Network Services, set Server IP Address to 0.0.0.0

Now restart networking and restart Citadel and hopefully it will be able to send mail to your ISP mail server.

You then need to go into your private mailbox and configure it to fetch mail from your ISP:

Click Mail, Advanced, Remote Retrieval and configure it to fetch mail from your ISP mail server.

La voila!