granicus.if.org Git - icinga2/blob - doc/7-migrating-from-icinga-1x.md

   1 # <a id="migrating-from-icinga-1x"></a> Migrating from Icinga 1.x
   2
   3 ## <a id="configuration-migration"></a> Configuration Migration
   4
   5 The Icinga 2 configuration format introduces plenty of behavioural changes. In
   6 order to ease migration from Icinga 1.x,
   7 Icinga 2 ships its own config migration script.
   8
   9 ### <a id="configuration-migration-script"></a> Configuration Migration Script
  10
  11 Due to the complexity of the Icinga 1.x configuration format the migration
  12 script might not currently work for all use cases.
  13
  14 The config migration script provides support for basic Icinga 1.x
  15 configuration format migration to native Icinga 2 configuration syntax.
  16
  17 The migration script tries to preserve your existing template structure and
  18 adds new templates where appropriate. However, the original file structure is
  19 not preserved.
  20
  21 The migration script uses templates from the Icinga Template Library where
  22 possible.
  23
  24     # mkdir /etc/icinga2/conf.d/migrate
  25     # /usr/bin/icinga2-migrate-config -c /etc/icinga/icinga.cfg -o /etc/icinga2/conf.d/migrate
  26
  27 ### <a id="manual-config-migration"></a> Manual Config Migration
  28
  29 For a long-term migration of your configuration you should consider re-creating
  30 your configuration based on the Icinga 2 proposed way of doing configuration right.
  31
  32 Please read the [next chapter](#differences-1x-2) to get an idea about the differences between 1.x and 2.