--- tags: 2020 IT 幫幫忙鐵人賽 --- # Day 9 開源機房 SNMP 協定監控軟體 LibreNMS 建置與使用 > 本日重點與方向 (TAG): SNMP、Simple Network Management Protocol、LibreNMS、MySQL、Apache2、開源網管系統、NMS、Network Management System > 今天將會介紹使用 Bare Metal 進行 LibreNMS 設備監控，因為使用 SNMP 協定進行通訊，SNMP 設定部分請依照各家廠商配置(Ubuntu、Windows 也有軟體跟設定可用)，SNMP V1、V2c、V3 在於 LibreNMS 皆可以設定，這邊就是介紹 LibreNMS 安裝與添加設備，還有稍微看一下納管的狀態，詳細的其他設定就不做贅述了，配合一下計算節點算是我們軟體業手上的小劍劍，節點一關機等同於你的武器掉在路上，準備等死或是客戶的電話塞爆你了(~~老闆海 K 揍爆你~~)，安裝 LibreNMS 進行監控的話，我們就比較可以馬上知道小劍劍掉在路上，掉了馬上撿起來www，並透過告警功能與網頁監控方式，解決設備掉線而你在狀況外的問題了，此外 LibreNMS 感謝 台中軟體開源社群 節省哥 Jason 推薦使用！，詳細的配置與神奇功能與同步機制等等的，可以到 [節省哥的Blog](http://blog.jason.tools/) 參考 。 ## 本次使用設備資訊 ### Network Router - 數量: 1 - 型號: DrayTek Vigor300B ### Network Switch - 數量: 1 - 型號: D-Link 1210-28 (L2 Switch) ### LibreNMS Server - Ubuntu: 16.04 / 18.04 - CPU: E3-1230_v3 - RAM: 16GB - Disk: 120 GB (SSD) - Network: 1Gbps ### LibreNMS SNMP Device - AXIS M5014 Webcam - IP: 10.0.0.5 - SNMP Community: public ## LibreNMS 安裝 (Apache2+PHP7.2) > 參考網站：https://docs.librenms.org/Installation/Installation-Ubuntu-1804-Apache/ > LibreNMS 版本更新列表：https://docs.librenms.org/General/Changelog/ ### 系統套件安裝 - Ubuntu 16.04 / 18.04 適用 #### 優先處理時間問題 - 時間不對會造成 LibreNMS 無法登陸跟套件安裝問題 ``` timedatectl set-timezone Asia/Taipei ``` #### 處理 PHP 7.2 在 apt install 無法安裝問題 * PHP 7.0 部分對應 LibreNMS 1.48 （[已過時](https://https://docs.librenms.org/Installation/Installation-Ubuntu-1604-Apache/)） ``` add-apt-repository ppa:ondrej/php apt-get update apt-get install php7.2 ``` #### LibreNMS 相關服務套件安裝 - PHP 版本請用 7.1.3 版本以上 ``` apt-get install software-properties-common add-apt-repository universe apt-get update apt-get install curl apache2 composer fping git graphviz imagemagick libapache2-mod-php7.2 mariadb-client mariadb-server mtr-tiny nmap php7.2-cli php7.2-curl php7.2-gd php7.2-json php7.2-mbstring php7.2-mysql php7.2-snmp php7.2-xml php7.2-zip python-memcache python-mysqldb rrdtool snmp snmpd whois ``` ### 安裝 Librenms #### Github 上 LibreNMS 來源下載 ``` cd /opt git clone https://github.com/librenms/librenms.git ``` #### 新增使用者 ``` useradd librenms -d /opt/librenms -M -r usermod -a -G librenms www-data ``` #### LibreNMS 資料夾權限設定 ``` chown -R librenms:librenms /opt/librenms chmod 770 /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/ ``` #### 安裝 PHP 相依項目 ``` su - librenms ./scripts/composer_wrapper.php install --no-dev exit ``` ### 安裝設定 Mysql / MarialDB #### 安裝 DataBase 服務 ##### MariaDB ``` apt-get install mariadb-server mariadb-client ``` ##### Mysql ``` apt-get install mysql-server mysql-client ``` - 設定 root 密碼 ![](https://i.imgur.com/wsmgt7J.png) - 確認 root 密碼 ![](https://i.imgur.com/Q35KU6w.png) #### 啟動 DataBase 服務與登入 - 預設帳號：root - MariaDB 預設密碼：**None** ``` systemctl restart mysql mysql -uroot -p ``` #### 新增資料庫與使用者給 LibereNMS 使用 - db-name：LibreNMS 存取的資料庫名稱 - user-name：LibreNMS 取用 Mysql 登入使用的使用者名稱 - user-passwd：LibreNMS 取用 Mysql 登入使用的使用者密碼 ``` CREATE DATABASE ${db-name} CHARACTER SET utf8 COLLATE utf8_unicode_ci; CREATE USER '${user-name}'@'localhost' IDENTIFIED BY '${user-passwd}'; GRANT ALL PRIVILEGES ON ${db-name}.* TO '${user-name}'@'localhost'; FLUSH PRIVILEGES; exit ``` #### 修改 DataBase 配置 ##### MariaDB ``` nano /etc/mysql/mariadb.conf.d/50-server.cnf ``` ##### Mysql ``` nano /etc/mysql/mysql.conf.d/mysqld.cnf ``` ##### [mysqld] 區塊添加以下設定 ``` innodb_file_per_table=1 lower_case_table_names=0 ``` #### 重新啟動 Mysql 吃設定檔 ``` systemctl restart mysql ``` ### Web Server 設定 #### PHP 時區校正 - 兩個檔案修改一樣的項目 => **timezone** 的部分 ``` nano /etc/php/7.2/apache2/php.ini nano /etc/php/7.2/cli/php.ini ``` - 修改前內容 ``` # date.timezone ``` - 修改後內容 ``` date.timezone = Asia/Taipei ``` #### Apache2 開啟服務模組 ``` a2enmod php7.2 a2dismod mpm_event a2enmod mpm_prefork phpenmod mcrypt ``` ### 建立 LibreNMS 的虛擬後端導向 ``` nano /etc/apache2/sites-available/librenms.conf ``` - 填入資訊 ``` <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> </VirtualHost> ``` - 關閉 Apache2 初始80埠的導向頁面 ``` a2dissite 000-default ``` - 開啟 Apache2 指定虛擬後端站點 ``` a2ensite librenms.conf ``` - 開啟 Apache2 虛擬後台路由複寫模組 > 參考功能：https://medium.com/@awonwon/htaccess-with-rewrite-3dba066aff11 ``` a2enmod rewrite ``` - 重啟 Apache2 更新所有取用模組設定 ``` systemctl restart apache2 ``` ## LibreNMS 網頁初始化設定 - host-ip：安裝 LibreNMS 的主機 IP - host-port：LibreNMS 服務對應埠號 ``` http://${host-ip}:${host-port}/install.php ``` ### 基礎套件相依檢查 ![](https://i.imgur.com/RZ6y2Vz.png) ### Mysql 設定與連線登入測試 ![](https://i.imgur.com/DfUXACU.png) ### Mysql sql 資料表載入與設定 ![](https://i.imgur.com/CQgDSR1.png) ### LibreNMS 使用者新增 ![](https://i.imgur.com/ndRUmDq.png) ![](https://i.imgur.com/qwERc69.png) ### LibreNMS 環境建置 #### config.php 已新增 ![](https://i.imgur.com/y5hn4Au.png) #### config.php 不存在 ![](https://i.imgur.com/KLB8PEz.png) - 新增 config.php ``` nano /opt/librenms/config.php ``` - config.php 檔案內容 - mysql-ip：Mysql 安裝的主機IP - mysql-port：Mysql 使用的主機Port - db-user：使用 librenmms 資料庫的 Mysql 使用者 - db-passwd：使用 librenmms 資料庫的 Mysql 使用者密碼 - db-name：使用 librenmms 資料庫名稱 ``` <?php ## Have a look in defaults.inc.php for examples of settings you can set here. DO NOT EDIT defaults.inc.php! ### Database config $config['db_host'] = '${mysql-ip}'; $config['db_port'] = '${mysql-port}'; $config['db_user'] = '${db-user}'; $config['db_pass'] = '${db-passwd}'; $config['db_name'] = '${db-name}'; $config['db_socket'] = ''; // This is the user LibreNMS will run as //Please ensure this user is created and has the correct permissions to your install $config['user'] = 'librenms'; ### Locations - it is recommended to keep the default #$config['install_dir'] = "/opt/librenms"; ### This should *only* be set if you want to *force* a particular hostname/port ### It will prevent the web interface being usable form any other hostname #$config['base_url'] = "http://librenms.company.com"; ### Enable this to use rrdcached. Be sure rrd_dir is within the rrdcached dir ### and that your web server has permission to talk to rrdcached. #$config['rrdcached'] = "unix:/var/run/rrdcached.sock"; ### Default community $config['snmp']['community'] = array("public"); ### Authentication Model $config['auth_mechanism'] = "mysql"; # default, other options: ldap, http-auth #$config['http_auth_guest'] = "guest"; # remember to configure this user if you use http-auth ### List of RFC1918 networks to allow scanning-based discovery #$config['nets'][] = "10.0.0.0/8"; #$config['nets'][] = "172.16.0.0/12"; #$config['nets'][] = "192.168.0.0/16"; # Update configuration #$config['update_channel'] = 'release'; # uncomment to follow the monthly release channel #$config['update'] = 0; # uncomment to completely disable updates ``` #### LibreNMS 安裝完成 ![](https://i.imgur.com/NiRSCQJ.png) ## LibreNMS 網頁登入測試 ### 登入頁面網址 - host-ip：安裝 LibreNMS 的主機 IP - host-port：LibreNMS 服務對應埠號 ``` http://${host-ip}:${host-port}/login ``` ![](https://i.imgur.com/A8mp89s.png) ### 主頁面 ![](https://i.imgur.com/WdGzxqw.png) ---- ## LibreNMS 網路設備管理 ### 添加設備 > 需要知道設備的區域網路 IP, SNMP Community - 設定路徑: Devices > Add Device ![](https://i.imgur.com/evTv1YG.png) - SNMP ![](https://i.imgur.com/NPGEw1O.png) - SNMP 添加設備的設定頁面 ![](https://i.imgur.com/jDJjSk0.png) - SNMP 添加完成狀態檢視 ![](https://i.imgur.com/2W9AMwW.png) ### 區網內自動添加設備 > 這邊會用官方的 snmp-scan.py 腳本進行區網設備抓取，SNMP Community 會依照先前的 confug.php 中的配置進行使用，需要修改的話就是往這邊去調整，因為自動添加的資料會塞在 RAM ，因此需要的 RAM 空間較大的主機，如果使用樹莓派開搞的，建議還是手動用網頁添加為主。 - 添加 /opt/librenms/config.php 的抓取 SNMP Community ``` ~~ $config['snmp']['community'][] = "your-community"; ~~ ``` - 修改 /opt/librenms/config.php 的抓取網段 ``` ~~ ### List of RFC1918 networks to allow scanning-based discovery $config['nets'][] = "10.0.0.0/8"; $config['nets'][] = "172.16.0.0/12"; $config['nets'][] = "192.168.0.0/16"; ~~ ``` - 依照 /opt/librenms/config.php 的區網配置 ``` python3 snmp-scan.py ``` - 自訂網段的抓取方式 ``` python3 snmp-scan.py 10.0.0.0/24 ``` - 自訂設備 IP 的抓取方式 ``` python3 snmp-scan.py 10.0.0.165 ``` ### 檢視受監控的設備 > 這邊是觀看目前託管的設備，LibreNMS 會自動協助分類，有種類錯誤的下一小節進行設定，我們這邊只要能看到即可，另外抓取時間需要等 5 分鐘才會有穩定的資料，所以需要等待一陣子。 - 設定路境: Devices > All Devices > 選設備種類 ![](https://i.imgur.com/iFvJNDY.png) ### 修改設備種類異常問題 > LibreNMS 會有給予設備分類的作法，提供使用者快速找到您社設備，但是如果你有自己的設備種類，或是需要修改 LibreNMS 判斷錯誤的設備種類，這邊可以用此方法進行配置。 - 設定路徑: Devices > All Devices > 設備種類 > 您的設備 > 齒輪(設定) > edit ![](https://i.imgur.com/O6WEwrf.png) - 找到 Type 的欄位，用下拉選單修改 ![](https://i.imgur.com/d8EFprI.png) - 這邊下拉式選單提供多個種類去做修改，弄好之後按下 Save 即可 ![](https://i.imgur.com/yjqIk9K.png) - 修改完後切到 Device > All Device，即可看到你修改的設備種類，設備也會在裡面。 ![](https://i.imgur.com/ILnemE7.png)