TKalert setup
Please note that this article / this category refers either on older software / hardware components or is no longer maintained for other reasons. This page is no longer updated and is purely for reference purposes still here in the archive available. |
---|
This article describes the installation and configuration of TKalert. TKalert sends encrypted Call-Home-Service messages to Thomas Krenn (exactly what data is collected is described in the Call-Home-Service Privacy Policy). TKalert is part of TKmon, but can also be integrated into an existing Icinga/Nagios - Using Call-Home-Service with Icinga or Nagios.
Important hint
The monitoring software TKmon is no longer being developed further and the Thomas-Krenn call-home service has also now been switched off.
Installation from TKalert with Ubuntu
TKalert is located in the optional part of the Thomas Krenn Ubuntu-Repo archive.thomas-krenn.com (for other Linux distributions TKalert can be loaded directly from the GIT repository [1]).
- Add Thomas Krenn Apt-Key:
wget -O - https://archive.thomas-krenn.com/tk-archive.gpg.pub | sudo apt-key add -
- Add Thomas Krenn Repository:
cd /etc/apt/sources.list.d
sudo wget https://archive.thomas-krenn.com/tk-optional.list
cd
sudo apt-get update
- Install TKalert Paket
:~$ sudo apt-get install tkalert [...] The following NEW packages will be installed: tkalert 0 upgraded, 1 newly installed, 0 to remove and 102 not upgraded. Need to get 32.5 kB of archives. After this operation, 134 kB of additional disk space will be used. [...] Setting up tkalert (1.1.1-1) ...
TKalert Configuration
The Nagios user (as which Icinga is running) must be able to access the Command-line Tool tkalert
without entering the sudo password. The following file /etc/sudoers.d
is created:
:~$ sudo vi /etc/sudoers.d/tkmon # ------------------------------------------------------ # Sudoers file for Thomas Krenn call-home-service action # ------------------------------------------------------ nagios ALL=(ALL)NOPASSWD:/usr/bin/tkalert
Permission for this file is set to a higher restriction level: pre>
- ~$ sudo chmod 440 /etc/sudoers.d/tkmon
TKalert Testing
To see whether the conditions described above and the example-configuration are correct, check the following commands:
:~$ sudo su nagios --shell /bin/bash nagios@tkmon:~$ sudo /usr/bin/tkalert --type="test" --auth-key="abc1deugn2g" --contact-person="Max Mustermann" --contact-mail="mmustermann@example.org" :~$ exit
The execution of the sudo command may not require a password!
The following email is received for the "contact-mail" specified email address after a proper set-up and valid Auth-Key is completed:
Subject: Call-Home Setup OK From: monitor@thomas-krenn.com Max Mustermann Wed Jul 23 12:41:19 2014 ------------------------------------------- Ihre Call-Home-Konfiguration wurde erfolgreich getestet. ------------------------------------------- Your Call-Home setup has been tested successfully.