Cách cài đặt LibreNMS trên Debian 11

[theanh]

LibreNMS là một hệ thống giám sát mạng nguồn mở dựa trên PHP và có hỗ trợ tự động khám phá. Đây là một nhánh cộng đồng của phần mềm giám sát Observium được phát hành theo Giấy phép GPLv3. Sử dụng LibreNMS cho phép bạn giám sát các hệ điều hành như Linux, Windows và BSD, đồng thời hỗ trợ nhiều loại phần cứng mạng từ nhiều nhà cung cấp như Aruba, Cisco, Dell, D-Link, HP, Mikrotik, v.v.

Là một hệ thống giám sát đầy đủ tính năng, LibreNMS cung cấp nhiều tính năng với nhiều tích hợp và nhiều giao thức thu thập dữ liệu.

Dưới đây là một số tính năng đáng chú ý của LibreNMS:

• Tự động khám phá toàn bộ mạng của bạn với nhiều giao thức như CDP, BGP, SNMP, OSPF và ARP.
• Nhiều phương pháp cảnh báo bằng email, slacks, IRC, Rocket.chat, Telegram, v.v.
• API mở rộng để quản lý, lập biểu đồ và truy xuất dữ liệu từ hệ thống giám sát của bạn.
• Hỗ trợ hệ thống thanh toán để tạo hóa đơn băng thông dựa trên mức sử dụng hoặc truyền mạng.
• Hỗ trợ nhiều phương pháp xác thực như MySQL, Radius, LDAP, HTTP và Active Thư mục.
• Hỗ trợ Xác thực hai yếu tố
• Nhiều tích hợp với các ứng dụng của bên thứ ba như Graylog, NfSen, Nagios Plugins, Oxidized, RANCID.
• Hỗ trợ nhiều nhà cung cấp phần cứng, hãy kiểm tra nhà cung cấp của bạn tại đây.
• Bảng điều khiển thân thiện với người dùng và có thể tùy chỉnh.
• Giữ phần mềm LibreNMS của bạn với hỗ trợ cập nhật tự động.
• Ứng dụng gốc cho Android và iOS cung cấp chức năng cốt lõi.

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt và cấu hình công cụ giám sát LibreNMS trên Debian 11 Bullseye.

Điều kiện tiên quyết​

Để hoàn thành hướng dẫn này, hãy đảm bảo bạn có các yêu cầu sau:

• Hệ điều hành: Debian 11 Bullseye
• Quyền root

Bây giờ chúng ta hãy bắt đầu cài đặt.

Cài đặt các gói phụ thuộc​

Trong bước đầu tiên này, bạn sẽ cài đặt các gói cơ bản và thiết yếu cho LireNMS. Bạn sẽ cài đặt LEMP Stack, các gói Python, snmpd và các tiện ích hệ thống bổ sung như curl, fping, git và imagemagick.

1. Làm mới và cập nhật kho lưu trữ Debian bằng lệnh sau.

sudo apt update

2. Bây giờ hãy thực hiện lệnh sau để cài đặt các gói phụ thuộc.

sudo apt install acl curl composer fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php7.4-cli php7.4-curl php7.4-fpm php7.4-gd php7.4-gmp php7.4-json php7.4-mbstring php7.4-mysql php7.4-snmp php7.4-xml php7.4-zip python3-dotenv python3-pymysql python3-redis python3-setuptools python3-pip python3-systemd rrdtool snmp snmpd whois

Gõ 'y' để xác nhận cài đặt và nhấn 'Enter' để tiếp tục.

3. Sau khi cài đặt các gói phụ thuộc hoàn tất, hãy thực hiện các lệnh sau để khởi động và kích hoạt các dịch vụ như Nginx, MariaDB, PHP-FPM và snmpd.

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

Bây giờ bạn đã hoàn tất cài đặt các gói phụ thuộc cho LibreNMS.

Thiết lập Người dùng mới librenms​

