ochobitshacenunbyte

Free Software, GNU y Linux

Instalar Icinga 2 e Icinga Web 2 en Centos 7

por · 17 mayo, 2018

En el artículo de hoy vamos a ver la instalación y primeros pasos de configuración de la plataforma Icinga, esto es, Icinga2 e IcingaWeb2, sobre un sistema operativo CentOS 7, en este año 2018

La idea de dejar claro el año en que estamos, es que la instalación de este producto ya la traté en su día, además de otros artículos que podéis encontrar por la web. Desde entonces ha cambiado bastante, así que vamos al lío.

Instalación de Icinga2 e IcingaWeb2

Para seguir la instalación me he servido de la documentación oficial, que siempre es la mejor opción. Iremos por partes. Primero instalaremos Icinga2, después el servidor web y la base de datos necesaria; por último el frontend web IcingaWeb2.

Instalación de Icinga2

Ya hemos dicho que la instalación va a ser como un sistema GNU Linux CentOS 7, por lo que también es compatible con RHEL 7.

El primero paso es instalar el repositorio de Icinga, de la siguiente manera:

  1. yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm

Para la instalación es imprescindible también tener habilitado el repositorio EPEL

  1. yum install epel-release

Una vez instalados ambos repositorios, ya podemos realizar la instalación del producto:

  1. yum install icinga2
  2. systemctl enable icinga2
  3. systemctl start icinga2

Al ser un sistema con systemd, en el paso anterior hemos utilizando systemctl para añadir al arranque el servicio, además de encenderlo.

Tras realizar la instalación se habilitan por defecto tres funcionalidades, que son:

  • ‘checker’ que tal como indica el nombre se encarga de los chequeos
  • ‘notifcation’ funcionalidad para enviar las notificaciones
  • ‘maillog’, que se encarga de escribir el fichero ‘icinga2.log’

Podemos ver las funcionalidades con el siguiente comando:

  1. icinga2 feature list

Ya sabéis que Icinga es un proyecto derivado de Nagios, por lo que utiliza los mismos plugins que este. Estos están disponibles a través del repositorio EPEL que hemos instalado anteriormente. Por lo que para instalarlos sólo debemos escribir:

  1. yum install nagios-plugins-all

Es importante indicar que cada vez que realicemos un cambio debemos reiniciar el servicio, de la siguiente manera:

  1. systemctl restart icinga2

Si en nuestro sistema tenemos habilitado el sistema de control de acceso SELinux, debemos instalar un módulo de Icinga, para que el producto pueda trabajar correctamente.

  1. yum install icinga2-selinux

Para que pueda comunicarse correctamente Icinga2 con el IcingaWeb2, debemos configurar DB IDO; esta pieza se encarga de exportar toda la información de configuración y estado de los monitores, a una base de datos. Existen dos módulos al respecto, uno para MYSQL/MariaDB y otro para PostgreSQL

En nuestro caso vamos a utilizar MariaDB, por lo que vamos a instalar el servidor de base de datos:

  1. yum install mariadb-server mariadb
  2. systemctl enable mariadb
  3. systemctl start mariadb
  4. mysql_secure_installation

En el último comando, nos encargamos de asignar una contraseña al usuario ‘root’ de la base de datos, además de asegurar la instalación.

Ahora nos toca instalar el módulo IDO, que hemos comentado anteriormente.

  1. yum install icinga2-ido-mysql

Una vez hecho estos pasos, ya podemos acceder a la consola de base de datos, crear la base de datos correspondiente y asignarle el usuario de turno.

  1. # mysql -u root -p
  2.  
  3. CREATE DATABASE icinga;
  4. GRANT ALL PRIVILEGES ON icinga.* TO 'icingauser'@'localhost' IDENTIFIED BY 'contrasea1412';
  5.  
  6. CREATE DATABASE icingaweb;
  7. GRANT ALL PRIVILEGES ON icingaweb.* TO 'icingauser'@'localhost' IDENTIFIED BY 'contrasea1412';
  8.  
  9. FLUSH PRIVILEGES;

Salimos de la consola de base de datos e importamos el esquema de “Icinga 2 IDO”

  1. mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/mysql.sql

Por último en esta parte habilitamos el módulo ‘Icinga 2 IDO’

  1. icinga2 feature enable ido-mysql

Y reiniciamos el servicio:

  1. systemctl restart icinga2

Instalación de IcingaWEB2

