2013-10-08 09:36:44 +02:00
|
|
|
# Migrating from Icinga 1.x
|
|
|
|
|
|
2013-10-09 18:59:44 +02:00
|
|
|
## Configuration Migration
|
|
|
|
|
|
2013-10-10 09:40:50 +02:00
|
|
|
The Icinga 2 configuration format introduces plenty of behavioral changes. In
|
|
|
|
|
order to ease migration from Icinga 1.x,
|
2013-10-10 08:52:58 +02:00
|
|
|
Icinga 2 ships its own config conversion script.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
|
|
|
|
### Configuration Conversion Script
|
|
|
|
|
|
2013-10-10 08:52:58 +02:00
|
|
|
Due to the complexity of the Icinga 1.x configuration format the conversion
|
2013-10-10 09:40:50 +02:00
|
|
|
script might not currently work for all use cases.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
|
|
|
|
The config conversion script provides support for basic Icinga 1.x
|
2013-10-10 08:52:58 +02:00
|
|
|
configuration format conversion to native Icinga 2 configuration syntax.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
2013-10-10 08:52:58 +02:00
|
|
|
The conversion script tries to preserve your existing template structure and
|
2013-10-10 09:40:50 +02:00
|
|
|
adds new templates where appropriate. However, the original file structure is
|
|
|
|
|
not preserved.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
2013-10-10 08:52:58 +02:00
|
|
|
The conversion script uses templates from the Icinga Template Library where
|
|
|
|
|
possible.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
|
|
|
|
> **Note**
|
|
|
|
|
>
|
2013-10-10 08:52:58 +02:00
|
|
|
> Please check the provided README file for additional notes and possible
|
2013-10-11 14:02:19 +02:00
|
|
|
> caveats.
|
2013-10-09 18:59:44 +02:00
|
|
|
|
2013-10-11 14:02:19 +02:00
|
|
|
# mkdir /etc/icinga2/conf.d/migrate
|
|
|
|
|
# /usr/bin/icinga2-migrate-config -c /etc/icinga/icinga.cfg -o /etc/icinga2/conf.d/migrate
|
2013-10-09 18:59:44 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
### Manual Config Conversion
|
|
|
|
|
|
2013-10-10 09:40:50 +02:00
|
|
|
For a long-term migration of your configuration you should consider re-creating
|
|
|
|
|
your configuration based on the Icinga 2 proposed way of doing configuration right.
|
2013-10-08 09:36:44 +02:00
|
|
|
|
2013-10-10 08:52:58 +02:00
|
|
|
Please read the next chapter to get an idea about the differences between 1.x and 2.
|
