웹사이트 검색

Debian 11/10에 LibreNMS 모니터링 도구를 설치하는 방법

LibreNMS는 네트워크 장치에 대한 광범위한 모니터링 기능을 제공하는 모든 기능을 갖춘 오픈 소스 네트워킹 모니터링 도구입니다.

주요 기능은 다음과 같습니다:

  • ARP, SNMP, BGP, OSPF, LLDP 및 FDP 프로토콜을 사용하여 전체 네트워크를 자동으로 검색합니다.
  • 고도로 사용자 정의가 가능하고 이메일, Slack 및 기타 채널을 통해 경고를 보내도록 조정할 수 있는 경고 시스템입니다.
  • 간단하고 쉽게 사용자 정의할 수 있는 대시보드입니다.
  • 모니터링 서버의 데이터를 관리하고 그래프로 표시하기 위한 완전히 광범위한 API입니다.
  • 광범위한 장치 지원 – Cisco, Juniper, HP 등과 같은 광범위한 하드웨어 공급업체를 지원합니다.
  • 자동 업데이트 및 버그 수정.
  • 다단계 인증.
  • Android 및 iOS 앱에 대한 기본 지원.
  • 그리고 더 많은.

이 가이드에서는 Debian 11/10에 LibreNMS 모니터링 도구를 설치합니다.

1단계: Nginx, MariaDB 및 PHP 설치

시작하려면 다음과 같이 리포지토리를 새로 고치고 필수 구성 요소 패키지를 설치하십시오.

sudo apt update
sudo apt install software-properties-common wget apt-transport-https

다음 단계는 Nginx와 LibreNMS 모니터링 도구에 필요한 컬, git, SNMP, Python 패키지와 같은 추가 패키지를 설치하는 것입니다.

따라서 다음 명령을 실행하십시오.

sudo apt install nginx-full curl acl fping graphviz composer git imagemagick mtr-tiny nmap python3-pip python3-memcache python3-mysqldb python3-dotenv python3-pymysql rrdtool snmp snmpd whois python3-redis python3-systemd python3-setuptools python3-systemd

다음으로 MariaDB 데이터베이스 서버, PHP 및 LibreNMS 모니터링 도구에 필요한 추가 PHP 확장을 설치합니다.

sudo apt install mariadb-server php php-fpm php-cli php-xml php-common php-gd php-json php-snmp php-pdo php-mysql php-zip php-curl php-mbstring php-pear php-bcmath

설치한 후에는 표시된 대로 Nginx, php-fpm, MariaDB 및 SNMP 서비스를 활성화해야 합니다.

sudo systemctl enable --now nginx
sudo systemctl enable --now php7.4-fpm
sudo systemctl enable --now mariadb
sudo systemctl enable --now snmpd.service

2단계: PHP용 TimeZone 구성

다음 단계에서는 PHP 시간대를 구성하거나 설정해야 합니다. 이는 기본 PHP 구성 파일인 php.ini 파일에서 수행됩니다.

선호하는 편집기를 사용하여 다음 경로의 php.ini 구성 파일에 액세스하세요.

sudo nano /etc/php/7.4/fpm/php.ini
sudo nano /etc/php/7.4/cli/php.ini

date.timezone 매개변수로 이동하여 해당 시간대로 설정합니다. 지원되는 모든 시간대의 전체 목록을 보려면 공식 PHP 사이트를 방문하세요.

이 예에서는 시간대를 UTC로 설정합니다.

date.timezone = UTC

그런 다음 변경 사항을 저장하고 파일을 종료합니다.

3단계: LibreNMS용 데이터베이스 생성

이 단계에서는 LibreNMS 설치를 위한 데이터베이스를 생성합니다. 하지만 먼저 다음 스크립트를 실행하여 데이터베이스를 안전하게 보호해 보겠습니다.

sudo mysql_secure_installation

MariaDB 루트 비밀번호를 생성하고, 익명 사용자를 제거하고, 데이터베이스를 테스트하고, 마지막으로 원격 루트 로그인을 허용하지 않는 방법을 안내하는 자세한 프롬프트를 따르십시오.

다음으로 MariaDB에 로그인합니다.

sudo mysql -u root -p

그런 다음 다음 명령을 실행하여 데이터베이스 및 데이터베이스 사용자를 생성하고 데이터베이스 사용자에게 모든 권한을 할당합니다.

CREATE DATABASE librenms_db CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER 'librenms_user'@'localhost' IDENTIFIED BY 'P@ssword321'; 
GRANT ALL PRIVILEGES ON librenms_db.* TO 'librenms_user'@'localhost';

