tyler.durden/icinga2
1
0
Fork 0
mirror of https://github.com/Icinga/icinga2.git synced 2025-07-27 23:54:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

configconvert: update README

Browse Source 
refs #2743
This commit is contained in:
Michael Friedrich 2013-06-26 16:23:19 +02:00
parent f3ccb88bae
commit 7599e858ec
1 changed files with 24 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
tools/configconvert/README
View File

@ -2,19 +2,38 @@ ICINGA 2 CONVERSION SCRIPT FOR ICINGA 1.x CONFIGURATION
======================================================= =======================================================
This config conversion script provides support for basic Icinga 1.x This config conversion script provides support for basic Icinga 1.x
configuration format conversion. configuration format conversion to native Icinga 2.x configuration syntax.
It won't just compile all objects and drop them at once, but keep your It won't just compile all objects and drop them at once, but keep your
existing 1.x template structure. existing 1.x template structure, only adding a new host->service link relation.
The script will also detect the "attach service to hostgroup and put The script will also detect the "attach service to hostgroup and put
hosts as members" trick from 1.x and convert that into Icinga2's template hosts as members" trick from 1.x and convert that into Icinga2's template
system. system.
Furthermore the old "service with contacts and notification commands" logic Furthermore the old "service with contacts and notification commands" logic
will be converted into Icinga2's logic with new notification objects, will be converted into Icinga2's logic with new notification objects,
allowing to define notifications directly on the service definition then. allowing to define notifications directly on the service definition then.
Commands will be split by type (Check, Event, Notification) and relinked where
possible. The host's check_command is dropped, and a possible service hostcheck
looked up, if possible.
Notifications will be built based on the service->contact relations, and
escalations will also be merged into notifications, having times begin/end as
additional attributes. Notification options will be converted into the new Icinga2
logic.
Dependencies and Parents are resolved into host and service dependencies with
many objects tricks as well.
Timeperiods will be converted as is, because Icinga2's ITL provides the legacy-timeperiod
template which supports that format for compatibility reasons.
Custom attributes like custom variables, *_urls, etc will be collected into the
custom dictionary, while possible macros are automagically converted into the macro
dictionary (freely definable macros in Icinga 2.x).
All required templates will be inherited from Icinga2's Template Library (ITL). All required templates will be inherited from Icinga2's Template Library (ITL).
RUN RUN
@ -62,6 +81,8 @@ NOTES
notification_{state,type}_filter = (StateFilterWarning | StateFilterUnknown | NotificationFilterFlapping) notification_{state,type}_filter = (StateFilterWarning | StateFilterUnknown | NotificationFilterFlapping)
- service escalations are converted into notifications with times = begin/end - service escalations are converted into notifications with times = begin/end
begin = first_notification * notification_interval (now a time, not a counter) begin = first_notification * notification_interval (now a time, not a counter)
- custom variables, *_url, *image*, notes, 2d_coords will be collected and stashed into the "custom" dictionary
similar to the macros dictionary. note: attributes starting with a number must be quoted.
TODO TODO
- Dependency attributes: failure_criteria, inherits_parents, timeperiods - Dependency attributes: failure_criteria, inherits_parents, timeperiods