Ya hemos llegado al apartado web. El primero paso será instalar el servidor web. Aquí podemos escoger tanto NGINX como Apache. Yo me he decantado por este último.

Realizamos la instalación:

  1. yum install httpd
  2. systemctl enable httpd
  3. systemctl start httpd

Si tenemos el cortafuegos habilitado con ‘firewalld’, debemos añadir:

  1. firewall-cmd --add-service=http
  2. firewall-cmd --permanent --add-service=http

Tanto Icinga Web2 como otras interfaces web utilizan una “REST API” para sus acciones y las consultas a los detalles de los objetos.

Podemos ejecutar el comando CLI con ‘icinga api setup’ para habilitar la característica ‘api’

  1. icinga2 api setup

Además debemos editar el fichero donde se indica la configuración de usuarios para la API

  1. vim /etc/icinga2/conf.d/api-users.conf

Y añadir:

  1. object ApiUser "icingaweb2" {
  2. password = "Wijsn8Z9eRs5E25d"
  3. permissions = [ "status/query", "actions/*", "objects/modify/*", "objects/query/*" ]
  4. }

El usuario y la contraseña la debemos cambiar.

Además debemos modificar los datos de configuración del fichero «/etc/icinga2/features-enabled/ido-mysql.conf» , para que quede, en mi caso, como sigue:

  1. library "db_ido_mysql"
  2.  
  3. object IdoMysqlConnection "ido-mysql" {
  4. user = "icingauser"
  5. password = "contrasea1412"
  6. host = "localhost"
  7. database = "icinga"
  8. }

Una vez hechos los cambios podemos reiniciar:

  1. systemctl restart icinga2

Continuemos. Para poder instalar todos los paquetes del proyecto web, debemos tener habilitado un repositorio más, que nos dará acceso a una serie de paquetes para PHP, este repositorio es SCL

  1. yum install centos-release-scl

De esta manera ya tenemos todos los repositorios necesarios para poder continuar con la instalación.

Recordamos que hasta ahora hemos instalado el servidor web Apache (httpd) y la base de datos MariaDB

Instalamos Icinga Web 2

  1. yum install icingaweb2 icingacli -y

Si utilizamos SELinux, adicionalmente debemos instalar:

  1. yum install icingaweb2-selinux -y

Si deseamos trabajar con el módulo FPM, un acrónimo en inglés de “FastCGI Process Manager”, los pasos serían los siguientes:

  1. yum install rh-php71-php-fpm
  2. systemctl start rh-php71-php-fpm.service
  3. systemctl enable rh-php71-php-fpm.service

Continuamos con la instalación del módulo de PHP para la base de datos:

  1. yum install rh-php71-php-mysqlnd

Reiniciamos FPM

  1. systemctl restart rh-php71-php-fpm.service

Una vez hecho todo esto, debemos obtener el ‘token’ que utilizamos en la instalación vía web:

  1. icingacli setup token create

Siempre lo podemos visualizar con el siguiente comando:

  1. icingacli setup token show

Reiniciar servicio web:

  1. systemctl restart httpd

Antes de pasar a la interfaz web, debemos realizar un par se pasos más. El primero de todo es configurar la zona horaria , para ello debemos editar el fichero «/etc/opt/rh/rh-php71/php.ini» e indicar nuestra zona horaria, que en mi caso es «Europe/Madrid»

Por último instalaremos el paquete ‘Imagick’, que nos permitirá trabajar con ficheros pdf. La instalación es:

  1. yum install sclo-php71-php-pecl-imagick

Volvemos a reiniciar los servicios web:

  1. systemctl restart httpd
  2. systemctl restart rh-php71-php-fpm.service

Ahora sí, nos vamos a la instalación web.

Tanto esta parte como la parte web, la podéis seguir en el siguiente vídeo:

Espero que os parezca interesante. Nos vamos leyendo ^.^

Etiquetas:

