Grusher Documentation
READ BEFORE INSTALL CHAPTER
System installation
DEMO version
Demo server https://grusher-demo.gviabcua.in.ua/login Login to system: login: SlavaUkraini pas...
Terms of use
By using this project or it`s source code, for any purpose and in any shape...
About free licence
Read Terms of use Author may refuse to grant a license Free licence First free licence The fi...
Get a free key
Get a free license key from the author (send the IP address from which you will connect to the up...
System requirements
Recomended Ubuntu 20.04/22.04 and above (Other operating systems at your own risk) Popular ser...
Installation - STEP 1 - System preparation
DO NOT USE ROOT FOR INSTALLATION. SUDO ONLY Are you really not using root? Well, then ...
Installation - STEP 2 - Installing Core
Run this in terminal Create folder if not exist sudo mkdir /var/www sudo mkdir /var/www/html ...
Installation - STEP 3 - Installing Grusher
Get a free license key from the author (send the IP address from which you will connect to the up...
Installation - STEP 4 - other settings
LOG ROTATION (RECOMENDED) Install logrotate sudo apt install logrotate Install our config ...
After installation - Activating licence
Go to System/Config (URL http://YOUR_IP/system/config) and check your licence. You can see someth...
After installation - .env file
Main config File .env is a config file for GRUSHER. Many varaibles you can config via this file....
After installation - System tuning
We offer you several steps to achieve maximum performance of the system. If your network is smal...
Installing SSL (LetsEncrypt or other)
Install certbot sudo apt install certbot python3-certbot-nginx Make file /etc/nginx/sites-enabl...
Updating system
Updating via CLI Updating via CLI to latest stable version cd /var/www/html sudo -u www-data w...
Using the system
About system (UA)
Grusher – це повністю автономна комплексна автоматизована система діагностики, моніторингу, резер...
AI (artificial intelligence)
Starting with build_340, Grusher supports data processing with artificial intelligence. Now supp...
API
How to use API Typical API request is http://SERVER_URL/api?cat=device&action=get_onu_info¶m...
Autotopology
Grusher can create network topology in auto and manual mode Routing tables BGP OSPF LLDP ...
CLI commands
All command need to be running from user www-data (exept some) We strongly do not recommend using...
Device backup
Configuring server Before use you need to install and configure FTP (proftpd recomended) and TFT...
Device, device auth & discovering
Supported devices https://gviabcua.in.ua/grusher/devices Device list This is typical list of de...
Diagnostic
Ethernet port PON-port ONUs SFP Modules
Ethernet Switches
This module use for manage Ethernet switches Default device card Default device ethernet port...
Events
Main page Main page and widget Confirmation Also read about support of SNMP Traper
Inventarisation
Show how much devicese in network grouped by type and model Device inventarisation ONUs inven...
Map, fiber, commutation, nodes
Fiber map Multi map support Using search and combined map Main map Custom icons on ma...
Monitoring
Device All device by default has enabled monitoring/ You can cahnge it manually Ports Port...
OLTs/ONUs
This module is used to manage PON. OLT list of all OLTs can be found atEquipment -> PON -> OLTs...
ONU Registration
ONU registration can be found atEquipment -> PON -> ONU Registration/pon/unregistered_onu All un...
Security
Global access restrictions You can restrict access to API or to web via setting (global setting...
Server
System backup This is a third-party module. The author (guiabtsua) is not responsible for the op...
SFP modules
This module use for manage SFP To get SFP metrics you need to enable it in Grusher CRON and setu...
Tasks
Module Tasks created for manage working processing via tasks for Grusher users. You can use task ...
Warehouse
Main functions of the Warehouse module Suppliers Warehouses with the possibility of distribut...
3rd party modules
Notes Searching for unknown devices Sticky notes SYSLOG Grusher support getting infor...
Гібридний підхід до виявлення аномалій у мережевій інфраструктурі на основі порогових правил та алгоритму Isolation Forest (скорочено)
Анотація:У даній статті розглядається ефективний підхід до моніторингу мережевої інфраструктури ч...
Additional components
AI/ML – Як система прогнозує аварії в мереж
Як система прогнозує аварії в мережі ще до появи скарг абонентів У сучасній мережі провайдера нед...
Billing — Telephony
Intro The Telephony module uses Asterisk AMI to capture events, store them in a database, and pr...
External metric
Grusher support getting metrics from another sources, system or script. You need to add Serve...
Grusher Proxy Service
Working from build_352 As development of the new proxy module for Grusher is now in active progre...
Traper
Grusher support getting and parce SNMP Traps (from build 319). You can add all Trap or only nee...
Troubleshooting
Can`t login. Password is right
Run it cd /var/www/html sudo -u www-data php artisan cache:clear sudo -u www-data php artisan ...
Can`t login. Forgot Password
Just run from CLI where USER - you username* sudo -u www-data php artisan grusher:fixer user_pas...
Folder /var/www/html/storage/framework/sessions/ is too large
If you see error like this: file_put_contents(/var/www/html/storage/framework/sessions/Qz3Pnh0O7...
Lock access for yourself
Run this if you lock access for youself: sudo -u www-data php artisan grusher:fixer allow_access...
PDOException: SQLSTATE[40001]: Serialization failure: 1213 Deadlock found when trying to get lock; try restarting transaction in...
In highly loaded systems, such problem is possible. To solve it, it is necessary to turn off the ...
Theme is broken - no style
If you see Grusher like this Check memcached service sudo service memcached status You can ...
WebSockets is not running
Main problems if you see message like this you need to check websocket service. If you are us...
Web terminal is not running
Set permission sudo chmod 755 /var/www/html/plugins/gviabcua/netcontrol/scripts/bin/gotty ...
Other problems
Cannot create cache directory Problem: Cannot create cache directory /var/www/.cache/composer/re...
Changelog
Version 2.7
2.7.0 - 04.07.2026 Починаючи з цього оновлення змінюється логіка версіонування. Білди переходять ...
Version 2.6
2.6.11 Build 355 - 24.06.2026 ➕ Додано PWA-додаток для Android, IOS, Windows 🔨 Змінено функціонал...
Version 2.5
2.5.11 - 20.10.2023 Додано: Додано нові пристрої (BDCOM switch, Nortel, Cisco, GCOM OLT, Hu...
Versions 2.4 and less
2.4.2 - 28.12.2022 Додано: Реалізована можливість вмикати/вимикати Ethernet порти на ...
Roadmap - Global plan
План Звітність Створення нових типів звітів Топологія мережі Побудова маршруту про...