sobota, 22 stycznia 2022

Instalacja Check_MK RAW w systemie Debian 11 (Linux)

 

Do wykonania instalacji Check_MK RAW (wersja bez opłat) potrzebny nam będzie pakiet gdebi. Jest to prosty instalator pakietów deb, który pobiera i instaluje również zależne pakiety. Instalacje możemy wykonać poprzez sudo z poziomu konta głównego użytkownika lub z poziomu shella z uprawnieniami root.

 sudo apt install gdebi-core

 

Instalacja

Pakiet Check_MK RAW w najnowszej wersji możemy pobrać ze strony: 

https://checkmk.com/download?edition=cre&version=stable

W czasie przygotowania niniejszego wpisu była to wersja 2.0.0p18, którą pobrałem na serwer za pomocą komendy wget.

wget https://download.checkmk.com/checkmk/2.0.0p18/check-mk-raw-2.0.0p18_0.bullseye_amd64.deb

 Instalacja pobranego pakietu Check_MK RAW:

sudo gdebi check-mk-raw-2.0.0p18_0.bullseye_amd64.deb 

Konfiguracja serwera Check_MK.

Instalacja i konfiguracją instancjami Check_MK sterujemy komendą omd.

# omd
Usage (called as root):

 omd help                               Show general help
 omd setversion VERSION                 Sets the default version of OMD which will be used by new sites
 omd version    [SITE]                  Show version of OMD
 omd versions                           List installed OMD versions
 omd sites                              Show list of sites
 omd create     SITE                    Create a new site (-u UID, -g GID)
 omd init       SITE                    Populate site directory with default files and enable the site
 omd rm         SITE                    Remove a site (and its data)
 omd disable    SITE                    Disable a site (stop it, unmount tmpfs, remove Apache hook)
 omd enable     SITE                    Enable a site (reenable a formerly disabled site)
 omd mv         SITE NEWNAME            Rename a site
 omd cp         SITE NEWNAME            Make a copy of a site
 omd update     SITE                    Update site to other version of OMD
 omd start      [SITE] [SERVICE]        Start services of one or all sites
 omd stop       [SITE] [SERVICE]        Stop services of site(s)
 omd restart    [SITE] [SERVICE]        Restart services of site(s)
 omd reload     [SITE] [SERVICE]        Reload services of site(s)
 omd status     [SITE] [SERVICE]        Show status of services of site(s)
 omd config     SITE ...                Show and set site configuration parameters.

Usage:
 omd config [site]                      interactive mode
 omd config [site] show                 show configuration settings
 omd config [site] set VAR VAL          set specific setting VAR to VAL
 omd diff       SITE ([RELBASE])        Shows differences compared to the original version files
 omd su         SITE                    Run a shell as a site-user
 omd umount     [SITE]                  Umount ramdisk volumes of site(s)
 omd backup     SITE [SITE] [-|ARCHIVE_PATH] Create a backup tarball of a site, writing it to a file or stdout
 omd restore    [SITE] handler=[-|ARCHIVE_PATH] Restores the backup of a site to an existing site or creates a new site
 omd cleanup                            Uninstall all Check_MK versions that are not used by any site.

General Options:
 -V <version>                    set specific version, useful in combination with update/create
 omd COMMAND -h, --help          show available options of COMMAND

 Przyjmijmy, że nasza pierwsza instancja Check_MK będzie się nazywać: NetMon, którą tworzymy komendą:

omd create NetMon

 
Adding /opt/omd/sites/NetMon/tmp to /etc/fstab.
Creating temporary filesystem /omd/sites/NetMon/tmp...OK
Updating core configuration...
Generating configuration for core (type nagios)...Precompiling host checks...OK
OK
Executing post-create script "01_create-sample-config.py"...OK
Restarting Apache...OK
Created new site NetMon with version 2.0.0p18.cre.

  The site can be started with omd start NetMon.
  The default web UI is available at http://CheckMK-DEV/NetMon/

  The admin user for the web applications is cmkadmin with password: iVrFmeaI
  For command line administration of the site, log in with 'omd su NetMon'.
  After logging in, you can change the password for cmkadmin with 'htpasswd etc/htpasswd cmkadmin'.

W powyższym komunikacie mamy podany URL interfejsu Check_MK oraz login i hasło dostępu do interfejsu WEB Check_MK RAW.

Następnie uruchamiamy stworzoną instancje serwera Check_MK:

omd start NetMon

Temporary filesystem already mounted
Starting mkeventd...OK
Starting rrdcached...OK
Starting npcd...OK
Starting nagios...OK
Starting apache...OK
Starting redis...OK
Initializing Crontab...OK
 

Pozostałe czynności wykonujemy już z poziomu przeglądarki internetowej pod wskazanym wyżej adresie URL.

Logujemy się na użytkownika głównego: cmkadmin

Pierwszym krokiem powinno być stworzenie nowego konta, z którego poziomu będziemy administrować Check_MK w codziennej pracy. Nie zalecam używać konta cmkadmin do codziennej pracy.

By utworzyć nowe konto klikamy w ikonkę "Setup" a następnie wybieramy pozycje "Users".


UWAGA: Przy tworzeniu tego użytkownika trzeba pamiętać by dodać przynależność użytkownika do roli o uprawnieniach administratora poprzez zaznaczenie pola "Administrator" (sekcja Roles) oraz do grupy kontaktowej "Everything" (sekcja Contact Groups).


Zanim zaczniemy monitorujemy pierwsze urządzenie.

Na wstępie trzeba wspomnieć o organizacji hostów w konfiguracji Check_MK, jest to niezbędne do prawidłowego zdefiniowania swojej struktury parametrów.

Check_MK używa struktury drzewa, które składa się z "folderów", "hostów", klastrów". Parametry przypisane do "folderów" mogą być dziedziczone w strukturze drzewiastej w kierunku od korzenia (folder: Main) do kolejnych zagnieżdżonych elementów: folder, host, cluster. W folderach można tworzyć kolejne foldery, clustry, hosty bez większych ograniczeń.

Najczęściej foldery używam do grupowania hostów pod względem projektu, funkcjonalności, lokalizacji.

Parametry zdefiniowane dla folderu głównego Main są dziedziczone przez kolejne foldery i hosty, dlatego bez uzasadnionej potrzeby nie należy zmieniać jego domyślnych wartości.

Poza organizacją w strukturze drzewiastej folderów możemy oznaczać i grupować hosty i usługi po:

  • grupach kontaktowych
  • grupach hostów
  • grupach usług
  • poprzez definicje etykiet
  • atrybutów

Zestaw tak bogatych ustawień pozwala zdefiniować dowolny zakres reguł monitorowania, alarmowania, powiadomień.

Check_MK pozwala monitorować hosty i usługi za pomocą:

  • SNMP V1/2c/3
  • SNMP Trap
  • zestawu gotowych agentów
  • wtyczek monitorujących typu Nagios
  • skryptów API, agentów i wtyczek, które możemy tworzyć we własnym zakresie.

UWAGA: By Check_MK wykrył usługi/interfejsy na danym serwerze/urządzeniu trzeba zdefiniować odpowiednią regułę wykrywającą usługę/interfejs. W domyślnym zakresie dodane urządzenie będzie monitorowanie wyłącznie w zakresie odpowiedzi na pakiety ICMP (ping) oraz w zakresie istnienia zdalnego agenta Check_MK.

Dalszy opis dalszy opis konfiguracji znajdzie się w kolejnych wpisach na przykładzie konkretnych typow urządzeń.






 

Brak komentarzy:

Prześlij komentarz