Trong bước này, bạn sẽ tạo một người dùng hệ thống mới 'librenms'. Công cụ giám sát LibreNMS của bạn sẽ chạy dưới người dùng 'librenms'.

1. Thực hiện lệnh sau để tạo người dùng 'librenms' mới.

useradd librenms -d /opt/librenms -M -r -s "$(which bash)"

Các tùy chọn bạn phải biết:

• -d /opt/librenms: Thiết lập thư mục home mặc định cho người dùng 'librenms' thành '/opt/librenms'.
• -M: Không tạo thư mục home cho người dùng 'librenms'.
• -r: Đặt người dùng này 'librenms' làm người dùng hệ thống.
• -s "$(which bash)": Thiết lập shell mặc định cho người dùng 'librenms'. Shell sẽ là đầu ra của lệnh 'which bash'.

2. Tiếp theo, tạo mật khẩu mới cho người dùng 'librenms' bằng lệnh sau.

passwd librenms

Nhập mật khẩu mạnh mới và lặp lại.

Tiếp tục đến giai đoạn tiếp theo để cấu hình hệ thống của bạn cho cài đặt LibreNMS.

Thiết lập hệ thống múi giờ và PHP​

Thời gian là một phần thiết yếu của việc giám sát. Trong bước này, bạn sẽ thiết lập múi giờ mặc định cho PHP và múi giờ hệ thống, đảm bảo cả hai múi giờ (PHP và hệ thống) đều được đồng bộ hóa và sử dụng cùng một múi giờ.

1. Chỉnh sửa cấu hình 'php.ini' cho PHP-FPM và CLI bằng lệnh sau.

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

Bỏ chú thích tùy chọn 'date.timezone' và đặt múi giờ của bạn sau tùy chọn đó. Trong ví dụ này, chúng tôi sử dụng múi giờ 'Châu Âu/Paris'.

date.timezone = Châu Âu/Paris

Lưu cả hai cấu hình và thoát.

2. Bây giờ hãy khởi động lại PHP-FPM để áp dụng cấu hình mới bằng lệnh sau.

sudo systemctl restart php7.4-fpm

3. Sau đó, thực hiện lệnh timedatectl bên dưới để thiết lập múi giờ hệ thống mặc định thành 'Châu Âu/Paris'.

sudo timedatectl set-timezone Châu Âu/Paris

Bạn đã hoàn tất cấu hình múi giờ cho PHP và hệ thống của mình.

Thiết lập MariaDB và tạo cơ sở dữ liệu​

Trong bước này, bạn sẽ thêm cấu hình cho MariaDB theo yêu cầu của LibreNMS, sau đó tạo cơ sở dữ liệu MariaDB và người dùng mới để cài đặt LibreNMS.

1. Chỉnh sửa cấu hình máy chủ MariaDB '/etc/mysql/mariadb.conf.d/50-server.cnf' bằng trình soạn thảo nano.

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

Thêm cấu hình sau vào phần '[mysqld]'.

[mysqld]
.....
....
innodb_file_per_table=1
lower_case_table_names=0

Lưu cấu hình và thoát.

2. Để áp dụng cấu hình MariaDB mới, hãy khởi động lại dịch vụ bằng lệnh systemctl bên dưới.

sudo systemctl restart mariadb

Bây giờ bạn đã thêm cấu hình bổ sung vào máy chủ MariaDB.

3. Tiếp theo, đăng nhập vào shell MariaDB/MySQL bằng lệnh 'mysql' với tư cách là người dùng 'root' như bên dưới.

mysql -u root -p

Nhập mật khẩu của bạn hoặc nhấn 'Enter' để đăng nhập.

4. Bây giờ hãy thực hiện các truy vấn MariaDB sau để tạo cơ sở dữ liệu mới và người dùng 'librenms'. Và hãy đảm bảo thay đổi mật khẩu 'LibreNMSPassword' bằng mật khẩu mạnh của bạn.

CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'LibreNMSPassword';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;

