For those who wants to give it a try, here is the best way to have a (fast) setup of the DTC control panel. This setup should work under all current flavor of Debian starting on Etch. We do not support Sarge anymore, even if the old stable version of our control panel is still in our repository. Note that if you need other versions of apache, php and others, it might change a bit, and you need to set them up BEFORE installing the panel itself. By default, dtc-toaster depends on apache2, php5 and mysql5.
GPLHost Debian repository
First, add the debian repository (select the closest to you, the .fr and .sg mirrors are synchronized each hours):
Tampa (florida) repository:
echo "deb ftp://ftp.gplhost.com/debian stable main" >>/etc/apt/sources.list
Singapore (south east asia) repository:
echo "deb ftp://ftp.gplhost.sg/debian stable main" >>/etc/apt/sources.list
Paris (france) repository:
echo "deb ftp://ftp.gplhost.fr/debian stable main" >>/etc/apt/sources.list
Before the setup
Check that you have a valid hostname entered, or amavisd-new will complain about it and refuse to setup. Try this command, as this is the one that amavis will use:
hostname --fqdn
it should return the fully qualified domain name of your mx server that should be something like "mx.your-domain.com" (this is best option). Check that
cat /etc/hostname
returns mx.example.com and that
cat /etc/hosts
returns somethine like:
1.2.3.4 mx mx.example.com
also, you can make it so the reverse DNS for 1.2.3.4 also replies mx.example.com as many SMTP checks for it. The reverse for the DNS server is less important, and you can always use mx instead of ns1 (in that case, you will change it later in dtc -> general configuration -> named zone files once DTC is installed).
check your hostname ( /etc/hostname )
hostname -d gives only the domainname
hostname -s gives only the hostname
hostname -f gives the hostname.domainname
if not, correct it by editing /etc/hostname then run hostname -F /etc/hostname
Something like "mx.your-domain.com" in /etc/hostname sounds to be the correct setup (otherwise you need some more customization).
Then check that "uname -a" is returning the correct FQDN.
Also, under Debian, you need to check that you have the "capability" kernel module, as pure-ftpd needs it to start. This can be found under:
Security options --->
[*] Enable different security models
<*> Default Linux Capabilities
Both running it directly in the kernel or as kernel module is fine. Another way is to recompile pure-ftpd-mysql with the option not to use this kernel module (but that's another story).
the default debconf is set to high, dtc will miss some questions.
resolve this with: dpkg-reconfigure debconf
choose Dialog, the default.
now chose medium at least (maybe low if you know what you are doing). This way you dont miss questions for configuring your packages.
Make sure you have all the locales needed for your installation (eg: supported languages like ru_RU.UTF-8, fr_FR, en_US, es_ES, pt_PT, it_IT, etc.):
dpkg-reconfigure locales
export LANGUAGE="en_US.UTF-8"
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
update-locale LANG=en_US.UTF-8
locale-gen
Remember that you HAVE to use the debian volatile repository to have clamav and spamassassin working. The default one simply does NOT work. So don't forget to add this repository:
deb http://volatile.debian.org/debian-volatile etch/volatile main contrib non-free
If you want to know more, read this site:
http://www.debian.org/volatile/
Installing dtc-toaster
Then do a apt-get update and apt-get install dtc-toaster. Answer the few questions, and that's it, you are DONE !
WARNING:
This is a very common mistake: dtc-xen is NOT to be setup under the same server where dtc is installed. It's to be setup on your dom0, while dtc itself would be typically installed in a domU. If you don't know what dom0 is, read the Xen documentation.
Important answers to debconf
Here is some side notes about what to answer to debconf when doing the setup.
- Create directories for web-based administration ? -> yes.
- Postfix general type of configuration? -> Internet Site. Answer mx.your-domain.com when it asks for the mail name as this is the default in DTC.
- Run pure-ftpd from inetd or as a standalone server? -> standalone. Note you will need the capability kernel module to run pure-ftpd (can be found under the security screen in the make menuconfig).
Later, you will need to activate spamassassin and saslauthd in /etc/default, as Debian leave it not activated at boot time (See Post Install section).
The other options don't matter a lot, select what you feel is good for you.
Note that if you didn't had any question for the MySQL root password, or for pure-ftpd-mysql, that means that your debconf priority was set to high and that you need to reconfigure these package:
- dpkg-reconfigure pure-ftpd-common
- dpkg-reconfigure mysql-server-5.0
Its a good idea to run the "dpkg-reconfigure pure-ftpd-common" regarless, as the config has been known to periodically fail.
Post install
Debian has a policy which effects a required post-install script from running. To complete the setup of DTC, the following script must be run as administrator:
/usr/share/dtc/admin/install/install
You should also check the /etc/default folder so it starts daemons automaticaly. These files must have the excute bit set. If they dont, run these commands:
chmod +x /etc/default/saslauthd
chmod +x /etc/default/spamassassin
chmod +x /etc/default/apache2
locales
If you are using Debian, then you need to apt-get install locales and maybe dpkg-reconfigure locales. If you are using Ubuntu, then you might need this:
1. sudo cp /var/lib/locales/supported.d/local /var/lib/locales/supported.d/local.old
2. sudo cp /usr/share/i18n/SUPPORTED /var/lib/locales/supported.d/local
3. sudo dpkg-reconfigure --force locales
If you don't perform this step, then the control panel will display "failed to setlocales" and there wont be any language support. Note that you do not need UTF8 but you do need en_US ISO8859-1, plus all the languages that you will want to be displayable.
Edit PhpMyAdmin .htacess file so phpmyadmin will work
remove the line IN SIDE THE .htaccess file on line 2.
Option FollowSymLinks
- Located in " /usr/share/phpmyadmin/.htaccess "
YOU SHOULD BE ALL DONE INSTALLING DTC-TOASTER
Log in with:
http://dtc.your-domain.com
Username: dtc
Password: What you chose during the package configuration.
Now if you want to help gplhost, you can "vote" for us by installing the popcon package (apt-get install popcon) to participate to the Debian packages popularity contest.
_________________________________________________________________________________________
Finally, if you want to help us, install the popularity-contest package to report to Debian that you are using our packages. This will help us to get a higher score and help people to see that many are using our packages.
How to get out of the tracks with specific setup
Note that dtc-toaster is a meta package that will install apache 2, mysql 5.0, postfix and courier. If you want to use cyrus, qmail, dovecot, apache 1.3, or any other specific things, you need to install them first with apt-get, then apt-get install dtc and it will detect what you have selected. This is also the way to go when you want to use the Cyrus delivery and pop3/imap system.
Here is the link to the howto for Debian Express Setup Old Version. If you want more explanations, you can go on the forums install faq here or on the dtc faq on this wiki (see the left menu...).
