Installazione dell'Agent¶

Prerequisiti¶

Windows compatibile x86 e .NET 8 Desktop Runtime x86.
Cartella applicativa scrivibile per configurazioni, log e aggiornamenti.
Connessione ai due database logici e schema compatibile con le query.
Pannello Modbus TCP raggiungibile sulla porta 502.
Provider Access ACE x86, se usato; credenziali e opzioni corrette per il provider scelto.
pdfium.dll x86 per stampa/render PDF e stampante configurata, se richiesti.
Viewer VNC e componenti esterni solo per le funzioni effettivamente utilizzate.

Preparazione dell'istanza¶

Creare una cartella distinta per ogni Agent oppure utilizzare la creazione istanze del Manager.
Copiare il pacchetto e le dipendenze richieste.
Preparare un config.ini specifico con pannello, database e identità macchina.
Verificare permessi di scrittura e accesso rete.
Avviare manualmente e controllare licenza, database e comunicazione.
Configurare il mapping e svolgere la prova di persistenza prima dell'autostart.

Le configurazioni cliente non vanno sostituite con quelle di un ambiente diverso. Dal 28/09/2026 il mapping ha un file separato, mapping.ini, che va conservato durante gli aggiornamenti.

Più copie sullo stesso computer¶

Agent non impone una singola istanza. Il nome dell'eseguibile influenza l'identità di licenza e il badge della finestra:

Nome	Badge
`LinkMachine.exe`	Nessuno
`LinkMachine_2.exe`	`2`
`LinkMachine_TEST.exe`	`TEST`

Il badge deriva dal nome del file, non dal numero di processi attivi. Una copia rinominata ha la propria identità di licenza. Separare anche le cartelle per evitare configurazioni e file runtime condivisi involontariamente.

Simulazione¶

Con indirizzo pannello locale l'Agent può cercare PanelSimulator.exe accanto all'eseguibile e attendere la porta 502. Il simulatore è un artefatto esterno: non è incluso nello ZIP di istanza esaminato nella memoria. La sua presenza deve essere verificata, senza considerare loopback una simulazione già funzionante.