TKalert setup

From Thomas-Krenn-Wiki
Jump to navigation Jump to search
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]).

  1. Add Thomas Krenn Apt-Key:
    wget -O - https://archive.thomas-krenn.com/tk-archive.gpg.pub | sudo apt-key add -
  2. 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
  3. 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.

Related articles

Adaptec RAID Monitoring Plugin for Windows Server 2012 set-up
Call-Home-Service FAQs list
Call-Home-Service Privacy Policy explained