Configuration

Configuration files

/etc/openlmi/openlmi.conf is OpenLMI master configuration file.

Each provider may introduce additional configuration files, see their documentation. If a provider uses its own configuration file, the provider-specific one is parsed first and all missing options are then read from OpenLMI master configuration file.

Using this approach, administators can set e.g. one namespace for all providers in /etc/openlmi/openlmi.conf and different log levels for some providers in their configuration files.

File format

Configuration files has simple .ini syntax, with # or ; used for comments.

Default configuration:

[CIM]
Namespace=root/cimv2
SystemClassName=PG_ComputerSystem

[Log]
Level=ERROR
Stderr=false

Section	Option name	Default value	Description
CIM	Namespace	root/cimv2	Namespace where OpenLMI providers are registered.
CIM	SystemClassName	PG_ComputerSystem	Name of CIM_ComputerSystem class, which is used to represent the computer system. It will be used as SystemClassName property value of various classes. Different cimmoms can instrument variously named computer systems and some may not instrument any at all. Sfcb is an example of the later, it needs the sblim-cmpi-base package installed providing the basic set of providers containing Linux_ComputerSystem. So in case you run a Sfcb or you preferr to use providers from sblim-cmpi-base package, you need to change this to Linux_ComputerSystem.
Log	Level	ERROR	Chooses which messages are logged, either to CIMOM and (if configured) to standard error output. Available levels (sorted by severity) are: CRITICAL ERROR WARNING INFO DEBUG TRACE_WARNING TRACE_INFO TRACE_VERBOSE Levels below INFO (= TRACE_WARNING, TRACE_INFO and DEBUG) are useful mainly for debugging and bug reporting.
Log	Stderr	False	Toggles sending of log messages to standard error output of the CIMOM. Accepts boolean value (see the next section).

Treating boolean values

Options expecting boolean values treat following strings as valid True values:

• true
• 1
• yes
• on

While the following are considered False:

• false
• 0
• no
• off

These words are checked in a case-insensitive way. Any other value isn’t considered valid [1].

Logging

If logging is enabled, all log messages with level INFO and above are sent to CIMOM using standard CMPI CMLogMessage function. Consult documentation of your CIMOM how to enable output of these messages into CIMOM logs.

Messages with TRACE_WARNING and below are sent to CIMOM using CMTraceMessage and should be visible in CIMOM tracing log. Again, please consult your CIMOM documentation how to enable tracing logs.

With Stderr configuration option enabled, all logs are sent both to CIMOM and to the standard error output of the CIMOM.

---

[1]	Default value will be used as a fallback. This applies also to other non-boolean options in case of invalid value.