NagiosQL

23/02/2015NagiosQL. Introducción e instalación en Nagios 3.x / 4.x en Centos 6 (Redhat) 6 Replies Introducción. Una de las características que más se echan de menos cuando comienzas con Nagios es que la configuración de objetos hay que realizarla con ficheros de texto. Esto supone un problema añadido por la dificultad inicial de entrada del mundo de los objetos de Nagios y la sintaxis para definirlos. Para paliar esta “ausencia” existe software de terceros que nos proporciona un interface gráfico para la definición de objetos. Dos posibilidades interesantes son Nconf y NagiosQL. Vamos a ver el segundo ya que a día de hoy es el que permanece más activo. En cualquier caso debemos preguntarnos previamente si realmente lo necesitamos. El software es bueno y muy manejable pero debemos tener en cuenta que pasaremos a realizar definiciones sobre listbox, checkbox,… en lugar de copy / pastes tradicionales. A lo mejor si manejas solo una instalación “tuya” prefieres los ficheros de texto pero si instalas Nagios para clientes puede ser más interesante para que el cliente pueda añadir sus propios objetos de forma “sencilla”. Otro asunto a tener en cuenta es que si usamos check_mk que tiene su propia sintaxis de definición de objetos ya no podremos usar NagiosQL. En mi caso que me encanta check_mk lo tengo claro pero… ¿Como funciona? Sencillo. Básicamente lo que hacen tanto NagiosQL como Nconf es que la configuración de objetos de Nagios se realiza y guarda en una BBDD para posteriormente generar desde la información en esta los ficheros de configuración de Nagios. Esto supone que no debemos editar nunca dichos ficheros ya que cambiarán en posteriores modificaciones a través del GUI. Aunque bien es cierto que podríamos tener unos ficheros a mano por un lado y el resto los generados por NagiosQL. ¿Nos evita tener conocer la compleja relación entre objetos de Nagios? No realmente, pero si la simplifica. Para poder crear los objetos, aunque sea usando formularios de colorines, necesitaremos conocer cómo se relacionas estos para saber que estamos haciendo. Bien es cierto que el software nos guía bastante bien y tiene controles para no dejarnos meter la pata y que creemos los objetos adecuadamente. Instalación de NagiosQL La instalación se realizará siguiendo el PDF bastante bien documentado que podemos encontrar en la página de documentación de NagiosQL. Este artículo refleja la instalación en Centos / Redhat pero para es perfectamente válido para cualquier otra distribución excepto en los paquetes que se instalan previamente que tendrán seguramente nombres diferentes en otras distribuciones. 4.23/02/2015 Requisitos de software Los requisitos que necesitamos para la instalación según la documentación serían los siguientes: Webserver like Apache 2. Tenemos ya varios de los requisitos instalados solo nos quedarían algunos que instalamos con: yum install mysql-server php-pecl-ssh2 php-mysql Configuramos mysql para arrancar en el inicio y le asignamos un password a root service mysqld start chkconfig mysqld on mysqladmin -u root password PASSWORD Directorios de configuración NagiosQL usa sus propios directorios de configuración donde ubica sus ficheros.x or greater Nagios 2. La instalación la realizamos sobre un Centos 6. Imagino que será idéntica con Redhat aunque con este a lo mejor necesitamos suscribirnos a algún repositorio adicional por algún paquete (lo que puede requerir tener una suscripción activa) Partimos de la instalación de Nagios 3 realizada en un artículo previo y también la probamos sobre una de Nagios 4.0 or greater including: PHP Module: Session PHP Module: MySQL PHP Module: gettext PHP Module: filter PHP Module: FTP (optional) PECL Extension: SSH (optional) Javascript activated in Webbrowser Multilanguage Support En nuestro caso lo instalaremos sobre Nagios 3 y Nagios 4 para probarlo sobre esta versión pero realmente no está soportada y no recomiendo usarlo sobre esta.x MySQL 5.x (local or remote) or a Nagios compatible monitoring system PHP 5. los nuevos parámetros en host / servicios). . mkdir mkdir mkdir mkdir -p /etc/nagiosql/hosts /etc/nagiosql/services -p /etc/nagiosql/backup/hosts /etc/nagiosql/backup/services Modificación de permisos.2.e.x/3. De hecho hay al menos un par de detalles que no funcionan y por supuesto no soportará las nuevas funcionalidades de Nagios Core 4 (p. Los creamos. . nagios /etc/nagios/nagios.cfg 660 /etc/nagios/resource.nagios /usr/local/nagios/var/rw/nagios.nagios /etc/nagiosql Además necesitamos darle permisos al usuario de apache (nagiosql es una app que corre sobre apache) a algunos ficheros de configuración de Nagios.e. usando usuario de apache y grupo de nagios. En nuestro caso según realizamos la instalación previa podíamos haber usado un grupo común a ambos usuarios (nagioscmd) pero lo realizaremos según la documentación de NagiosQL.cfg 660 /usr/local/nagios/etc/nagios. Para un fácil copy / paste un par de ejemplos: En una instalación compilada de Nagios sería habitualmente con las siguientes rutas: chown chown chown chown chown chown chmod chmod chmod chmod chmod chmod -R apache.log 770 /usr/local/nagios/var/spool/checkresults En una instalación por paquetes en Redhat / CentOS deberían ser las siguientes: chown chown chown chown chown chown chmod chmod chmod chmod chmod chmod -R apache.cfg -R apache.23/02/2015 Necesitamos darle a nuestro directorios permisos para que tanto el usuario de nagios como el de apache puedan acceder a este.nagios /usr/local/nagios/var/spool/checkresults 660 /usr/local/nagios/etc/resource. con “locate php.nagios /usr/local/nagios/etc/nagios.cfg 660 /usr/local/nagios/etc/cgi. chown -R apache.cfg -R apache.nagios /etc/nagios/resource.nagios /var/spool/nagios/cmd/nagios.cfg -R apache.cfg -R apache.auto_start = 0 .cfg 660 /etc/nagios/cgi.cfg 660 /usr/local/nagios/var/rw/nagios.cmd 660 /usr/local/nagios/var/nagios. mkdir /opt/nagiosql chown apache /opt/nagiosql/ Localizamos nuestro fichero de configuración php.nagios /usr/local/nagios/var/nagios. Lo realizaremos según la documentación de NagiosQL.cfg -R apache.nagios /usr/local/nagios/etc/cgi.cmd -R apache.nagios /etc/nagios/cgi.ini).nagios /usr/local/nagios/etc/resource.cmd 660 /var/log/nagios/nagios. En Centos/Redhat está en /etc/php.cmd -R apache.cfg -R apache.nagios /var/log/nagios/nagios. Verificamos que los parámetros siguientes tengan este valor: file_uploads = On session.ini.log -R apache.cfg 660 /var/spool/nagios/cmd/nagios.log -R apache.log 770 /usr/local/nagios/var/spool/checkresults Configuración de Servidor Apache Preparamos un directorio donde se alojará nuestra página de NagiosQL.ini (p.nagios /usr/local/nagios/var/spool/checkresults 660 /etc/nagios/nagios. tar. descomprimimos inicialmente en nuestro home y movemos los archivos: tar zxfv nagiosql_320. “America/Bogota”. Crearemos en nuestro servidor web un fichero de configuración de apache para NagiosQL.ini nos indica una página del manual de PHP donde ver las configuraciones de zona. p.deny Allow from all </Directory> Reiniciamos nuestro servidor de apache.23/02/2015 date. … En el php.conf Podemos configurarlo de forma básica la autentificación (usará autentificación de acceso a la BBDD mysql) Alias /nagiosql "/opt/nagiosql" <Directory "/opt/nagiosql"> Options None AllowOverride None Order allow. Creación del fichero de configuración de apache.timezone = "Europe/Madrid" El valor de date. Instalación de NagiosQL Debemos descomprimir el sofware en la carpeta para apache que creamos para alojar este y darle los permisos adecuados para nuestro usuario de apache. En Centos / Redhat será: /etc/httpd/conf.timezone por supuesto variará según donde estés… “America/Buenos_Aires”.gz mv nagiosql32/* /opt/nagiosql/ chown -R apache /opt/nagiosql chmod 750 /opt/nagiosql/config Reiniciamos apache y ya podemos acceder a nuestra página web: http://server_nagios/nagiosql Nos aparecerá el Wizard de instalación y configuración de este.d/nagiosql.e. . “America/Mexico_City”. Nos creará la BBDD y nos dará un aviso “Please delete the install directory to continue!” rm -rf /opt/nagiosql/install Cargamos la app de nagiosql y ya la tenemos funcionando (accedemos con el usuario admin que creamos en el asistente previo): http://servidor/nagiosql/ Instalación de Servicepacks de NagiosQL Nagiosql publica periódicamente servicepacks que básicamente consisten en la colección de archivos que han cambiado desde la publicación de la versión de versión a la que aplican. El resto lo dejamos por defecto. El asistente hace bien su trabajo y solo es necesario añadir  Administrative Database Password (Password de administración de nuestro mysql)  NagiosQL User Setup: La pass que tendrá nuesrtousuario admin de Nagiosql en mysql.: cp -R /opt/nagiosql /opt/nagiosql.e.23/02/2015 Empezamos la instalación donde chequeará que cumplimos todas las dependencias y si no es así nos indicará lo que no cumplimos. Posteriormente nos aparecerán los datos necesarios para crear la BBDD.BCK . Para aplicarlos hay que bajar el zip. p. Podemos solucionarlo instalado los necesario y refrescando la página inicial de configuración y pinchando de nuevo “Start Installation”. Podemos marcar también la casilla de “Import Nagios sample config” si queremos partir de una BBDD con algunos ejemplos de objetos Nagios. descomprimir y copiar encima de nuestra instalación. Realizamos primero una copia de nuestro directorio por si acaso. Se quejará de que no tiene objetos.2.2.cfg cfg_file=/etc/nagiosql/timeperiods.cfg cfg_file=/etc/nagiosql/hostdependencies.cfg.0_SP1/* /opt/nagiosql/ -R unzip nagiosql_320_sp2.zip cp NagiosQL_3. Modificar la configuración de Nagios para que use los ficheros generados por NagiosQL. Primero: debemos comentar cualquier referencia cgf_file y cfg_dir.cfg cfg_file=/etc/nagiosql/hostescalations.0_sp1.0_SP2/* /opt/nagiosql/ -R Reiniciamos / recargamos Apache. Segundo: añadimos las siguientes líneas: cfg_file=/etc/nagiosql/contacttemplates.cfg cfg_file=/etc/nagiosql/hosttemplates. Para una instalación de Nagios 3/4 compilado los valores habituales a cambiar serian: .cfg cfg_dir=/etc/nagiosql/hosts cfg_dir=/etc/nagiosql/services Debemos asegurarnos también que el siguiente valor para que NagiosQL pueda reiniciar Nagios: check_external_commands=1 En este momento nos hemos quedado sin datos en Nagios hasta que configuremos objetos desde NagiosQL así que si reiniciamos Nagios no arrancará. Configuración de Nagios Por último nos falta lo más importante.cfg cfg_file=/etc/nagiosql/servicetemplates.cfg cfg_file=/etc/nagiosql/servicedependencies.cfg cfg_file=/etc/nagiosql/hostextinfo.cfg #cfg_file=/etc/nagiosql/serviceescalation.cfg cfg_file=/etc/nagiosql/commands.cfg cfg_file=/etc/nagiosql/servicegroups.cfg cfg_file=/etc/nagiosql/contacts.23/02/2015 Descomprimimos y copiamos cada uno de los parches sobre los archivos originales: unzip nagiosql_3. Modificamos nuestro fichero nagios.cfg cfg_file=/etc/nagiosql/hostgroups.cfg cfg_file=/etc/nagiosql/contactgroups.zip cp NagiosQL_3.cfg cfg_file=/etc/nagiosql/serviceextinfo. Configuración Inicial mínima de NagiosQL Accedemos a NagiosQL y los primero que haremos para tener un funcionamiento mínimo será:  Menú Administration / Config Targets / localhost / editar (el icono de herramientas).2. cfg En general. A no ser que no marcáramos durante la instalación la opción “Import Nagios sample config”. Para empezar a analizarlo nos valen esos objetos pero debemos decirle que genere los ficheros de configuración a partir de estos. servicios. Sobre Nagios 3 todo debería ir ya perfecto.23/02/2015 Nagios Import Nagios Nagios Nagios Nagios base directory: /usr/local/nagios/etc/ directory: /usr/local/nagios/etc/ command file: /usr/local/nagios/var/rw/nagios. Lo haremos desde Menú Tools / Nagios control . Vamos ejecutando todas las opciones:  Write monitoring data  Write additional data  Check configuration files  Restart Nagios. Generar objetos a partir de los ejemplos que trae instalados. (Redhat.…). CentOS): Nagios Import Nagios Nagios Nagios Nagios base directory: /etc/nagios/ directory: /etc/nagios/objects/ command file: /var/spool/nagios/cmd/nagios. da igual como esté instalado.cmd binary file: /usr/sbin/nagios process file: /var/run/nagios.e.pid config file: /etc/nagios/nagios. NagiosQL trae configurados algunos objetos (hosts. Algún otro problema con Nagios 4 también documentado. Debemos realizar un pequeño cambio en un fichero PHP detallado en este artículo. A partir de aquí ya tenemos listo para usar nuestro NagiosQL. Si somos intrépidos y a día de hoy hemos instalado NagiosQL sobre Nagios 4… no se realizará el restart desde esta opción de NagiosQL (aunque diga que si). .lock config file: /usr/local/nagios/etc/nagios. busca cuidadosamente los ficheros que tienes que configurarle a NagiosQL ya que la mayoría de los posibles errores que puedan surgir están en esta configuración y en los permisos.cmd binary file: /usr/local/nagios/bin/nagios process file: /usr/local/nagios/var/nagios.cfg Para una instalación de Nagios instalado por paquetes p.