133 lines
4.9 KiB
Plaintext
133 lines
4.9 KiB
Plaintext
============================================================
|
|
INSTALLATION GUIDE - FLEET CONTROL CONSOLE
|
|
============================================================
|
|
|
|
This guide describes the steps to install the Central
|
|
Dashboard and the Remote Agents on MMDVM nodes.
|
|
|
|
------------------------------------------------------------
|
|
1. PRE-REQUISITES
|
|
------------------------------------------------------------
|
|
Ensure Python 3 is installed on all systems.
|
|
The necessary dependencies are listed in the
|
|
'requirements.txt' file.
|
|
|
|
Install dependencies:
|
|
pip install -r requirements.txt
|
|
|
|
------------------------------------------------------------
|
|
2. SERVER SETUP (CENTRAL HUB)
|
|
------------------------------------------------------------
|
|
The server handles the web interface and user permissions.
|
|
|
|
Steps:
|
|
1. Configure 'config.json' using 'config.example.json' as a template.
|
|
2. Enter MQTT credentials and VAPID keys.
|
|
3. Define repeaters in the 'clients.json' file.
|
|
4. Start the server:
|
|
python3 app.py
|
|
|
|
------------------------------------------------------------
|
|
3. GENERATING VAPID KEYS (PUSH NOTIFICATIONS)
|
|
------------------------------------------------------------
|
|
Required to enable browser and mobile notifications.
|
|
|
|
1. Go to https://vapidkeys.com/ and generate the keys.
|
|
2. Copy 'Public Key' and 'Private Key' into 'config.json'.
|
|
3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com").
|
|
|
|
------------------------------------------------------------
|
|
4. AGENT SETUP (REMOTE NODES)
|
|
------------------------------------------------------------
|
|
To be installed on each Raspberry Pi / MMDVM Node.
|
|
|
|
1. Copy 'system_monitor.py' and 'node_config.json' to
|
|
'/opt/node_agent/'.
|
|
2. Edit 'node_config.json' with a unique 'client_id'.
|
|
3. (Optional) Install 'RPi.GPIO' for hardware reset.
|
|
|
|
------------------------------------------------------------
|
|
5. RUNNING AS A SERVICE (SYSTEMD)
|
|
------------------------------------------------------------
|
|
For auto-start and process monitoring.
|
|
|
|
Configuration:
|
|
1. Copy .service files to '/etc/systemd/system/':
|
|
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
|
- Nodes: sudo cp fleet-agent.service /etc/systemd/system/
|
|
2. Reload systemd:
|
|
sudo systemctl daemon-reload
|
|
3. Enable start on boot:
|
|
sudo systemctl enable fleet-console (or fleet-agent)
|
|
4. Start the service:
|
|
sudo systemctl start fleet-console
|
|
|
|
|
|
============================================================
|
|
GUIDA ALL'INSTALLAZIONE - FLEET CONTROL CONSOLE
|
|
============================================================
|
|
|
|
Questa guida descrive i passaggi per installare la Dashboard
|
|
Centrale e gli Agenti Remoti sui nodi MMDVM.
|
|
|
|
------------------------------------------------------------
|
|
1. REQUISITI PRELIMINARI
|
|
------------------------------------------------------------
|
|
Assicurarsi di avere Python 3 installato su tutti i sistemi.
|
|
Le dipendenze necessarie sono elencate nel file
|
|
'requirements.txt'.
|
|
|
|
Installazione dipendenze:
|
|
pip install -r requirements.txt
|
|
|
|
------------------------------------------------------------
|
|
2. SETUP DEL SERVER (HUB CENTRALE)
|
|
------------------------------------------------------------
|
|
Il server gestisce l'interfaccia web e i permessi.
|
|
|
|
Passaggi:
|
|
1. Configura 'config.json' partendo da 'config.example.json'.
|
|
2. Inserisci le credenziali MQTT e le chiavi VAPID.
|
|
3. Definisci i ripetitori nel file 'clients.json'.
|
|
4. Avvia il server:
|
|
python3 app.py
|
|
|
|
------------------------------------------------------------
|
|
3. GENERAZIONE CHIAVI VAPID (NOTIFICHE PUSH)
|
|
------------------------------------------------------------
|
|
Necessarie per abilitare le notifiche su browser e mobile.
|
|
|
|
1. Vai su https://vapidkeys.com/ e genera le chiavi.
|
|
2. Copia 'Public Key' e 'Private Key' nel 'config.json'.
|
|
3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com").
|
|
|
|
------------------------------------------------------------
|
|
4. SETUP DELL'AGENTE (NODI REMOTI)
|
|
------------------------------------------------------------
|
|
Da installare su ogni Raspberry Pi / Nodo MMDVM.
|
|
|
|
1. Copia 'system_monitor.py' e 'node_config.json' in
|
|
'/opt/node_agent/'.
|
|
2. Modifica 'node_config.json' con il 'client_id' univoco.
|
|
3. (Opzionale) Installa 'RPi.GPIO' per il reset hardware.
|
|
|
|
------------------------------------------------------------
|
|
5. ESECUZIONE COME SERVIZIO (SYSTEMD)
|
|
------------------------------------------------------------
|
|
Per l'avvio automatico e il monitoraggio del processo.
|
|
|
|
Configurazione:
|
|
1. Copia i file .service in '/etc/systemd/system/':
|
|
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
|
- Nodi: sudo cp fleet-agent.service /etc/systemd/system/
|
|
2. Ricarica systemd:
|
|
sudo systemctl daemon-reload
|
|
3. Abilita l'avvio al boot:
|
|
sudo systemctl enable fleet-console (oppure fleet-agent)
|
|
4. Avvia il servizio:
|
|
sudo systemctl start fleet-console
|
|
|
|
------------------------------------------------------------
|
|
Created by IV3JDV @ ARIFVG - 2026
|
|
============================================================
|