Gõ 'exit' và nhấn 'Enter' để đăng xuất khỏi shell MariaDB.



Bây giờ bạn đã tạo cơ sở dữ liệu và người dùng để cài đặt LibreNMS.

Tạo một nhóm PHP-FPM mới​

FastCGI Process Manager (FPM) hoặc PHP-FPM cho phép bạn tùy chỉnh nhóm cho các ứng dụng PHP của mình. Theo mặc định, PHP-FPM chạy nhóm 'www' với cấu hình '/etc/php/7.4/fpm/pool.d/www.conf'.

Trong bước này, bạn sẽ tạo một nhóm PHP-FPM tùy chỉnh mới cho LibreNMS. Bạn sẽ tạo một nhóm PHP-FPM mới 'librenms' với cấu hình '/etc/php/7.4/fpm/pool.d/librenms.conf' và sẽ chạy dưới người dùng 'librenms'.

1. Trước tiên, hãy sao chép cấu hình nhóm mặc định 'www.conf' vào 'librenms.conf' bằng lệnh sau.

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

2. Chỉnh sửa cấu hình nhóm 'librenms.conf' tùy chỉnh bằng trình soạn thảo nano.

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

Ở đầu dòng, thay đổi người dùng mặc định từ '[www]' thành '[librenms]'.

[librenms]

Thay đổi người dùng và nhóm mặc định thành 'librenms'.

user = librenms
group = librenms

Thay đổi tệp sock PHP-FPM mặc định thành '/run/php-fpm-librenms.sock'.

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

Lưu cấu hình và thoát.

3. Tiếp theo, khởi động lại dịch vụ PHP-FPM để áp dụng cấu hình mới.

sudo systemctl restart php7.4-fpm

Bây giờ PHP-FPM sẽ tạo nhóm mới 'librenms' với tệp sock '/run/php/php-fpm-librenms.sock'.

4. Xác minh tệp sock 'librenms' bằng lệnh sau.

ss -anl | grep librenms

Bạn sẽ thấy kết quả tương tự như bên dưới.

u_str LISTEN 0 511 /run/php/php-fpm-librenms.sock 69199 * 0 users:(("php-fpm7.4",pid=26105,fd=10),("php-fpm7.4",pid=26104,fd=10),("php-fpm7.4",pid=26103,fd=7))

Bây giờ bạn đã sẵn sàng tải xuống và cài đặt công cụ giám sát LibreNMS.

Tải xuống LibreNMS​

Trong bước này, bạn sẽ tải xuống mã nguồn LibreNMS và thiết lập quyền và kiểm soát truy cập cho mã nguồn đó.

1. Thay đổi thư mục làm việc của bạn thành '/opt' và tải xuống mã nguồn LibreNMS bằng lệnh git như bên dưới.

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

Cài đặt LibreNMS của bạn là thư mục '/opt/librenms'.

2. Thay đổi quyền sở hữu và quyền hạn của cài đặt LibreNMS bằng lệnh sau.

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

3. Tiếp theo, thiết lập Danh sách kiểm soát truy cập (ACL) cho thư mục cài đặt LibreNMS. Cho phép nhóm đọc ghi thực thi trên mỗi thư mục bên dưới bằng lệnh setfacl sau.

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/

Tiếp tục bước tiếp theo để cài đặt các phụ thuộc PHP cho LibreNMS.

Cài đặt các phụ thuộc PHP của LibreNMS​

Để cài đặt các phụ thuộc PHP của LibreNMS, bạn phải đăng nhập với tư cách là người dùng 'librenms' và sử dụng composer_wrapper, đây là được bao gồm trong mã nguồn LibreNMS.

1. đăng nhập với tư cách là người dùng 'librenms' bằng lệnh sau.

su - librenms

2. Thực thi tập lệnh PHP 'composer_wrapper.php' để cài đặt các gói PHP phụ thuộc cho LibreNMS.

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

