1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
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.
.. ****************************************************************************
.. _Sfcb: http://sourceforge.net/apps/mediawiki/sblim/index.php?title=Sfcb
|