21 Respuestas

  1. Miguel Milla dice:
    25 octubre, 2018 a las 2:20 pm

    Hola David,
    me ha sido muy útil tu tutorial.
    Muchas Gracias.

    Responder
  2. Jorge dice:
    1 noviembre, 2018 a las 12:38 am

    Hola David, gracias por compartir.
    Tengo una consulta, porque cuando se ejecuta el comando para activar el modo de monitoreo basado en agente se pierde de vista los host configurados en modo simple?

    Responder
  3. miki dice:
    9 noviembre, 2018 a las 3:32 pm

    impresionante explicación

    Responder
  4. Gabriel dice:
    15 enero, 2019 a las 9:15 pm

    hola David. me ha funcionado perfectamente la receta y el vídeo. ¿tienes algun link donde explique como agregar host?. deseo monitorear dispositivos con snsmp.

    Responder
  5. Cesar dice:
    16 mayo, 2019 a las 11:20 pm

    Disculpa pero tengo el siguiente problema…
    The Icinga Web 2 configuration directory defaults to «/etc/icingaweb2», if not explicitly set in the environment variable «ICINGAWEB_CONFIGDIR»

    No puedo avanzar por los siguientes permios, sabes que puede ser?

    Responder
  6. Andreas dice:
    16 septiembre, 2019 a las 4:04 pm

    hola, Muchas gracias por el aporte! Podrias mostrar como configurar Icinga 2 para monitorear host y services especificos?

    Responder
  7. Carlos dice:
    1 abril, 2020 a las 3:58 pm

    Menida vida, me cambio ya de nagios a esta app, gracias por el video y la guia, dure 40 min instalando desde 0, genial poder seguir miranto tu foro.

    «Eres un maquina»

    Responder
  8. Juan Pablo Martinez Ferrari dice:
    14 abril, 2020 a las 1:08 pm

    Llevo pegandome un mes con los manuales y he entendido más en media hora con tu manual que con todos los suyos.!!! Mil gracias

    Responder
  9. Bire Maz dice:
    22 mayo, 2020 a las 11:43 am

    A modo de nota, yo he tenido problemas a la hora de instalar el paquete de «sclo-php71-php-pecl-imagick» de primeras porque ya no está en el repo de sclo y al instalarlo manualmente por problemas de dependencias (Requires: libMagickWand.so.5()(64bit)). Lo he solventado instalando también la versión 7.3 de php (fpm incluido). No he podido quitar la versión 7.1 porque está puesto como dependencias del icinga.

    Responder
    • davidochobits dice:
      24 mayo, 2020 a las 9:42 pm

      Hola colega,

      Gracias por el aporte. Tendré que volver a echar un vistazo a la instalación, ya que esta entrada ya ha quedado un poco desfasada, tras dos años desde que la escribí.

      Saludos!

      Responder
  10. Ignacio dice:
    27 agosto, 2020 a las 2:42 pm

    David,

    Muy buen tutorial, tengo una sola consulta cuando estoy la parte de instalacion de IDO database me sale el siguiente error:

    «There is currently no icinga instance writing to the IDO. Make sure that a icinga instance is configured and able to write to the IDO».

    Que podrá ser? Permisos sobre el directorio no es, ya que le di todos los permisos posibles.

    Muchas gracias y saludos desde Uruguay

    Responder
  11. Davinosky Tavarez dice:
    20 marzo, 2023 a las 8:21 pm

    El ultimo paso de la configuracion me esta generando este error:

    No se puede crear la cuenta «davinoskytavarez». Ocurrió un error:
    ERROR: Zend_Db_Statement_Exception in /usr/share/icingaweb2/library/vendor/Zend/Db/Statement/Pdo.php:225 with message: SQLSTATE[42S02]: Base table or view not found: 1146 Table ‘icingaweb.icingaweb_user’ doesn’t exist, query was: SELECT COUNT(*) AS cnt FROM icingaweb_user WHERE (name = ‘davinoskytavarez’)
    La cuenta «davinoskytavarez» se ha definido correctamente como administrador inicial.

    Responder
    • davidochobits dice:
      21 marzo, 2023 a las 10:40 am

      Hola,

      Esta entrada tiene más de cinco años, imagino que la instalación de Icinga habrá variado en todo este tiempo. Tiene pinta que en algún paso no se ha creado la tabla «icingaweb.icingaweb_user» en la base de datos. Más no te puedo ayudar, revisa los puntos de instalación o bien busca una guía de instalación actualizada para el año 2023.

      Saludos

      Responder
  12. Carlos Augusto Barbosa dice:
    21 marzo, 2023 a las 10:22 pm

    Hi, thanks for your cook-book. I success to install it but get error on the last step when the system will create the user on icingaweb2 database with this: Enter password:
    ERROR 1071 (42000) at line 15: Specified key was too long; max key length is 767 bytes

    Responder

Deja un comentario

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.