그런 다음 변경 사항을 저장하고 MariaDB 프롬프트를 종료합니다.

FLUSH PRIVILEGES;
EXIT;

일부 데이터베이스 미세 조정이 필요합니다. 따라서 표시된 MariaDB 구성 파일을 엽니다.

sudo vim /etc/mysql/mariadb.conf.d/50-server.cnf

그런 다음 'mysqld' 섹션에 다음 코드 줄을 붙여넣습니다.

innodb_file_per_table=1
lower_case_table_names=0

변경 사항을 저장하고 파일을 종료합니다. 변경 사항을 적용하려면 데이터베이스 서버를 다시 시작하세요.

sudo systemctl restart mariadb

4단계: LibreNMS 사용자 추가

또한 새로운 LibreNMS 사용자를 생성해야 합니다. 이는 LibreNMS가 실행될 사용자입니다. 이 예에서는 다음 속성을 사용하여 librenms라는 사용자를 생성합니다.

sudo useradd librenms -d /opt/librenms -M -r -s /bin/bash
sudo usermod -aG librenms www-data
  • -d 옵션은 librenms 사용자의 홈 디렉토리를 /opt/librenms 디렉토리로 설정합니다.
  • -r 옵션은 librenms 사용자를 시스템 사용자로 구성합니다.
  • -M 옵션은 -d 옵션을 사용하여 이미 정의되었으므로 사용자에 대한 홈 디렉토리 생성을 건너뜁니다.
  • -s 옵션은 쉘 유형(이 경우 bash)을 지정합니다.

5단계: LibreNMS Git 리포지토리 복제

이제 기어를 바꿔서 LibreNMS git 저장소를 복제하여 설정을 시작하겠습니다.

다음 명령을 실행하여 Git 저장소를 복제하세요.

cd /opt
sudo git clone https://github.com/librenms/librenms.git

그런 다음 홈 디렉터리로 다시 전환합니다.

cd  ~

다음으로 Librenms 홈 디렉토리에 디렉토리 소유권과 권한을 할당해야 합니다. 이를 달성하려면 다음 명령을 실행하십시오.

sudo chown -R librenms:librenms /opt/librenms
sudo chmod 771 /opt/librenms

또한 setfacl 명령을 사용하여 Librenms 홈 디렉터리에 대한 액세스 제어 목록을 수정합니다. 이는 Librenms 그룹에 홈 디렉터리의 하위 디렉터리에 대한 읽기 및 쓰기 권한을 부여합니다.

sudo setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
sudo setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

6단계: PHP 종속성 설치

LibreNMS 모니터링 도구를 설정하는 동안 PHP에 일부 종속성이 필요합니다. 이렇게 하려면 librenmsuser로 로그인해야 합니다.

sudo su - librenms

다음으로, 다음과 같이 모든 PHP 종속성을 설치합니다.

./scripts/composer_wrapper.php install --no-dev

종속성 설치가 완료되면 librenms 사용자를 종료합니다.

exit

7단계: LibreNMS 설치를 위해 PHP-FPM 구성

계속해서 LibreNMS를 지원하려면 PHP-FPM을 몇 가지 변경해야 합니다.

이를 달성하기 위해. 기본 풀 구성 파일인 'www.conf' 파일을 'librenms.conf' 파일에 다음과 같이 복사합니다.

sudo cp /etc/php/7.4/fpm/pool.d/www.conf /etc/php/7.4/fpm/pool.d/librenms.conf

다음으로 'librenms.conf' 파일을 편집합니다.

sudo nano /etc/php/7.4/fpm/pool.d/librenms.conf

표시된 대로 사용자 및 그룹 매개변수를 librenms로 변경합니다.

user = librenms
group = librenms

다음으로, 다음과 같이 Listen 속성을 /run/php-fpm-librenms.sock으로 수정합니다.

listen = /run/php-fpm-librenms.sock

변경 사항을 저장하고 구성을 종료합니다. 변경 사항을 적용하려면 PHP-FPM 서비스를 다시 시작해야 합니다.

sudo systemctl restart php7.4-fpm

8단계: SNMP 데몬 구성

SNMP 프로토콜은 네트워크를 통해 관리되는 장치로부터 메트릭이나 정보를 수집하고 구성하는 TCP/IP 프로토콜입니다.

Cacti와 같은 대부분의 모니터링 도구는 SNMP 서비스를 활용하여 원격 호스트에서 정보를 수집합니다. LibreNMS도 마찬가지입니다.

SNMP 서비스를 구성하려면 snmpd.conf.example 파일을 /etc/snmp/snmpd.conf 파일에 복사하세요.

sudo cp /opt/librenms/snmpd.conf.example /etc/snmp/snmpd.conf