3. Sau khi tất cả các quá trình tải xuống hoàn tất, hãy nhập 'exit' và nhấn 'Enter' để đăng xuất khỏi người dùng 'librenms'.

Bây giờ bạn đã hoàn tất cài đặt PHP Dependencies cho LibreNMS.

Cấu hình Nginx cho LibreNMS​

Trong bước này, bạn sẽ tạo một khối máy chủ Nginx mới cho công cụ giám sát LibreNMS. Ví dụ này sẽ sử dụng tên miền 'librenms.example.io'.

1. Tạo một khối máy chủ Nginx mới cấu hình 'librenms' bằng trình soạn thảo nano.

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

Sao chép và dán cấu hình sau. Và hãy đảm bảo thay đổi tên miền bằng tên miền của bạn.

server {
listen 80;
server_name librenms.example.io;
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;
}
}

Để cài đặt LibreNMS HTTPS an toàn, hãy sử dụng cấu hình sau. Và hãy đảm bảo thay đổi tên miền và đường dẫn của chứng chỉ SSL.

server {
 listen 80;
 server_name librenms.example.io;
 rewrite ^ https://$server_name$request_uri? vĩnh viễn;
}

máy chủ {

tên máy chủ librenms.example.io;
gốc /opt/librenms/html;
chỉ mục index.php;

 lắng nghe 443 ssl http2;
tên máy chủ example.io;
chứng chỉ ssl /etc/letsencrypt/live/librenms.example.io/fullchain.pem;
khóa chứng chỉ ssl /etc/letsencrypt/live/librenms.example.io/privkey.pem;

bộ nhớ đệm ssl_session được tích hợp sẵn:1000 được chia sẻ:SSL:10m;
giao thức ssl TLSv1.2;
mã hóa ssl HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
 ssl_prefer_server_ciphers bật;

charset utf-8;
gzip bật;
gzip_types văn bản/css ứng dụng/javascript văn bản/javascript ứng dụng/x-javascript hình ảnh/svg+xml văn bản/văn bản thuần túy/xsd văn bản/xsl văn bản/xml hình ảnh/x-icon;
location / {
 try_files $uri $uri/ /index.php?$query_string;
}
location ~ [^/]\.php(/|$) {
 fastcgi_pass unix:/run/php/php-fpm-librenms.sock;
 fastcgi_split_path_info ^(.+\.php)(/.+)$;
 include fastcgi.conf;
}
location ~ /\.(?!well-known).* {
 deny all;
}
}

Bây giờ hãy lưu cấu hình và thoát.

2. Tiếp theo, kích hoạt máy chủ ảo mới 'librenms' và xác minh cấu hình nginx bằng lệnh sau.

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

Nếu cấu hình của bạn đúng, bạn sẽ thấy thông báo đầu ra như 'test is successful'.

3. Cuối cùng, hãy khởi động lại dịch vụ nginx để áp dụng cấu hình mới.

sudo systemctl restart nginx

Bây giờ bạn đã hoàn tất cấu hình khối máy chủ Nginx cho LibreNMS. Bạn đã sẵn sàng để bắt đầu cài đặt LibreNMS.

Bắt đầu cài đặt LibreNMS​

Để bắt đầu cài đặt LibreNMS, hãy mở trình duyệt web của bạn và nhập tên miền LibreNMS vào thanh địa chỉ.

https://librenms.example.io.

1. Bạn sẽ thấy 'Kiểm tra trước khi cài đặt' của LibreNMS. Đảm bảo rằng tất cả các dấu kiểm trạng thái đều có màu xanh lá cây, sau đó nhấp vào biểu tượng cơ sở dữ liệu để tiếp tục.



2. Nhập cơ sở dữ liệu, người dùng và mật khẩu của bạn. Sau đó nhấp vào nút 'Kiểm tra thông tin xác thực'.



Điều này sẽ thực hiện kiểm tra cơ sở dữ liệu và người dùng MariaDB của bạn. Nếu thành công, bạn sẽ thấy dấu màu xanh lá cây trên 'Thông tin xác thực cơ sở dữ liệu'.

