Pulse 2 Inventory server 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 configuration file of the inventory server service from Pulse 2

Table of Contents

1. Introduction
2. Configuration file sections
3. « main » section
4. « daemon » section
5. « database » section
6. « option_XXX » section

1. Introduction

The « inventory server » service is the Pulse 2 daemon in charge importing inventory sent from ocs inventory agents.

The service configuration file is /etc/mmc/pulse2/inventoryserver.ini

Like all Pulse 2 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 three sections are available in this configuration file. Some sections describing the different available launchers may appear, their name must begin with "launcher_". The idea behind this is that the main section controls the common behavior of launchers, the others control the specific behaviors.

Table 1. inventoryserver.ini available sections

Section name	Description	Optional
main	Common inventory server configuration directives	no
daemon	Inventory server daemon related behaviors	no
database	Database connection parameters	no
scheduler	Referent scheduler location	yes
option_XXX	Inventory agent option XXX	yes

All the other sections (loggers, handlers, ...) are related to Python language logging framework. See http://docs.python.org/lib/logging-config-fileformat.html .

3. « main » section

This section is used to configure the inventory server services.

Table 2. Available options for the "main" section

Option name	Description	Optional	Default value
server	The hostname or ip address where the inventory.	yes	localhost
port	The port on which the inventory listen.	yes	9999
ocsmapping	The mapping file betwen ocs inventory agent xml output and the database schema	yes	/etc/mmc/pulse2/OcsNGMap.xml

4. « daemon » section

This section sets the inventory service run-time options and privileges.

Table 3. Available options for the "daemon" section

Option name	Description	Optional	Default value
pidfile	The inventory service store its PID in the given file.	yes	/var/run/pulse2-inventoryserver.pid
user	The inventory service runs as this specified user.	yes	root
group	The inventory service runs as this specified group.	yes	root
umask	The inventory service umask defines the right of the new files it creates (log files for example).	yes	0077

5. « database » section

This section defines some global options..

Table 4. Available options for the "database" 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

6. « option_XXX » section

This section define options that has to be given to the ocs inventory agent.

At the moment the only option which return will be inserted in the database is REGISTRY.

Each PARAM_YYY is for an XML tag PARAM in the inventory request. It is made of two values separated by ##. The first value is PARAM XML attributes, the second one is the content of the PARAM XML tag. The attributes are a list of couple attribute name, attribute value, the name and the value are separated by ::, each couple is separated by ||.

Table 5. Available options for the "option_XXX" section

Option name	Description	Optional	Default value
NAME	The option name.	no
PARAM_YYY	The option params.	yes

For example :

[option_01]
NAME = REGISTRY
PARAM_01 = NAME::srvcomment||REGKEY::SYSTEM\CurrentControlSet\Services\lanmanserver\parameters||REGTREE::2##srvcomment
PARAM_02 = NAME::DisplayName||REGKEY::SYSTEM\CurrentControlSet\Services\lanmanserver||REGTREE::2##DisplayName