icinga2/tools/configconvert
Michael Friedrich 6e3afe7748 configconvert: notification* attributes for services and users
refs #2743
2013-06-26 09:23:01 +02:00
..
Icinga2 configconvert: notification* attributes for services and users 2013-06-26 09:23:01 +02:00
conf configconvert: move to tools/ 2013-06-24 16:14:20 +02:00
Icinga2.pm configconvert: move to tools/ 2013-06-24 16:14:20 +02:00
README configconvert: update README 2013-06-24 16:19:58 +02:00
icinga2-conv.conf configconvert: move to tools/ 2013-06-24 16:14:20 +02:00
icinga2_convert_v1_v2.pl configconvert: remove trailing whitespaces 2013-06-26 09:23:01 +02:00
run_icinga2 configconvert: move to tools/ 2013-06-24 16:14:20 +02:00

README

ICINGA 2 CONVERSION SCRIPT FOR ICINGA 1.x CONFIGURATION
=======================================================

This config conversion script provides support for basic Icinga 1.x
configuration format conversion.

It won't just compile all objects and drop them at once, but keep your
existing 1.x template structure.

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
system. 

Furthermore the old "service with contacts and notification commands" logic
will be converted into Icinga2's logic with new notification objects,
allowing to define notifications directly on the service definition then.

All required templates will be inherited from Icinga2's Template Library (ITL).

RUN
# ./icinga2_convert_v1_v2.pl -v -o conf/

HELP
# ./icinga2_convert_v1_v2.pl -h

TEST
There's a small icinga2 conversion test config available, including conf/ folder.

# ~/i2/sbin/icinga2 -c icinga2-conv.conf

(or if icinga2 binary is located in $HOME/i2/sbin/icinga2, simply use run_icinga2)


REQUIREMENTS
- Perl:
	Data::Dumper
	File::Find
	Storable qw(dclone)
	Getopt::Long qw(:config no_ignore_case bundling)
	Pod::Usage

- Icinga2 ITL


DEBUG
Compile Icinga2 with --enable-debug=yes and start it with -x. Alternatively, define the
ConsoleLogger Object and set severity to "debug".

local object ConsoleLogger "my-debug-log" {
    severity = "debug"
}


NOTES
- Excludes (will be ignored in member lists)
- Wildcards (* means all)
- additive + to += logic (only for the current object, does not work with users)
- Dependencies (host deps and parents are merged)
- Commands will be split into Check|Event|Notification Commands

TODO
- Escalations (transformed from notification counter to start/end time, new logic)
- Dependency attributes: failure_criteria, inherits_parents, timeperiods
- Notifications: notification_options conversion
- Flapping Thresholds: old vs new logic
- some special object tricks, regex