다음으로 snmpd.conf 파일을 편집합니다.

sudo vim /etc/snmp/snmpd.conf

RANDOMSTRINGGOESHERE 문자열을 찾습니다.

com2sec readonly  default         RANDOMSTRINGGOESHERE

librenms로 변경하세요.

com2sec readonly  default		  librenms

변경 사항을 저장하고 종료합니다.

다음으로, 관리되는 노드의 OS를 자동으로 감지하여 배포 여부를 구분해주는 파일인 distro 파일을 다운로드 받습니다.

sudo curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro

실행 가능하게 만들고 SNMP 서비스를 다시 시작하십시오.

sudo chmod +x /usr/bin/distro
sudo systemctl restart snmpd

9단계: LibreNMS용 Nginx 구성

Nginx를 기본 웹 서버로 사용하는 경우 LibreNMS를 서버화하려면 추가 단계를 거쳐 이를 구성해야 합니다.

먼저 그림과 같이 Nginx 서버 블록을 생성합니다.

sudo nano /etc/nginx/sites-available/librenms

다음 코드 줄을 붙여넣으세요. server_name 속성에 서버에 등록된 도메인 이름이나 IP 주소를 제공하세요.

server {
  listen      80;
  server_name 23.92.30.144;        
  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/php-fpm.sock;
  }
  location ~ /.ht {
   deny all;
  }
 }

변경 사항을 저장하고 구성 파일을 종료합니다. 다음으로, 표시된 대로 심볼릭 링크를 생성하여 Nginx 서버 블록을 활성화합니다.

sudo ln -s /etc/nginx/sites-available/librenms /etc/nginx/sites-enabled/

그런 다음 Nginx를 다시 시작하여 구성 변경 사항을 적용합니다.

sudo systemctl restart nginx

또한 다음 명령을 실행하여 모든 Nginx 설정이 올바른지 확인할 수 있습니다.

sudo nginx -t

10단계: Logrotate 및 Cron 구성 복사

기본적으로 LibreNMS는 로그를 /opt/librenms/logs 디렉터리에 저장합니다. 시간이 지남에 따라 이는 쉽게 채워지고 공간 문제가 발생할 수 있습니다. 이를 방지하려면 오래된 로그 파일을 교체하는 것이 좋습니다.

따라서 LibreNMS 디렉토리에 있는 logrotate 파일을 /etc/logrotate.d/ 디렉토리에 복사하세요.

sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

마찬가지로 중요한 것은 새 장치의 자동 폴링 및 검색을 허용하려면 다음과 같이 cron 작업 파일을 복사하는 것입니다.

sudo cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms

11단계: 브라우저에서 LibreNMS 설정 완료

브라우저에서 설정을 완료하려면 다음 URL로 이동하세요.

http://server-ip

그러면 표시된 설치 전 체크리스트로 이동됩니다. 모두 괜찮아 보이면 오른쪽에 있는 '데이터베이스' 아이콘을 클릭하세요.

모든 데이터베이스 세부정보를 입력하고 '자격 증명 확인'을 클릭하세요.

데이터베이스 세부정보가 확인되면 '데이터베이스 구축'을 클릭하세요.

이 단계를 마치면 다음 아이콘을 클릭하여 관리자 사용자를 만드세요. 관리자의 사용자 이름, 비밀번호, 이메일을 입력하고 '사용자 추가'를 클릭하세요.

마지막으로 마지막 버튼을 클릭하면 설치가 완료됩니다.

설치 프로그램 '파일 쓰기 실패: /opt/librenms/.env'를 알리는 이 오류가 발생합니다.

하지만 걱정하지 마세요. 제공된 데이터베이스 세부 정보로 /opt/librenms/.env 파일을 수동으로 새로 업데이트하기만 하면 됩니다. 이러한 세부 사항은 귀하의 경우에 따라 다릅니다.

따라서 파일에 액세스하십시오.

sudo nano /opt/librenms/.env

파일의 모든 내용을 삭제하고 위에 제공된 세부정보를 파일에 붙여넣은 후 변경 사항을 저장합니다.

다음으로 돌아가서 '다시 시도' 버튼을 클릭하세요. LibreNMS 로그인 페이지로 이동합니다. 로그인 자격 증명을 입력하고 '로그인'을 클릭하세요.

로그인하면 이런 대시보드가 나타납니다. 여기에서 호스트 추가를 시작하고 다양한 지표를 모니터링할 수 있습니다.

그리고 그게 다야. 이 가이드에서는 Debian 11/10에 LibreNMS 모니터링 도구를 설치하는 과정을 안내했습니다.