====== Basic installation of Icinga 2.13.6 ======

These notes are based on the official and pretty awful Icinga2 documentation at:

  * https://icinga.com/docs/icinga-2/latest/doc/02-installation/
  * https://icinga.com/docs/icinga-2/latest/doc/02-installation/01-Debian/
  * https://icinga.com/docs/icinga-2/latest/doc/06-distributed-monitoring/#distributed-monitoring

Unless stated otherwise, all the following commands should be run as root.

Steps which are not mentioned in the official documentation are shown //in italics//.  Steps in the official documentation which __you should not perform__ are also shown //in italics//.

**The following should be done on any Master, Satellite or Agent**

  - Install pre-requisites:<code>aptitude install apt-transport-https wget gnupg</code>
  - //**do not** install the repository signing key using the following command from the official documentation, as this method is deprecated by Debian and Devuan//<code>wget -O - https://packages.icinga.com/icinga.key | apt-key add -</code>
    * //instead you should use://<code>wget -O - https://packages.icinga.com/icinga.key | gpg --dearmor -o /usr/share/keyrings/icinga-archive-keyring.gpg</code>
  - //You should then create the sources.list file as://<code>deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/debian icinga-bullseye main</code>Adjust the release name "bullseye" as appropriate for whichever version of Debian or Devuan this machine is running - however always use the Debian name in this file, even if you are running Devuan.  The cross-reference table at https://en.wikipedia.org/wiki/Devuan#Version_history may help identify which release name to use.
  - Update the package list:<code>aptitude update</code>
  - Install icinga and the standard monitoring plugins:<code>aptitude install icinga2 monitoring-plugins</code>
  - You should also have a look at [[https://packages.debian.org/bullseye/monitoring-plugins-contrib|monitoring-plugins-contrib]] and if you want to use any of these checks as well, install the package:<code>aptitude install monitoring-plugins-contrib</code>

If this is the only machine you are setting up (to monitor itself), or if this is a Master server in a Master - (Satellite/s) - Agent/s setup, you should now proceed with the [[icingaweb2|setup of Icingaweb2]] so that you can see the results of what is being monitored.

If this is a Satellite or Agent machine, you should proceed instead with [[hierarchy|connecting this machine]] to the next one up in the hierarchy.
----
[[.:|Go up]]\\
Return to [[:|main index]].