3. Bây giờ hãy nhấp vào nút 'Xây dựng cơ sở dữ liệu' để nhập lược đồ cơ sở dữ liệu cho LibreNMS của bạn.



Sau khi cấu hình cơ sở dữ liệu hoàn tất, hãy đảm bảo cả hai phần 'Thông tin xác thực cơ sở dữ liệu' và 'Xây dựng cơ sở dữ liệu' đều được đánh dấu màu xanh lá cây.



4. Bây giờ hãy nhấp vào biểu tượng 'Key' để tiếp tục.

Nhập người dùng mới, mật khẩu và địa chỉ email để tạo người dùng quản trị LibreNMS.



Nhấp vào nút 'Add User'.

Nếu người dùng quản trị của bạn đã được tạo, bạn sẽ thấy người dùng quản trị của mình trên trang như bên dưới.



5. Nhấp vào biểu tượng dấu để hoàn tất quá trình cài đặt. Dưới đây là kết quả bạn sẽ nhận được.



Để hoàn tất quá trình cài đặt LibreNMS, hãy mở trang xác thực LibreNMS như bên dưới.

https://librenms.example.io/validate

6. Và bạn sẽ được chuyển hướng đến trang đăng nhập LibreNMS.



Nhập người dùng quản trị và mật khẩu của bạn, sau đó nhấp vào nút 'Login'

7. Trên các trang xác thực LibreNMS, bạn sẽ thấy một số lỗi như bên dưới.



Bạn có thể gặp nhiều lỗi khác nhau, nhưng trang xác thực LibreNMS cung cấp giải pháp cho lỗi của bạn.

8. Dưới đây là một số lỗi trong quá trình cài đặt của chúng tôi và cách khắc phục chúng.

- Sửa múi giờ cơ sở dữ liệu​

Đăng nhập vào shell MariaDB bằng người dùng root của bạn.

mysql -u root -p

Thay đổi cơ sở dữ liệu hiện tại thành 'librenms'.

use librenms;

Bây giờ hãy thực hiện các truy vấn sau để sửa lỗi múi giờ cơ sở dữ liệu.

SET TIME_ZONE='+00:00';
ALTER TABLE `notifications` THAY ĐỔI `datetime` `datetime` timestamp NOT NULL DEFAULT '1970-01-02 00:00:00' ;
ALTER TABLE `users` THAY ĐỔI `created_at` `created_at` timestamp NOT NULL DEFAULT '1970-01-02 00:00:01' ;

- Sửa lỗi hệ thống​

Thêm lệnh nhị phân LibreNMS 'lnms' vào thư mục '/usr/bin' bằng lệnh sau.

sudo ln -s /opt/librenms/lnms /usr/bin/lnms

Bật hoàn thành bash cho lệnh 'lnms'.

sudo cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/

Cuối cùng, sao chép cấu hình logrotate cho LibreNMS vào thư mục '/etc/logrotate.d/'.

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

9. Sau khi sửa lỗi LibreNMS, quay lại trang xác thực LibreNMS và tải lại trang.

Bây giờ hãy đảm bảo rằng tất cả trạng thái là 'OK'.



10. Nhấp vào menu 'Tổng quan' để hiển thị bảng điều khiển.



Bây giờ bạn đã hoàn tất cài đặt LibreNMS trên Debian 11 Bullseye.

Kết luận​

Xin chúc mừng! Bạn đã cài đặt thành công công cụ giám sát LibreNMS với Nginx, PHP-FPM và cơ sở dữ liệu MariaDB trên Debian 11 Bullseye mới nhất. Ngoài ra, bạn đã học cách tạo nhóm PHP-FPM tùy chỉnh và sửa một số lỗi cài đặt LibreNMS.

Ở bước tiếp theo, bạn sẽ học cách thêm máy chủ để giám sát vào công cụ giám sát LibreNMS.