icingaweb2-module-director/doc/04-Getting-started.md

1.3 KiB

Preparing your Icinga 2 environment for the Director

Create an API user

object ApiUser "director" {
  password = "***"
  permissions = [ "*" ]
  //client_cn = ""
}

To allow the configuration of an API user your Icinga 2 instance needs a zone and an endpoint object for itself. If you have a clustered setup or you are using agents you already have this. If you are using a fresh Icinga 2 installation or a standalone setup with other ways of checking your clients, you will have to create them.

The easiest way to set up Icinga 2 with a zone and endpoint is by running the Icinga 2 Setup Wizard.

Start with a new, empty Icinga setup. Director is not allowed to modify existing configuration in /etc/icinga2, and while importing existing config is possible (happens for example automagically at kickstart time) this is an advanced task you should not tackle at the early beginning.

Take some time to really understand how to work with Icinga Director first.

Working with Agents and Config Zones

Hint: Large: max packet size