Knowledge WiKibase

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
{{htmlmetatags>metatag-keywords=(nms,librenms,Network management system,Система управления сетью,Network monitoring system,Система наблюдения за сетью,ping мониторинг,пинг мониторинг,icmp мониторинг,snmp мониторинг,ping,snmp,ping monitoring,пинг monitoring,icmp monitoring,snmp monitoring,Icinga2,Icinga 2,Icinga web 2,Icingaweb2,Icinga director,raspberry pi,pi 4 model b,raspberry pi 4 model b,Raspberry Pi OS 64-bit,Raspberry Pi OS,debian 11,bullseye,debian 11 bullseye,network monitoring,мониторинг сети) 
metatag-description=(Настройка Ping-мониторинга устройств в локальной сети.)}}

====== Установка LibreNMS на Raspberry Pi OS (64-bit) ======

Достаточно долгое время у меня [[iot:software:node-red:flows:network_monitoring|работал поток NodeRED]], вполне успешно мониторивший сеть и отправляющий мне уведомления, когда что-то отваливалось. Но к нему у меня была одна претензия -- не было панели управления и ситуативного мониторинга, а пилить ее с помощью плагина [[https://flows.nodered.org/node/node-red-dashboard|node-red-dashboard]] мне совершенно не хотелось! В итоге решился и пошел искать...

Сперва остановился на [[https://icinga.com/|Icinga 2]], но, вдоволь намучившись с установкой и все же [[raspberry_pi:pi_4_model_b:raspberry_pi_os:icinga2:installation|запустив ее]] на 64-битной системе, обнаружил, что это не совсем то, что я ожидал -- "из коробки" оно не работает совершенно! Мало того, что помимо ядра нужно ставить Icinga Web 2, дабы хоть что-то видеть, так еще и Icinga Director, чтобы управлять всем этим не залезая в консоль и конфиги! И все это устанавливается с собирается исключительно с матом... моим матом на всех знакомых и не очень языках! К слову, Icinga Director я так полностью и не уговорил работать... Но не суть, т.к. к тому времени я понял, что это пустая трата времени и средства не соответствуют задаче, т.к. мало поставить, нужно еще и настроить, а при первом  взгляде на все это... становится печально.

{{:raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:nibrenms.png?nolink|}}

Выругавшись, пошел искать дальше и, как позже выяснилось, угадал, т.к. [[https://www.librenms.org/|LibreNMS]] меня более чем удовлетворила! -- ставится не без труда, но вполне быстро и "из коробки" имеет все, что мне нужно((В моих приоритетах, главное -- ICMP и бонусом SNMP, который я все же развернул и доволен, как слон кучей прикольных графиков!))!

===== Установка и настройка =====

Как оказалось, в [[https://docs.librenms.org/Installation/Install-LibreNMS/|официальной документации]] нет варианта инструкции по установке LibreNMS на Debian 11 вместе c Apache((А поставить что-то более-менее сложное на *nix без инструкции и не задолбаться в конец... это надо быть супер-пупер-профессионалом, которым я, увы, не являюсь.)), поэтому в процессе я вел заметки, чтобы собрать все воедино.

Но потом почесал репу, снес Apache и поставил Nginx, что отразил в сей инструкции!

==== Зависимости ====

В репозитории Debian 11 (bullseye) нет PHP 8.x, максимально, что там есть на сегодня, это 7.4, а LibreNMS требуется версия PHP не ниже 8.1. Соответственно, для начала нужно подключить дополнительный репозиторий, а потом установить зависимости:

  - переключаемся в привилегированный режим\\ \\ <code>sudo -s</code>
  - загружаем открытый ключ\\ \\ <code>wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg</code>
  - открываем новый файл конфигурации "apt"\\ \\ <code>nano /etc/apt/sources.list.d/sury-php.list</code>и добавляем в него, сохраняем, закрываем<code>deb https://packages.sury.org/php/ bullseye main</code>
  - обновляем индекс пакетов\\ \\ <code>apt update</code>
  - устанавливаем зависимости\\ \\ 
    - для Nginx\\ \\ <code>apt install acl curl fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php-cli php-curl php-fpm php-gd php-gmp php-json php-mbstring php-mysql php-snmp php-xml php-zip python3-dotenv python3-pymysql python3-redis python3-setuptools python3-systemd python3-pip rrdtool snmp snmpd whois</code>
    - для Apachae2\\ \\ <code>apt install acl curl apache2 fping git graphviz imagemagick libapache2-mod-fcgid mariadb-client mariadb-server mtr-tiny nmap php-cli php-curl php-fpm php-gd php-gmp php-json php-mbstring php-mysql php-snmp php-xml php-zip rrdtool snmp snmpd whois python3-pymysql python3-dotenv python3-redis python3-setuptools python3-systemd python3-pip</code>

:!: //<del>Тут стоит отметить, что я намеренно ставлю версию 8.1, а не последнюю((На сегодня это 8.2.)), т.к.</del> при первоначальной установке я столкнулся с проблемой -- сыпались стили web-интерфейса, не показывались графики и на каждом углу были предупреждения типа "**Exception: Creation of dynamic property ... is deprecated**". В общем, [[https://www.php.net/manual/ru/class.allowdynamicproperties.php|погуглив немного]], я предположил, что это проблема версии PHP. И частично это оказалось верно -- после понижения версии, большая часть предупреждений исчезла, но не все и web-интерфейс не начал нормально работать.//

FIXME //Позже я, конечно, разобрался, что проблема была в опрометчиво установленном мной переключателе "**reporting.dump_errors**" в "Global Settings" -> "System" -> "Reporting", <del>но версию уже менять не стал. Поэтому, скорее всего, можно ставить последнюю, используя оригинальную строку.</del>//

FIXME //Если web-интерфейс LibreNMS дико долго загружается, особенно, там, где есть графики, на вкладке "Alet Rules" или "Global Settings", и непонятно что, а всякие php-fpm и прочие Nginx'ы настроены на самую великую производительность и вы в конец заебались... посмотрите, может у вас тоже включена галочка "**Error reporting**" на странице "About LibreNMS"?!! Если это так, попробуйте... ну так, случайно ее выключить и отчистить кэш... Я офигел!.. Одни маты, чо...//

==== LibreNMS ====

  - Добавляем пользователя "librenms" с указанием домашнего каталога\\ \\ <code>useradd librenms -d /opt/librenms -M -r -s "$(which bash)"</code>
  - меняем каталог и клонируем LibreNMS из GitHub((На сегодня, это версия 23.2.0.))\\ \\ <code>cd /opt && git clone https://github.com/librenms/librenms.git</code>
  - меняем группу и владельца\\ \\ <code>chown -R librenms:librenms /opt/librenms && chmod 771 /opt/librenms</code>
  - устанавливаем ACL\\ \\ <code>setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/</code><code>setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/</code>

==== PHP ====

  - Заходим под пользователем librenms\\ \\ <code>su - librenms</code>
  - устанавливаем дополнительные зависимости PHP((Если используется прокси-сервер или есть ошибки с подключением, [[https://docs.librenms.org/Installation/Install-LibreNMS/#install-php-dependencies|смотрим обходной путь тут]].)) и выходим\\ \\ <code>./scripts/composer_wrapper.php install --no-dev && exit</code>
  - устанавливаем часовой пояс для PHP, раскомментировав параметр "date.timezone" и установив значение в формате "Asia/Vladivostok"((Возможные значения [[https://php.net/manual/en/timezones.php|указаны тут]].)) в секции "[Date]" в двух файлах((Обратите внимание, что путь отличается в зависимости от версии PHP!))\\ \\ <code>nano /etc/php/8.2/fpm/php.ini</code><code>nano /etc/php/8.2/cli/php.ini</code>

==== MySQL ====

  - Открываем конфигурацию MariaDB\\ \\ <code>nano /etc/mysql/mariadb.conf.d/50-server.cnf</code>и в конце секции "[mysqld]" добавляем, сохраняем, закрываем<code>innodb_file_per_table=1
lower_case_table_names=0</code>
  - активируем и перезапускаем службу БД\\ \\ <code>systemctl enable mariadb && systemctl restart mariadb</code>
  - открываем консоль MySQL\\ \\ <code>mysql -u root -p</code>
  - добавляем новую базу данных, создаем пользователя с паролем "password"((Естественно, нужно заменить на свой!)) и даем ему все разрешения на эту базу\\ \\ <code>CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;</code>
  - выходим из консоли\\ \\ <code>exit</code>

==== PHP-FPM ====

Клонируем((Опять же -- разные пути для разных версий PHP!)) конфигурацию по умолчанию и открываем ее

<code>cp /etc/php/8.2/fpm/pool.d/www.conf /etc/php/8.2/fpm/pool.d/librenms.conf && nano /etc/php/8.2/fpm/pool.d/librenms.conf</code>

  - меняем название секции "[www]" на "''[librenms]''",
  - меняем пользователя и группу на "''librenms''",
  - меняем прослушиваемый сокет на "''listen = /run/php-fpm-librenms.sock''".

FIXME Дополнительно можно исправить следующие настройки((По рекомендациям из Интернетов.)):

<code>pm = dynamic
pm.max_children = 50
pm.start_servers = 7
pm.min_spare_servers = 5
pm.max_spare_servers = 10
pm.process_idle_timeout = 10s
pm.max_requests = 500</code>

После этих корректировок из логов пропали предупреждения:

  * "[25-Mar-2023 15:01:02] WARNING: [pool librenms] server reached pm.max_children setting (5), consider raising it" и
  * "[25-Mar-2023 16:41:31] WARNING: [pool librenms] seems busy (you may need to increase pm.start_servers, or pm.min/max_spare_servers), spawning 8 children, there are 0 idle, and 5 total children".

==== Web-сервер ====

По сути, на маленьких проектах работают совершенно одинаково, поэтому...

=== Nginx ===

  - Создаем конфигурацию\\ \\ <code>nano /etc/nginx/sites-enabled/librenms.vhost</code>
  - добавляем в нее, делая правки по желанию и знаниям((Без всего этого, достаточно поправить только "server_name".)), сохраняем, закрываем\\ \\ <code>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 ~ [^/]\.php(/|$) {
  fastcgi_pass unix:/run/php-fpm-librenms.sock;
  fastcgi_split_path_info ^(.+\.php)(/.+)$;
  include fastcgi.conf;
 }
 location ~ /\.(?!well-known).* {
  deny all;
 }
}</code>
  - удаляем конфигурацию по умолчанию\\ \\ <code>rm /etc/nginx/sites-enabled/default</code>
  - перезапускаем Nginx и FPM\\ \\ <code>systemctl restart nginx php8.2-fpm</code>

=== Apache ===

  - Создаем конфигурацию\\ \\ <code>nano /etc/apache2/sites-available/librenms.conf</code>
  - добавляем в нее, делая правки по желанию и знаниям((Без всего этого, достаточно поправить только "ServerName".)), сохраняем, закрываем\\ \\ <code><VirtualHost *:80>
  DocumentRoot /opt/librenms/html/
  ServerName  librenms.example.com

  AllowEncodedSlashes NoDecode
  <Directory "/opt/librenms/html/">
    Require all granted
    AllowOverride All
    Options FollowSymLinks MultiViews
  </Directory>

  # Enable http authorization headers
  <IfModule setenvif_module>
    SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
  </IfModule>

  <FilesMatch ".+\.php$">
    SetHandler "proxy:unix:/run/php-fpm-librenms.sock|fcgi://localhost"
  </FilesMatch>
</VirtualHost></code>
  - отключаем конфигурацию по умолчанию, активируем модули и включаем нашу конфигурацию\\ \\ <code>a2dissite 000-default && a2enmod proxy_fcgi setenvif rewrite && a2ensite librenms.conf</code>
  - перезапускаем Apache и FPM\\ \\ <code>systemctl restart apache2 php8.2-fpm</code>

==== Прочее ====

  - Добавляем конфигурацию автозавершения командной строки\\ \\ <code>ln -s /opt/librenms/lnms /usr/bin/lnms</code><code>cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/</code>
  - добавляем конфигурацию Cron\\ \\ <code>cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms</code>
  - добавляем конфигурацию ротации лог-файлов\\ \\ <code>cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms</code>
  - выходим из пользователя "root"\\ \\ <code>exit</code>

===== Завершение настройки =====

Все! Осталось перейти по адресу сервера браузером и завершить настройку. В конце соглашаемся с прохождением проверки((Если что, туда можно попасть через меню или по прямой ссылке "<nowiki>http://server-addr/validate</nowiki>".)) и доделываем, что оно просит.

===== Резервное копирование =====

Для резервного копирования можно использовать [[raspberry_pi:pi_4_model_b:raspberry_pi_os:bash:scripts:backup|этот скрипт]] с такой конфигурацией((Подробнее в [[https://docs.librenms.org/Support/FAQ/#how-do-i-move-only-the-db-to-another-server|официальной документации]].)):

<file text files.txt>/etc/cron.d/librenms
/etc/php/8.2/fpm/php.ini
/etc/php/8.2/cli/php.ini
/etc/mysql/mariadb.conf.d/50-server.cnf
/etc/php/8.2/fpm/pool.d/librenms.conf
/etc/nginx/sites-enabled/librenms.vhost
/etc/syslog-ng/conf.d/librenms.conf
/etc/snmp/snmpd.conf
/etc/default/rrdcached
/etc/snmp/mysql.cnf
/etc/apt/apt.conf.d/10periodic
/etc/snmp/smart.config
/etc/snmp/systemd.json
/opt/librenms/rrd
/opt/librenms/.env
/opt/librenms/config.php</file>

:!: //Обратите внимание, что в этот список входят файлы конфигураций дополнительных компонентов, упомянутых в других статьях из раздела ниже.//

<file text mysqldbs.txt>librenms</file>

===== Другие статьи =====

  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:configuration:snmp|]]
  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:configuration:extensions|]]
  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:syslog-ng:mikrotik:librenms|]]
  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:configuration:applications|]]
  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:configuration:alerts:internet_ping_check|]]
  * [[raspberry_pi:pi_4_model_b:raspberry_pi_os:librenms:configuration:alerts:extended_icmp_monitoring|]]
Knowledge WiKibase

Инструменты пользователя

Инструменты сайта

Инструменты страницы
