MMC-Pulse2 Inventory plugin configuration file

Olivier Roussy

<oroussy@mandriva.com>

Revision History
Revision $Revision: 42 $	$Date: 2008-07-11 10:35:26 +0200 (Fri, 11 Jul 2008) $	$Author: nrueff $

Abstract

This document explains the content of the MMC-Pulse2 Inventory plugin configuration file

Table of Contents

1. Introduction
2. Configuration file sections
3. « main » section
4. « inventory » section
5. « computer » section
6. « expert_mode » section
7. « graph » section

1. Introduction

The « Inventory » plugin is the MMC-Pulse2 plugin in charge displaying the content of the inventory database, and providing facilities for dynamic group creation.

The plugin configuration file is /etc/mmc/plugins/inventory.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

For now five sections are available in this configuration file:

Table 1. inventory.ini available sections

Section name	Description	Optional
main	Mostly MMC related behaviors	no
inventory	Inventory related options	no
computer	Computers list's display content	no
expert_mode	Select which columns are only shown in expert mode	no
graph	Select which columns can be graphed	no

3. « main » section

This section is used to give directives to the MMC agent.

Table 2. Available options for the "main" section

Option name	Description	Optional	Default value
disable	Whenever use this plugin (or not)	no	0

4. « inventory » section

This section defines some global options.

Table 3. Available options for the "inventory" section

Option name	Description	Optional	Default value
dbdriver	DB driver to use	no	mysql
dbhost	Host which hosts the DB	no	127.0.0.1
dbport	Port on which to connect to reach the DB	yes	3306 (aka "default MySQL port")
dbname	DB name	no	inventory
dbuser	Username to give while conencting to the DB	no	mmc
dbpasswd	Password to give while connecting to the DB	no	mmc

5. « computer » section

This section define what kind of informations will be displayed in computers list.

Table 4. Available options for the "computer" section

Option name	Description	Optional	Default value
content	List of additional parameters for the Computer object	yes	cn::Computer Name\|\|displayName\|\|Description
display	List of parameters that will be displayed in computers list	yes	""

For exemple :

[computers]
content = Registry::Value::regdn::Path==DisplayName||Registry::Value::srvcomment::Path==srvcomment
display = cn::Computer Name||displayName::Description||srvcomment::Name||regdn::Display Name

6. « expert_mode » section

This section defined columns that will be only displayed when in expert mode.

Table 5. Available options for the "expert_mode" section

Option name	Description	Optional	Default value
<Table name>	List of column in this Sql table that won't be displayed in normal mode	yes	""

7. « graph » section

This section defined columns on which we will be able to draw graphs.

Table 6. Available options for the "graph" section

Option name	Description	Optional	Default value
<Table name>	List of column in this Sql table we will be able to draw	yes	""