icinga-satellite/README.md

Icinga2 Satellite

Requirements

• need a running icinga2 master instance
• ticket & zone config in master instance
  • see: Icinga: Master Setup

ATTENTION: primary designed for:

• AO-IT: icinga-stack
• AO-IT: icinga2
• AO-IT: icingaweb2

Maybe you need more setup setps if you use other base!

usage

master instance

example zone.conf

• Icinga: Zones
• Icinga: Endpoints

DO NOT copy&paste this config !
Replace first all $VARS

object Endpoint "master.example.com" {
}
object Zone "master" {
        endpoints = [ "master.example.com" ]
}

// your new config to do:
object Endpoint "$ICINGA_SATELLITE_CN" {
        host = "1.2.3.4"                // ip or
        host = "$ICINGA_SATELLITE_CN"   // hostname
}
object Zone "$ICINGA_SATELLITE_ZONE" {
        parent = "$ICINGA_PARENT_CN"
        endpoints = [ "$ICINGA_SATELLITE_CN" ]
}
// end: new config to do

object Zone "global-templates" {
        global = true
}

object Zone "director-global" {
        global = true
}

create new zone on master

mkdir zones.d/$ICINGA_SATELLITE_ZONE
nano zones.d/$ICINGA_SATELLITE_ZONE/hosts.conf 

satellite node

git clone https://git.ao-it.net/docker/icinga-satellite
cd icinga-satellite
cp env.sample .env
nano .env # set your env
docker compose up