update
This commit is contained in:
+132
@@ -0,0 +1,132 @@
|
||||
============================================================
|
||||
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
|
||||
============================================================
|
||||
Reference in New Issue
Block a user