TKalert

From Thomas-Krenn-Wiki
Jump to: navigation, search

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.

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 - http://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 http://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

</pre>

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
Low Energy Server with TKmon
TKmon Set-up