MMC web configuration file

Cédric Delfosse

<cdelfosse@mandriva.com>

Revision History
Revision $Revision: 49 $	$Date: 2007-09-24 22:52:34 +0200 (Mon, 24 Sep 2007) $	$Author: cedric $

Abstract

This document explains the content of the MMC web configuration file

Table of Contents

1. Introduction
2. Configuration file sections
3. Section « global »
4. Section « debug »
5. Section « server_x »

1. Introduction

The MMC web interface communicates with MMC agents to manage LDAP directories, services and ressources.

Its configuration file is /etc/mmc/mmc.ini. This file must be readable only by root, as it contains the login and password required to connect to MMC agents.

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

Table 1. /etc/mmc/mmc.ini available sections

Section name	Description	Optional
global	MMC web interface global options	no
debug	debug options	no
server_x	MMC agent XMLRPC server connection options	no

3. Section « global »

Table 2. Available options for the « global » section

Option name	Description	Optional
backend	Which RPC backend to use. Only xmlrpc backend is available.	No
login	credential to authenticate with the MMC agent	No
password	credential to authenticate with the MMC agent	No
root	Root URL where the MMC web pages are installed	No
rootfsmodules	Filesystem path where the MMC web modules are installed	No
maxperpage	Number of items (users, groups, ...) in displayed lists on the web interface	No

4. Section « debug »

Table 3. Available options for the « debug » section

Option name	Description	Optional	Default value
level	Wanted debug level. 0 to disable debug. 1 to enable debug.	No

5. Section « server_x »

You can set multiple sections called « server_01 », « server_02 » ... to specify a list of MMC agents to connect to.

On the MMC login web page, all the specified MMC agents will be displayed, and you will be able to select the one you want to be connected to.

Table 4. Available options for the « server_x » sections

Option name	Description	Optional	Default value
description	label to display on the MMC login web page	No
url	How to connect the XMLRPC server of this MMC agent	No

For example, to define a local MMC agent:

      [server_01]
      description = Local MMC agent
      url = http://127.0.0.1:7080

To use SSL between the web interface and the MMC agent (SSL must be enabled on the MMC agent):

      [server_01]
      description = Local MMC agent
      url = https://127.0.0.1:7080