Skip to main content

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&param...

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

Troubleshooting

Changelog