LibreNMS es una herramienta de monitorización de red gratuita y de código abierto para el sistema operativo Linux. Puedes supervisar distintos sistemas operativos como Linux, Windows, FreeBSD y varios dispositivos de red como Cisco, Juniper, Foundry, FreeBSD, Brocade y muchos más con LibreNMS. Utiliza los protocolos SNMP, ARP, CDP, FDP, LLDP, OSPF y BGP para autodescubrir toda la red. Tiene una interfaz web sencilla y fácil de usar que te ayuda a supervisar todos los dispositivos desde el navegador web. Tiene un rico conjunto de funciones que incluyen, descubrimiento automático, alertas personalizables, acceso a la API, actualizaciones automáticas y muchas más.
En este tutorial, te mostraremos paso a paso cómo instalar LibreNMS en Ubuntu 20.04.
Requisitos previos
- Un servidor que ejecute Ubuntu 20.04.
- Una contraseña de root configurada.
Cómo empezar
En primer lugar, se recomienda actualizar los paquetes de tu sistema a la última versión. Puedes hacerlo con el siguiente comando:
apt-get update -y
Tras actualizar todos los paquetes, instala todas las dependencias necesarias para LibreNMS con el siguiente comando:
apt-get install rrdtool whois fping imagemagick graphviz mtr-tiny nmap python3-mysqldb snmp snmpd python3-pip python3-memcache mtr-tiny acl unzip git curl wget -y
Una vez instaladas todas las dependencias, puedes pasar al siguiente paso.
Instalar el servidor LEMP
A continuación, tendrás que instalar el servidor web Nginx, el servidor MariaDB, PHP y otras extensiones PHP en tu servidor. Puedes instalarlos todos ejecutando el siguiente comando:
apt-get install nginx mariadb-server php php-pear php-cgi php-common php-curl php-mbstring php-gd php-mysql php-bcmath php-imap php-json php-xml php-snmp php-fpm php-zip -y
Después de instalar todos los paquetes, tendrás que establecer la zona horaria en tu archivo php.ini.
Primero, busca la zona horaria de tu sistema con el siguiente comando:
cat /etc/timezone
Deberías ver el siguiente resultado:
Etc/UTC
A continuación, edita ambos archivos php.ini con el siguiente comando:
nano /etc/php/7.4/fpm/php.ini nano /etc/php/7.4/cli/php.ini
Define la zona horaria de tu sistema como se muestra a continuación:
date.timezone = Etc/UTC
Guarda y cierra el archivo cuando hayas terminado. A continuación, reinicia el servicio PHP-FPM para aplicar los cambios:
systemctl restart php7.4-fpm
Cuando hayas terminado, puedes pasar al siguiente paso.
Configurar la base de datos MariaDB
A continuación, tendrás que crear una base de datos y un usuario para LibreNMS.
En primer lugar, inicia sesión en el shell de MariaDB con el siguiente comando:
mysql
Una vez iniciada la sesión, crea una base de datos y un usuario con el siguiente comando:
MariaDB [(none)]> create database librenmsdb CHARACTER SET utf8 COLLATE utf8_unicode_ci; MariaDB [(none)]> grant all privileges on librenmsdb.* to librenms@localhost IDENTIFIED by "password";
A continuación, vacía los privilegios y sal del shell MariaDB con el siguiente comando:
MariaDB [(none)]> flush privileges; MariaDB [(none)]> exit;
A continuación, edita el archivo de configuración de MariaDB y añade algunos ajustes deseados:
nano /etc/mysql/mariadb.conf.d/50-server.cnf
Añade las siguientes líneas dentro de la sección [mysqld]:
innodb_file_per_table=1 sql-mode="" lower_case_table_names=0
Guarda y cierra el archivo y reinicia el servicio MariaDB para aplicar los cambios:
systemctl restart mariadb
En este punto, tu MariaDB está configurada. Ahora puedes pasar al siguiente paso.
Instalar y configurar LibreNMS
En primer lugar, tendrás que crear un usuario independiente para ejecutar LibreNMS. Puedes añadirlo con el siguiente comando:
useradd -r -M -d /opt/librenms librenms
A continuación, añade el usuario librenms al grupo www-data con el siguiente comando:
usermod -a -G librenms www-data
A continuación, cambia el directorio a /opt y descarga la última versión de LibreNMS con el siguiente comando:
cd /opt git clone https://github.com/librenms/librenms.git librenms
A continuación, crea un archivo de registro para LibreNMS con el siguiente comando:
touch /opt/librenms/logs/librenms.log
A continuación, copia el archivo de configuración SNMP de ejemplo con el siguiente comando:
cp /opt/librenms/snmpd.conf.example /etc/snmp/snmpd.conf
A continuación, edita el archivo snmpd.conf:
nano /etc/snmp/snmpd.conf
Busca la siguiente línea:
com2sec readonly default RANDOMSTRINGGOESHERE
Y, sustitúyela por la siguiente línea
com2sec readonly default mysnmpserverkey
Guarda y cierra el archivo y, a continuación, descarga el binario de la distro SNMP y cópialo en la ubicación deseada:
curl -o distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro chmod +x distro mv distro /usr/bin/distro
A continuación, reinicia el servicio SNMP para aplicar los cambios:
systemctl restart snmpd
A continuación, también tendrás que copiar el archivo cron y logrotate de LibreNMS a la ubicación deseada. Puedes copiarlos con el siguiente comando:
cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms
A continuación, cambia el directorio a librenms e instala las depemdencias necesarias con el siguiente comando:
cd /opt/librenms ./scripts/composer_wrapper.php install --no-dev
Una vez instaladas todas las dependencias, cambia la propiedad del directorio librenms y dale los permisos necesarios con el siguiente comando:
chown -R www-data:librenms /opt/librenms chmod -R 775 /opt/librenms setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/ setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
Cuando hayas terminado, puedes pasar al siguiente paso.
Configurar Nginx para LibreNMS
A continuación, tendrás que crear un archivo de configuración del host virtual Nginx para LibreNMS. Puedes crearlo con el siguiente comando:
nano /etc/nginx/conf.d/librenms.conf
Añade las siguientes líneas:
server {
listen 80;
server_name librenms.example.com;
root /opt/librenms/html;
index index.php;
charset utf-8;
gzip on;
gzip_types text/css application/javascript text/javascript application/x-javascript image/svg+xml text/plain text/xsd text/xsl text/xml image/x-icon;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location /api/v0 {
try_files $uri $uri/ /api_v0.php?$query_string;
}
location ~ \.php {
include fastcgi.conf;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
location ~ /\.ht {
deny all;
}
}
Guarda y cierra el archivo y luego comprueba si Nginx tiene algún error de sintaxis con el siguiente comando:
nginx -t
Deberías ver la siguiente salida:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
A continuación, reinicia el servicio Nginx para aplicar los cambios:
systemctl restart nginx
También puedes comprobar el estado del servicio Nginx con el siguiente comando:
systemctl status nginx
Deberías obtener la siguiente salida:
? nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2020-09-05 06:15:20 UTC; 4min 5s ago
Docs: man:nginx(8)
Process: 28239 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 28250 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 28253 (nginx)
Tasks: 3 (limit: 2353)
Memory: 3.4M
CGroup: /system.slice/nginx.service
??28253 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
??28254 nginx: worker process
??28255 nginx: worker process
Sep 05 06:15:20 ubuntu2004 systemd[1]: Starting A high performance web server and a reverse proxy server...
Sep 05 06:15:20 ubuntu2004 systemd[1]: Started A high performance web server and a reverse proxy server.
Una vez que hayas terminado, puedes continuar con el siguiente paso.
Accede a la interfaz web de LibreNMS
Ahora, abre tu navegador web y accede a LibreNMS utilizando la URL http://librenms.example.com. Se te redirigirá a la página de comprobación previa a la instalación:
Asegúrate de que todas las extensiones necesarias están instaladas y luego haz clic en Configuración de la base de datos. Deberías ver la siguiente página:
Proporciona tu nombre de usuario de la base de datos, el nombre de la base de datos, la contraseña y haz clic en el botón Comprobar credenciales. Cuando lo hayas hecho correctamente, verás la siguiente página:
Ahora, haz clic en el botón Crear base de datos. Deberías ver la siguiente página:
A continuación, haz clic en el botón Crear usuario administrador. Deberías ver la siguiente página:
Proporciona tu nombre de usuario, correo electrónico y contraseña de administrador y haz clic en el botón Añadir usuario. Deberías ver la siguiente página:
A continuación, haz clic en el botón Finalizar la instalación. Deberías ver la siguiente página:
A continuación, haz clic en el botón«Validar la instalación». Deberías ver la página de inicio de sesión de LibreNMS:
Proporciona tu nombre de usuario y contraseña de administrador de LibreNMS y haz clic en el botón Iniciar sesión. Deberías ver el panel de control de LibreNMS:
Conclusión
Enhorabuena! has instalado y configurado correctamente la herramienta de monitorización de red LibreNMS en el servidor Ubuntu 20.04. Ahora puedes añadir un dispositivo o host y empezar a monitorizar desde el panel de control de LibreNMS. No dudes en preguntarme si tienes alguna duda.