MMC mail plugin configuration file

Cédric Delfosse

<cdelfosse@mandriva.com>

Revision History
Revision $Revision: 1625 $	$Date: 2008-06-02 15:05:11 +0200 (Mon, 02 Jun 2008) $	$Author: cdelfosse $

Abstract

This document explains the content of the MMC mail plugin configuration file

Table of Contents

1. Introduction
2. Configuration file sections
3. Section « main »
4. Section « userdefault »

1. Introduction

The « mail » plugin allows the MMC to add/remove mail delivery management attributes to users and groups, and mail virtual domains, etc. It uses the « base » plugin for all its related LDAP operations.

The plugin configuration file is /etc/mmc/plugins/mail.ini.

Like all MMC related configuration file, its file format is INI style. The file is made of sections, each one starting with a « [sectionname] » header. In each section options can be defined like this « option = value ».

For example:

        [section1]
        option1 = 1
        option2 = 2

        [section2]
        option1 = foo
        option2 = plop

2. Configuration file sections

Here are all the mail.ini available sections

Table 1. mail.ini available sections

Section name	Description	Optional
main	global mail plugin configuration	no
userdefault	Attributes and Objectclass values that are added or deleted when adding mail attributes to a user	yes

3. Section « main »

This sections defines the global options of the mail plugin

Table 2. Available options for the « main » section

Option name	Description	Optional	Default value
disable	Is this plugin disabled ?	Yes	1
vDomainSupport	Is virtual domain management enabled ?	Yes	0
vDomainDN	Organizational Unit where virtual mail domains will be stored	Yes if vDomainSupport is disabled

4. Section « userdefault »

When adding the mail attributes to a user, you may want to change the value of the attributes that are added. Please look at the « MMC base plugin configuration file » for a look at how this section works.

The mailbox field of this section is very important to set because it determines the paths where the mails are delivered to users.

If the mails are delivered by Postfix, use this:

      [userdefault]
      mailbox = %homeDirectory%/Maildir/

If you use Dovecot as the delivery agent:

      [userdefault]
      mailbox = maildir:%homeDirectory%/Maildir/