welcome: please sign in

Upload page content

You can upload content for the page named below. If you change the page name, you can also upload content for another page. If the page name is empty, we derive the page name from the file name.

File to load page content from
Page name
Comment
Last name of the current Debian Project Leader

Revision 26 as of 2007-11-19 03:12:21

Edit

DomTool / Examples

Here are some example configuration files for DomTool, our distributed configuration management system.

TableOfContents()

1. Domains

1.1. The Model T

If you just want to declare your domain with a www.yourdomain virtual host serving out of ~/public_html/ and all mail forwarded to your mailbox, use: {{{dom "yourdomain" with end;}}}

1.2. Upgraded Model T

If you like everything dom gives you but want to add additional configuration, include it between with..end. For instance, to add an extra web virtual host other: {{{dom "yourdomain" with

end;}}}

1.3. Model T with customized www.yourdomain

You wouldn't want to copy the last example with "www" instead of "other", because dom already creates a www vhost. Instead, there's a more convenient way to configure this most common of vhosts: {{{dom "yourdomain" where

with

end;}}}

1.4. Attack of the Model T Clones

We can take the Model T and use it with some alternate names for the domain we're configuring. {{{dom "yourdomain" where

with end;}}} A single Apache virtual host is created, answering to multiple names. Other configuration is duplicated like you had entered it in a separate dom block for each alias.

1.5. The Do-It-Yourself

The lowest-level way of configuring a domain is the domain directive, which does nothing but set up basic DNS parameters and provide a space for including further directives: {{{domain "yourdomain" with

end;}}}

2. DNS

Here's a tour through the available DNS features.

{{{domain "yourdomain" with

end;}}}

2.1. Keeping DNS elsewhere

This example shows how to configure mail handling for a domain that is primarily hosted off of HCoop:

{{{domain "yourdomain" where

with

end;}}}

3. Mail

{{{domain "yourdomain" with

end;}}}

4. Apache

4.1. The Model T

{{{domain "yourdomain" with

end;}}}

Note that the web directive also adds the right DNS mapping for your virtual host.

4.2. The Do-It-Yourself

{{{domain "yourdomain" with

end;}}}

This one doesn't add any DNS mappings.

4.3. Using a nonstandard web server

{{{domain "yourdomain" with

end;}}}

4.4. Using SSL

For this example, we assume that you've applied for and been granted permissions on the SSL certificate /etc/apache2/ssl/user/yourdomain.pem and the IP address 1.2.3.4 on mire.

{{{domNoWww "yourdomain" with

end;}}}

Here's how to do it with just a vhost.

{{{domain "yourdomain" with

end;}}}

{{{domain "yourdomain" with

end;}}}

home "private_html" builds the full path to subdirectory private_html of your home directory.

4.6. Basic URL handling

{{{domain "yourdomain" with

end;}}}

4.7. Location-specific configuration

{{{domain "yourdomain" with

end;}}}

4.8. Server aliases

{{{domain "yourdomain" with

end;}}}

Note that you must have domtool configuration rights to all domains you name with serverAlias.

4.9. Directory options

{{{domain "yourdomain" with

end;}}}

4.10. Access control

{{{domain "yourdomain" with

end}}}

4.11. Fancy directory index generation

{{{domain "yourdomain" with

end;}}}

4.12. mod_rewrite

{{{domain "yourdomain" with

end;}}}

4.13. mod_proxy

{{{domain "yourdomain" with

end;}}}

5. Mailman

The following example will:

{{{dom "yourdomain" with

end;}}}

6. Common Web Applications

6.1. MoinMoin

6.1.1. A Standalone Site

{{{dom "yourdomain" with

end}}}

6.1.2. Adding a Wiki to a Bigger Site

{{{dom "yourdomain" with

end}}}

6.2. WordPress

6.2.1. A Standalone Blog

{{{dom "yourdomain" with

end}}}

Make sure you have the WordPress distribution installed at the appropriate DocumentRoot.

6.2.2. Adding a Blog to a Bigger Site

{{{dom "yourdomain" with

end}}}

Make sure you have the WordPress distribution installed at the filesystem location implied by the URL prefix you choose.

7. Live Examples in HCoop AFS

This is a listing of files in the HCoop AFS area which contain in-production examples of DomTool configuration.

8. Putting It All Together

In order to help you put all of the pieces together, some full working examples are available in [:/Full:separate subpage].