update README & install
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# 🤖 Fleet Control Agent
|
||||
# 🛰️ Fleet Control Agent
|
||||
|
||||
🌍 *[Read in English](#english) | 🇮🇹 [Leggi in Italiano](#italiano)*
|
||||
|
||||
@@ -7,53 +7,98 @@
|
||||
<a name="english"></a>
|
||||
## 🇬🇧 English
|
||||
|
||||
The **Fleet Control Agent** is a lightweight monitoring script designed for remote nodes (Raspberry Pi / Linux). It collects hardware telemetry and executes commands sent from the Central Dashboard via MQTT.
|
||||
The **Fleet Control Agent** is a lightweight monitoring and control script designed for remote MMDVM nodes. It acts as the bridge between your radio hardware and the Central Console.
|
||||
|
||||
### ✨ Features
|
||||
* **Real-Time Telemetry:** Monitors CPU usage, RAM, Temperature, and Disk space.
|
||||
* **Service Management:** Remote Start, Stop, or Restart of system daemons (MMDVMHost, DMRGateway, etc.).
|
||||
* **Smart Auto-Healing:** Automatically detects crashed services and attempts to revive them.
|
||||
* **Hardware Reset (GPIO):** Physically reboot the MMDVM radio HAT via GPIO pins directly from the dashboard.
|
||||
### ✨ Key Features
|
||||
* **Real-Time Telemetry:** Streams CPU, RAM, Disk usage, and Temperature data via MQTT.
|
||||
* **Service Management:** Allows remote Start/Stop/Restart of system daemons (MMDVMHost, DMRGateway, etc.).
|
||||
* **Remote Configuration:** Enables the Central Server to edit `.ini` files remotely.
|
||||
* **Hardware Reset:** Supports physical MMDVM HAT reset via GPIO pins (requires RPi.GPIO).
|
||||
* **Auto-Healing:** Automatically detects service failures and attempts to restart them.
|
||||
|
||||
### 🚀 Quick Installation
|
||||
### 🛠️ Core Configuration Files
|
||||
To enable full functionality, you must configure these three files:
|
||||
* **`node_config.json`**: The main configuration. Here you set your MQTT broker, your unique `client_id` (e.g., `IR3XXX`), and the paths for the lists below.
|
||||
* **`process_list.txt`**: List the names of the system services you want to monitor (e.g., `mmdvmhost`, `dmrgateway`). The agent will check their status and attempt to restart them if they crash (Auto-healing).
|
||||
* **`file_list.txt`**: List the full absolute paths of the configuration files (e.g., `/etc/MMDVMHost.ini`) that you want to edit remotely from the Dashboard.
|
||||
|
||||
1. **Clone the repo:**
|
||||
### 🚀 Installation Guide
|
||||
|
||||
git clone https://git.arifvg.it/iv3jdv/fleet-control-agent.git /opt/fleet-control-agent
|
||||
#### 1. Clone the Repository
|
||||
Clone the agent into `/opt` to ensure path consistency:
|
||||
```bash
|
||||
sudo git clone [https://git.arifvg.it/iv3jdv/fleet-control-agent.git](https://git.arifvg.it/iv3jdv/fleet-control-agent.git) /opt/fleet-control-agent
|
||||
cd /opt/fleet-control-agent
|
||||
```
|
||||
|
||||
2. **Install dependencies:**
|
||||
#### 2. Virtual Environment Setup
|
||||
```bash
|
||||
sudo python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
sudo pip install -r requirements.txt
|
||||
```
|
||||
|
||||
pip install -r requirements.txt
|
||||
#### 3. Configuration
|
||||
1. **Main Config**: `cp node_config.json.example node_config.json` and edit it with your MQTT credentials.
|
||||
2. **Processes**: `cp process_list.txt.example process_list.txt` and add your service names (one per line).
|
||||
3. **Files**: `cp file_list.txt.example file_list.txt` and add the absolute paths to your `.ini` files.
|
||||
|
||||
3. **Configure:** Edit `node_config.json` with your MQTT credentials and a unique `client_id`.
|
||||
4. **Run:** `python3 system_monitor.py`
|
||||
#### 4. Systemd Service (Auto-start)
|
||||
```bash
|
||||
sudo cp fleet-agent.service /etc/systemd/system/
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable fleet-agent
|
||||
sudo systemctl start fleet-agent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
<a name="italiano"></a>
|
||||
## 🇮🇹 Italiano
|
||||
|
||||
Il **Fleet Control Agent** è uno script di monitoraggio leggero progettato per i nodi remoti (Raspberry Pi / Linux). Raccoglie la telemetria hardware ed esegue i comandi inviati dalla Dashboard Centrale tramite protocollo MQTT.
|
||||
Il **Fleet Control Agent** è lo script di monitoraggio e controllo per i nodi remoti MMDVM. Funge da ponte tra l'hardware radio e la Console Centrale.
|
||||
|
||||
### ✨ Funzionalità
|
||||
* **Telemetria in Tempo Reale:** Monitoraggio di utilizzo CPU, RAM, Temperatura e spazio su Disco.
|
||||
* **Gestione Servizi:** Avvio, arresto o riavvio remoto dei demoni di sistema (MMDVMHost, DMRGateway, ecc.).
|
||||
* **Auto-Healing Intelligente:** Rileva automaticamente i servizi andati in blocco e tenta di riavviarli autonomamente.
|
||||
* **Reset Hardware (GPIO):** Invia un impulso di reset fisico alla scheda radio MMDVM tramite i pin GPIO direttamente dalla dashboard.
|
||||
### ✨ Funzionalità Principali
|
||||
* **Telemetria Real-Time:** Invia dati su CPU, RAM, Disco e Temperatura via MQTT.
|
||||
* **Gestione Servizi:** Permette l'avvio, l'arresto o il riavvio remoto dei demoni di sistema (MMDVMHost, DMRGateway, ecc.).
|
||||
* **Configurazione Remota:** Consente al Server Centrale di modificare i file `.ini` a distanza.
|
||||
* **Reset Hardware:** Supporta il reset fisico della scheda MMDVM HAT tramite pin GPIO (richiede RPi.GPIO).
|
||||
* **Auto-Healing:** Rileva automaticamente i crash dei servizi e tenta di riavviarli.
|
||||
|
||||
### 🚀 Installazione Rapida
|
||||
1. **Clona il repository:**
|
||||
### 🛠️ File di Configurazione Chiave
|
||||
Per il corretto funzionamento, è necessario definire i parametri in questi tre file:
|
||||
* **`node_config.json`**: La configurazione principale. Qui imposti il broker MQTT, il tuo `client_id` univoco (es. `IR3XXX`) e i percorsi per le liste sottostanti.
|
||||
* **`process_list.txt`**: Elenca i nomi dei servizi di sistema da monitorare (es. `mmdvmhost`, `dmrgateway`). L'agente ne controllerà lo stato e proverà a riavviarli in caso di crash (Auto-healing).
|
||||
* **`file_list.txt`**: Elenca i percorsi completi dei file di configurazione (es. `/etc/MMDVMHost.ini`) che desideri poter modificare remotamente dalla Dashboard.
|
||||
|
||||
git clone https://git.arifvg.it/iv3jdv/web-control-agent.git /opt/fleet-control-agent
|
||||
### 🚀 Guida all'Installazione
|
||||
|
||||
#### 1. Clonazione del Repository
|
||||
Clona l'agente nella cartella `/opt` per garantire la coerenza con i servizi systemd:
|
||||
```bash
|
||||
sudo git clone [https://git.arifvg.it/iv3jdv/fleet-control-agent.git](https://git.arifvg.it/iv3jdv/fleet-control-agent.git) /opt/fleet-control-agent
|
||||
cd /opt/fleet-control-agent
|
||||
```
|
||||
|
||||
2. **Installa le dipendenze:**
|
||||
#### 2. Setup Ambiente Virtuale (venv)
|
||||
```bash
|
||||
sudo python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
sudo pip install -r requirements.txt
|
||||
```
|
||||
|
||||
pip install -r requirements.txt
|
||||
#### 3. Personalizzazione
|
||||
1. **Config Principale**: `cp node_config.json.example node_config.json` e inserisci i dati MQTT.
|
||||
2. **Processi**: `cp process_list.txt.example process_list.txt` e aggiungi i nomi dei tuoi servizi (uno per riga).
|
||||
3. **File**: `cp file_list.txt.example file_list.txt` e inserisci i percorsi assoluti dei tuoi file `.ini`.
|
||||
|
||||
3. **Configurazione:** Modifica il file `node_config.json` inserendo le tue credenziali MQTT e un `client_id` univoco.
|
||||
4. **Avvio:** `python3 system_monitor.py`
|
||||
#### 4. Esecuzione come Servizio (systemd)
|
||||
```bash
|
||||
sudo cp fleet-agent.service /etc/systemd/system/
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable fleet-agent
|
||||
sudo systemctl start fleet-agent
|
||||
```
|
||||
|
||||
---
|
||||
*Created by IV3JDV @ ARIFVG - 2026*
|
||||
|
||||
+54
-19
@@ -3,24 +3,41 @@
|
||||
============================================================
|
||||
|
||||
This script is meant to be installed on each remote node
|
||||
(e.g., Raspberry Pi, MMDVM host).
|
||||
(e.g., Raspberry Pi, MMDVM host). [cite: 11]
|
||||
|
||||
------------------------------------------------------------
|
||||
1. PRE-REQUISITES & INSTALLATION
|
||||
------------------------------------------------------------
|
||||
Ensure Python 3 is installed.
|
||||
Ensure Python 3 is installed. [cite: 12]
|
||||
|
||||
Install dependencies:
|
||||
pip install -r requirements.txt
|
||||
sudo git clone https://git.arifvg.it/iv3jdv/fleet-control-agent.git /opt/fleet-control-agent
|
||||
cd /opt/fleet-control-agent
|
||||
sudo python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install -r requirements.txt [cite: 12]
|
||||
|
||||
------------------------------------------------------------
|
||||
2. CONFIGURATION
|
||||
2. CONFIGURATION (CRITICAL STEPS)
|
||||
------------------------------------------------------------
|
||||
1. Copy 'system_monitor.py' and 'node_config.json' to
|
||||
your preferred folder (e.g., '/opt/fleet-node_agent/').
|
||||
2. Edit 'node_config.json' with a unique 'client_id' and
|
||||
your MQTT broker credentials.
|
||||
3. (Optional) Install 'RPi.GPIO' if you want hardware reset.
|
||||
A) MAIN CONFIG:
|
||||
cp node_config.json.example node_config.json
|
||||
Edit 'node_config.json' with a unique 'client_id' and
|
||||
your MQTT broker credentials. [cite: 13]
|
||||
|
||||
B) MONITORING PROCESSES (process_list.txt):
|
||||
cp process_list.txt.example process_list.txt
|
||||
Add the names of services you want to monitor (one per line). [cite: 8]
|
||||
Example: mmdvmhost
|
||||
|
||||
C) REMOTE EDITING FILES (file_list.txt):
|
||||
cp file_list.txt.example file_list.txt
|
||||
Add the full absolute paths of the .ini files you want
|
||||
to edit remotely from the dashboard. [cite: 10]
|
||||
Example: /etc/MMDVMHost.ini
|
||||
|
||||
D) OPTIONAL:
|
||||
Install 'RPi.GPIO' if you want hardware reset. [cite: 14]
|
||||
|
||||
------------------------------------------------------------
|
||||
3. RUNNING AS A SERVICE (SYSTEMD)
|
||||
@@ -36,24 +53,41 @@ Install dependencies:
|
||||
============================================================
|
||||
|
||||
Questo script va installato su ogni nodo remoto
|
||||
(es. Raspberry Pi, MMDVM host).
|
||||
(es. Raspberry Pi, MMDVM host). [cite: 11]
|
||||
|
||||
------------------------------------------------------------
|
||||
1. REQUISITI E INSTALLAZIONE
|
||||
------------------------------------------------------------
|
||||
Assicurarsi di avere Python 3 installato.
|
||||
Assicurarsi di avere Python 3 installato. [cite: 15]
|
||||
|
||||
Installa le dipendenze:
|
||||
pip install -r requirements.txt
|
||||
Installazione:
|
||||
sudo git clone https://git.arifvg.it/iv3jdv/fleet-control-agent.git /opt/fleet-control-agent
|
||||
cd /opt/fleet-control-agent
|
||||
sudo python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install -r requirements.txt [cite: 15]
|
||||
|
||||
------------------------------------------------------------
|
||||
2. CONFIGURAZIONE
|
||||
2. CONFIGURAZIONE (PASSAGGI CRITICI)
|
||||
------------------------------------------------------------
|
||||
1. Copia 'system_monitor.py' e 'node_config.json' in
|
||||
una cartella (es. '/opt/node_agent/').
|
||||
2. Modifica 'node_config.json' inserendo un 'client_id'
|
||||
univoco e i dati del server MQTT.
|
||||
3. (Opzionale) Installa 'RPi.GPIO' per il reset hardware.
|
||||
A) CONFIGURAZIONE PRINCIPALE:
|
||||
cp node_config.json.example node_config.json
|
||||
Modifica 'node_config.json' inserendo un 'client_id'
|
||||
univoco e i dati del server MQTT. [cite: 16]
|
||||
|
||||
B) MONITORAGGIO PROCESSI (process_list.txt):
|
||||
cp process_list.txt.example process_list.txt
|
||||
Aggiungi i nomi dei servizi da monitorare (uno per riga). [cite: 8]
|
||||
Esempio: mmdvmhost
|
||||
|
||||
C) EDITING FILE REMOTO (file_list.txt):
|
||||
cp file_list.txt.example file_list.txt
|
||||
Aggiungi i percorsi assoluti dei file .ini che desideri
|
||||
poter modificare remotamente dalla dashboard. [cite: 10]
|
||||
Esempio: /etc/MMDVMHost.ini
|
||||
|
||||
D) OPZIONALE:
|
||||
Installa 'RPi.GPIO' per il reset hardware. [cite: 17]
|
||||
|
||||
------------------------------------------------------------
|
||||
3. ESECUZIONE COME SERVIZIO (SYSTEMD)
|
||||
@@ -62,3 +96,4 @@ Installa le dipendenze:
|
||||
2. sudo systemctl daemon-reload
|
||||
3. sudo systemctl enable fleet-agent
|
||||
4. sudo systemctl start fleet-agent
|
||||
============================================================
|
||||
|
||||
Reference in New Issue
Block a user