============================================================
       INSTALLATION GUIDE - FLEET CONTROL AGENT
============================================================

This script is meant to be installed on each remote node
(e.g., Raspberry Pi, MMDVM host). [cite: 11]

------------------------------------------------------------
0. IMPORTANT: ROOT PRIVILEGES
------------------------------------------------------------
All installation steps must be executed as the "root" user.
Before starting, elevate your privileges by running:
   sudo su

------------------------------------------------------------
1. PRE-REQUISITES & INSTALLATION
------------------------------------------------------------
Ensure Python 3 is installed. [cite: 12]

Install dependencies:
   sudo git clone https://git.arifvg.it/iv3jdv/fleet-node-agent.git /opt/fleet-node-agent
   cd /opt/fleet-node-agent
   sudo python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt [cite: 12]

------------------------------------------------------------
2. CONFIGURATION (CRITICAL STEPS)
------------------------------------------------------------
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)
------------------------------------------------------------
1. cp fleet-agent.service /etc/systemd/system/
2. systemctl daemon-reload
3. systemctl enable fleet-agent
4. systemctl start fleet-agent


============================================================
       GUIDA ALL'INSTALLAZIONE - AGENTE REMOTO
============================================================

Questo script va installato su ogni nodo remoto 
(es. Raspberry Pi, MMDVM host). [cite: 11]

------------------------------------------------------------
0. IMPORTANTE: PRIVILEGI DI ROOT
------------------------------------------------------------
Tutti i passaggi di installazione devono essere eseguiti 
come utente "root". Prima di iniziare, eleva i tuoi privilegi:
   sudo su

------------------------------------------------------------
1. REQUISITI E INSTALLAZIONE
------------------------------------------------------------
Assicurarsi di avere Python 3 installato. [cite: 15]

Installazione:
   sudo git clone https://git.arifvg.it/iv3jdv/fleet-node-agent.git /opt/fleet-node-agent
   cd /opt/fleet-node-agent
   sudo python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt [cite: 15]

------------------------------------------------------------
2. CONFIGURAZIONE (PASSAGGI CRITICI)
------------------------------------------------------------
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)
------------------------------------------------------------
1. cp fleet-agent.service /etc/systemd/system/
2. systemctl daemon-reload
3. systemctl enable fleet-agent
4. systemctl start fleet-agent
============================================================