Skip to content

Linuxfabrik/icingaweb2-module-director

 
 

Repository files navigation

Linuxfabrik Fork of the Icinga Director

Motivation - Why we forked

Have a look at the previous version for our initial motivation.

Fortunately, we had the possibility to work together with Icinga to integrate most of our changes into the master branch of the official Icinga Director. However, we are still missing one feature that we need for our deployments: Automatic renaming of applied custom variables.

Features

This version of our fork:

  • is based on the official v1.11.1 release (on the support/1.11 branch)
  • automatically renames applied related vars during basket imports. Have a look at Testing for details.
  • fixes Icinga#2725
  • makes the MySQL migrations "nicer" - they do not fail if the uuid columns already exist (making migrations easier)

Installation

Follow the installation instructions.

Migrating from Linuxfabrik fork v1.8.1 or lower:

  • Important: Disable the Director module in IcingaWeb2 before installing this fork.
  • Install this fork.
  • Apply the required SQL migrations:
mysql -p -u root icinga_director < schema/guids2uuids-migration.sql
  • Enable the Director.

Migrating from v1.10.2+ or Linuxfabrik fork v1.10.2.2023020901:

  • Install this fork.
  • Use the DB-Migrations offered in IcingaWeb2.

Known limitations

  • DataFields: Renaming or removing an entry will only rename/remove the entry in the datalist, not the applied variables on other objects such as hosts or services.
  • The fork is not tested with Configuration Branches for Icinga Director.

Testing

  • Import rename-related-vars1.json
  • Create a host which has the custom variable applied and contains a value: icingacli director host create host1 --imports ___TEST___host_template1 --vars.___TEST___datafield1 'myvalue1'
  • Import rename-related-vars2.json
  • During this import the variable was renamed from ___TEST___datafield1 to ___TEST___datafield1-renamed.
  • Make sure that the applied variable on the host is also renamed: icingacli director host show host1

About

Linuxfabrik Fork of the Icinga Director

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 91.8%
  • PowerShell 5.6%
  • Less 1.2%
  • Other 1.4%