4 Using the DTC root panel

The administrator interface is divided in 3 parts. We have already talked about the general configuration. Let's talk about the 2 other parts: user management and config file generation.

4.1 General description

4.1.1 How it works
DTC aims to generate config files for all supported daemons. All you will do here will control the way those files will be generated.

A cron script is launched each 10 minutes validating the changes by writing config files and reloading specified services.

4.1.2 The web interface
DTC is split up into 3 main directories. The admin console (normally in /usr/share/dtc/admin, but that may vary upon systems, like bsd likes to find it in /usr/local/share...) is your main root web interface. This is where you control all the domains hosted on your machine.
The "client" folder (normally in /usr/share/dtc/client) is for all your virtual administrators to enter their domain name configuration module. You don't need it if you don't use the delegation of privilege (virtual administrators), because all user modules are show on the root console also.

In standard distribution, dtc will install the root console to http[s]://dtc.yourdomain-name.com/dtcadmin/, and a client panel to all domain names under http[s]://dtc.yourdomain-name.com/dtc/. Don't bare to customise the generation scripts under /usr/shared/dtc/admin/inc/gen_*.php, add SSL, remove or add aliases, etc...

When all this will be setup, you will add a virtual administrator to your computer. Then, you will add a domain name to that virtual administrator. With the virtual administrator console (client console), it's possible to enter all informations for mailbox and/or ftp accounts, and you can create subdomains like "http://my.example.com" if "example.com" was his domain name.

A good idea is to create "mx.your-domain-name.com" on your main domain name, and to enter "mx.your-domain-name.com" as the default mx server for the hosted domains (in the configuration panel). You can add an IP to that subdomain, so it will not have an apache vhost associated.

You can then either call the php script files from the root console to generate the config files, and relaunch the deamons (named, qmail-send, and apache) manually. You can of course rely on the /usr/share/dtc/admin/cron.php script, so everything is all automatic.

4.2 User management

4.1.1 Adding a virtual admin

This form is for adding a virtual administrator (client), that will be allowed to change properties of his domain(s).

The path tells where domain files will be stored (mail and http files).

Take care! The login will happen to the path specified. So if you have set /var/www/sites as the path, and that you add the user named foo, then his path will be /var/www/sites/foo.

4.2.2 Managing your client domains

- Editing the virtual admin:

This form lets you add and delete domains for a client and change his path. If you change his path here, you have to move the files manually.

- Configuration of each domains:

This form allow limitation to each domains (number of subzone, email account, or ftp account...). The right most popup tells what will be the IP for apache vhosts of this domain.

4.3 Generating daemon config files

This panel allows to generate config files for each daemon individually. It helps when debugging a server and to check that everything's working fine.