Documentation
Table of Contents
3 Instalación desde el código fuente
Es posible obtener la versión más reciente de Zabbix si realizamos la compilación desde el código fuente.
Aquí puedes encontrar un tutorial paso a paso de cómo realizar la instalación de Zabbix desde el código fuente.
1 Instalación de los demonios Zabbix
1 Descargue el archivo fuente
Vaya a la página de descarga de Zabbix y descargue el archivo fuente. Una vez descargado, extraiga las fuentes, ejecutando:
Ingrese la versión correcta de Zabbix en el comando. Debería coincidir con el nombre del archivo descargado.
2 Crear la cuenta usuario
Es necesario tener una cuenta de usuario sin privilegios para todos los procesos del demonio Zabbix. Si el demonio Zabbix es iniciado desde una cuenta de usuario sin privilegios, los procesos correran como ese usuario.
Sin embargo, si el demonio es iniciado desde una cuenta 'root', los procesos cambiarán a ser ejecutados como una cuenta de usuario 'zabbix'. Para crear esa cuenta de usuario (en su propio grupo, "zabbix"),
en sistemas basados en RedHat, ejecutar:
groupadd --system zabbix
useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbixen sistemas basados en Debian, ejecutar:
addgroup --system --quiet zabbix
adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbixLos procesos Zabbix no necesitan un directorio home, por lo que no recomendamos crear dicho directorio. Sin embargo, si está usando alguna funcionalidad que lo requiera (por ejemplo, guardar las credenciales MySQL en $HOME/.my.cnf) tendrá la libertad de crearlo utilizando los siguientes comandos.
En sistemas basados en RedHat, ejecutar:
En sistemas basados en Debian, ejecutar:
No se requiere una cuenta de usuario separado para la instalación del Zabbix frontend.
Si el Zabbix server y el agent están ejecutandose en la misma máquina, es recomendable utilizar cuentas de usuario diferentes tanto para ejecutar el server como para el agent. De lo contrario, si ambos se están ejecutando desde el mismo usuario, el agent podrá acceder al archivo de configuración del server y cualquier usuario con nivel de Admin en Zabbix facilmente podrá obtener, por ejemplo, la contraseña de la base de datos.
Ejecutar Zabbix como root, bin, o cualquier otra cuenta de usuario con permisos especiales es considerado un riesgo de seguridad
3 Crear la base de datos de Zabbix
Es necesario tener una base de datos para los demonios Zabbix server y proxy, así como para el Zabbix Frontend. La base de datos no es necesaria para ejecutar el Zabbix agent.
Aquí puedes encontrar los scripts SQL para crear el esquema de la base de datos, así como insertar el conjunto de datos. La base de datos para el Zabbix proxy necesita solo el esquema mientras que la base de datos para el Zabbix server requiere también contar con el conjunto de datos encima del esquema.
Una vez creada la base de datos de Zabbix, proceda con los siguientes pasos para poder compilar Zabbix.
4 Configurar las fuentes
Se requiere C99 con extensiones GNU para compilar un servidor Zabbix, un proxy Zabbix o un agente Zabbix. Esta versión se puede especificar explícitamente configurando CFLAGS="-std=gnu99":
Si se instala desde el repositorio Git de Zabbix, es necesario ejecutar primero:
./bootstrap.sh
Al configurar las fuentes para un servidor o proxy Zabbix, debe especificar el tipo de base de datos que se utilizará. Solo se puede compilar un tipo de base de datos con un proceso de servidor o proxy a la vez.
Para ver todas las opciones de configuración admitidas, dentro del directorio de origen de Zabbix extraído, ejecute:
Para configurar las fuentes para un servidor y agente Zabbix, puede ejecutar algo como:
./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmiPara configurar las fuentes para un servidor Zabbix (con PostgreSQL, etc.), puede ejecutar:
Para configurar las fuentes para un proxy Zabbix (con SQLite, etc.), puede ejecutar:
Para configurar las fuentes para un agente Zabbix, puede ejecutar:
o, para el agente Zabbix 2:
Se requiere un entorno Go configurado con una versión de Go compatible actualmente para compilar el agente Zabbix 2. Consulte go.dev para obtener instrucciones de instalación.
Notas sobre las opciones de compilación:
- Las utilidades de línea de comandos zabbix_get y zabbix_sender se compilan si se utiliza la opción --enable-agent.
- Se requieren las opciones de configuración --with-libcurl y --with-libxml2 para la supervisión de máquinas virtuales; también se requiere --with-libcurl para la autenticación SMTP y el agente Zabbix
web.page.*items. Tenga en cuenta que cURL 7.20.0 o superior es obligatorio con la opción de configuración --with-libcurl. - Zabbix siempre compila con la biblioteca PCRE (desde la versión 3.4.0); instalarla no es opcional. --with-libpcre=[DIR] solo permite apuntar a un directorio de instalación base específico, en lugar de buscar en varios lugares comunes los archivos libpcre.
- Puede utilizar el indicador --enable-static para vincular bibliotecas estáticamente. Si planea distribuir binarios compilados entre diferentes servidores, debe utilizar este indicador para que estos binarios funcionen sin las bibliotecas requeridas. Tenga en cuenta que --enable-static no funciona en Solaris.
- No se recomienda utilizar la opción --enable-static al compilar un servidor. Para crear el servidor de forma estática, debe tener una versión estática de cada biblioteca externa necesaria. No existe una comprobación estricta para eso en el script de configuración.
- Agregue una ruta opcional al archivo de configuración de MySQL --with-mysql=/<path_to_the_file>/mysql_config para seleccionar la biblioteca cliente MySQL deseada cuando sea necesario usar una que no se encuentre en la ubicación predeterminada. Es útil cuando hay varias versiones de MySQL instaladas o MariaDB instalada junto con MySQL en el mismo sistema.
- Use el indicador --with-oracle para especificar la ubicación de la API de OCI.
Si ./configure falla debido a bibliotecas faltantes o alguna otra circunstancia, consulte el archivo config.log para obtener más detalles sobre el error. Por ejemplo, si falta libssl, el mensaje de error inmediato puede ser engañoso:
Mientras que config.log tiene una descripción más detallada:
Consulte también:
- Compilación de Zabbix con soporte de cifrado para soporte de cifrado
- Problemas conocidos con la compilación del agente Zabbix en HP-UX
5 Compilar e instalar todo
Si se instala desde el repositorio Git de Zabbix es necesario ejecutar primero lo siguiente:
$ make dbschema
Este paso debe ejecutarse con un usuario con los permisos suficientes (por lo general 'root', o usando sudo).
Cuando ejecutamos make install los binarios de los demonios serán instalados en /usr/local/sbin para (zabbix_server, zabbix_agentd, zabbix_proxy) y /usr/local/bin para los binarios de los clientes (zabbix_get, zabbix_sender).
Para especificar una ubicación distinta a /usr/local, use el parámetro --prefix en el paso previo correspondiente a la configuración del código fuente, por ejemplo --prefix=/home/zabbix. En este caso los binarios del demonio serán instalados bajo <prefix>/sbin, mientras las utilidades bajo <prefix>/bin. Las páginas del manual serán instaladas debajo de <prefix>/share.
6 Revisar y editar archivos de configuración
- editar el archivo de configuración del agente Zabbix /usr/local/etc/zabbix_agentd.conf
Debe configurar este archivo para cada host con zabbix_agentd instalado.
Debe especificar la dirección IP del servidor Zabbix en el archivo. Se denegarán las conexiones desde otros hosts.
- editar el archivo de configuración del servidor Zabbix /usr/local/etc/zabbix_server.conf
Debe especificar el nombre de la base de datos, el usuario y la contraseña (si utiliza alguno).
El resto de los parámetros le servirán con sus valores predeterminados si tiene una instalación pequeña (hasta diez hosts monitoreados). Sin embargo, debe cambiar los parámetros predeterminados si desea maximizar el rendimiento del servidor Zabbix (o proxy).
- si ha instalado un proxy Zabbix, edite el archivo de configuración del proxy /usr/local/etc/zabbix_proxy.conf
Debe especificar la dirección IP del servidor y el nombre de host del proxy (debe ser conocido por el servidor), así como el nombre de la base de datos, el usuario y la contraseña (si se usa alguno).
Con SQLite, se debe especificar la ruta completa al archivo de la base de datos; no se requieren el usuario y la contraseña de la base de datos.
7 Ejecutar los demonios
Ejecute zabbix_server en el lado del servidor.
Asegúrese de que su sistema permita la asignación de 36 MB (o un un poco más) de memoria compartida; de lo contrario, es posible que el servidor no se inicie y verá "No se puede asignar memoria compartida para <tipo de caché>". en el archivo de registro del servidor. Esto puede suceder en FreeBSD, Solaris 8.
Ejecute zabbix_agentd en todas las máquinas monitoreadas.
Asegúrese de que su sistema permita la asignación de 2 MB de memoria compartida; de lo contrario, es posible que el agente no se inicie y verá "No se puede asignar memoria compartida al recopilador" en el archivo de registro del agente. Esto puede suceder en Solaris 8.
Si ha instalado el proxy Zabbix, ejecute zabbix_proxy.
2 Instalar la interfaz web de Zabbix
Copiar los archivos PHP
El Zabbix frontend está escrito en PHP, así que para ejecutarlo es necesario contar con un servidor web soportado. La instalación se realiza simplemente copiando los archivos PHP desde el directorio ui al directorio de documentos HTML del servidor web.
Algunas de las ubicaciones comunes para el directorio documentos HTML en servidores web Apache incluye:
- /usr/local/apache2/htdocs (directorio por defecto cuando se instala Apache desde el código fuente)
- /srv/www/htdocs (OpenSUSE, SLES)
- /var/www/html (Debian, Ubuntu, Fedora, RHEL)
Es altamente recomendable utilizar un subdirectorio en lugar del directorio HTML raíz. Para crear el subdirectorio y copiar los archivos del Zabbix frontend en el, ejecute los siguientes comandos, remplazando el directorio actual:
Si planea utilizar algún idioma diferente al inglés, vea Instalación de idiomas adicionales para el frontend para las instrucciones.
Instalar el frontend
Por favor vea la página Instalar la interfaz web de Zabbix para información referente al asistente de instalación del Zabbix frontend.
3 Instalación de Java Gateway
Solo es necesario instalar Java Gateway si desea supervisar las aplicaciones JMX. Java Gateway es liviano y no requiere una base de datos.
Para instalar desde las fuentes, primero descargue y extraiga el archivo fuente.
Para compilar Java Gateway, ejecute el script ./configure con la opción --enable-java. Es aconsejable que especifique la opción --prefix para solicitar una ruta de instalación distinta a la predeterminada /usr/local, ya que la instalación de Java Gateway creará un árbol de directorios completo, no solo un único ejecutable.
Para compilar y empaquetar Java Gateway en un archivo JAR, ejecute make. Tenga en cuenta que para este paso necesitará los ejecutables javac y jar en su ruta.
Ahora tiene un archivo zabbix-java-gateway-$VERSION.jar en src/zabbix_java/bin. Si se siente cómodo ejecutando Java gateway desde src/zabbix_java en el directorio de distribución, puede continuar con las instrucciones para configurar y ejecutar Java gateway. De lo contrario, asegúrese de tener suficientes privilegios y ejecute make install.
Continúe con la configuración para obtener más detalles sobre cómo configurar y ejecutar Java gateway.
4 Instalación del servicio web Zabbix
Solo es necesario instalar el servicio web Zabbix si desea utilizar informes programados.
Para instalarlo desde las fuentes, primero descargue y extraiga el archivo fuente.
Para compilar el servicio web Zabbix, ejecute el script ./configure con la opción --enable-webservice.
Se requiere un entorno configurado de una versión Go 1.13+ para crear el servicio web Zabbix.
Ejecute zabbix_web_service en la máquina donde está instalado el servicio web:
Continúe con la configuración para obtener más detalles sobre cómo configurar la generación de informes programados.