Laundry ERP
Configurazione Avanzata

Risoluzione Problemi IoT

Guida alla risoluzione dei problemi comuni con i sistemi IoT di Laundry ERP.

Risoluzione Problemi IoT

Questa guida raccoglie i problemi più comuni riscontrati durante l'utilizzo dei sistemi IoT (box fisico e IoT virtuale Windows) e le relative soluzioni.

Il codice di abbinamento non appare o non funziona

Il codice di abbinamento potrebbe non essere visualizzato o stampato nelle seguenti circostanze:

  • Il sistema IoT non è connesso alla rete
  • Il sistema IoT è già connesso a un database di Laundry ERP. In questo caso, disconnettilo dal database
  • Il tempo di visualizzazione del codice di abbinamento è scaduto. Riavvia il box IoT o il servizio IoT virtuale Windows per generare e visualizzare un nuovo codice
Riavvio del sistema IoT:
  • Box IoT: Scollega l'alimentazione, attendi 10 secondi, ricollega
  • IoT virtuale Windows: Riavvia il servizio dall'app di gestione Windows ::

Il sistema IoT non si connette al database

Il sistema IoT potrebbe impiegare alcuni minuti per riavviarsi quando si connette a un database. Se non appare ancora dopo qualche minuto:
  • Verifica che il sistema IoT possa raggiungere il database e che il server non utilizzi un ambiente multi-database
  • Riavvia il box IoT o il servizio IoT virtuale Windows
Requisiti di rete:Per il corretto funzionamento del sistema IoT è necessario che:
  1. Database e box IoT siano sulla stessa rete locale
  2. Non ci siano firewall che bloccano la comunicazione
  3. Il database sia in modalità single-database (non multi-tenant) ::

Il sistema IoT è connesso ma non può essere raggiunto

Verifica che il sistema IoT e il computer che esegue il database Laundry ERP siano connessi alla stessa rete e aggiorna le impostazioni DNS se necessario (vedi sezione più avanti).

La homepage dell'IoT virtuale Windows non è accessibile da altri dispositivi

  • Assicurati che il dispositivo sia connesso alla stessa rete dell'IoT virtuale Windows
  • Controlla le impostazioni del firewall Windows
Configurazione firewall Windows:
  1. Apri Windows Defender Firewall
  2. Seleziona Consenti app tramite firewall
  3. Cerca "Laundry ERP IoT" o il nome del servizio IoT
  4. Assicurati che sia consentito per Reti private ::

Il sistema IoT non funziona dopo un aggiornamento di Laundry ERP

Riavvia il box IoT o il servizio IoT virtuale Windows.Se il problema persiste, aggiorna l'immagine del sistema:
  • Box IoT: Esegui il flashing della scheda SD con l'immagine più recente
  • IoT virtuale Windows: Disinstalla il programma e reinstalla l'ultima versione del pacchetto
Dopo aggiornamenti major del database (es. v18 → v19), è quasi sempre necessario aggiornare anche l'immagine del sistema IoT per garantire la compatibilità.

La homepage del sistema IoT è accessibile tramite IP ma non tramite URL xxx.odoo-iot.com

Questo è un problema relativo alla configurazione DNS della rete. Contatta l'amministratore di sistema o di rete per risolvere il problema.Soluzioni possibili:
  • Se il router consente la configurazione manuale del DNS, aggiorna le impostazioni per utilizzare Google DNS
  • Se il router non supporta questa funzionalità, aggiorna le impostazioni DNS direttamente su ciascun dispositivo che interagisce con il sistema IoT per utilizzare Google DNS
Note:
  • Alcuni dispositivi IoT, come i terminali di pagamento, potrebbero non richiedere modifiche DNS poiché sono tipicamente preconfigurati con impostazioni DNS personalizzate
  • Su alcuni browser, viene visualizzato un codice di errore che menziona il DNS (come DNS_PROBE_FINISHED_NXDOMAIN) ::

Problemi con la generazione del certificato HTTPS

Il certificato HTTPS non viene generato

Le cause potenziali includono:
  • Il database non soddisfa i requisiti di idoneità per generare un certificato HTTPS
  • Il firewall impedisce la corretta generazione del certificato HTTPS. In questo caso, disattiva il firewall fino a quando il certificato non viene generato correttamente
Alcuni dispositivi, come i router con firewall integrato, possono impedire la generazione del certificato HTTPS.
Quando accedi alla homepage del sistema IoT, controlla automaticamente la presenza di un certificato HTTPS e tenta di generarne uno se mancante. Se appare un errore, aggiorna la pagina per vedere se il problema è risolto.

Codici di errore certificato HTTPS

Un codice di errore specifico viene visualizzato nella homepage del sistema IoT se si verificano problemi durante la generazione o la ricezione del certificato HTTPS.

ERR_IOT_HTTPS_CHECK_NO_SERVER

La configurazione del server è mancante, ovvero il database non è connesso al sistema IoT.

Soluzione: Connetti il database al sistema IoT tramite il codice di abbinamento.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

Si è verificato un errore durante il tentativo di leggere il certificato HTTPS esistente.

Soluzione: Verifica che il file del certificato HTTPS sia leggibile. Potrebbe essere necessario rigenerare il certificato.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

Il contratto e/o l'UUID del database mancano dall'IoT.

Soluzione:

  1. Accedi alla homepage del box IoT o dell'IoT virtuale Windows
  2. Clicca il pulsante ⚙️ (impostazioni)
  3. Seleziona Credentials
  4. Verifica che entrambi i valori (Contract e Database UUID) siano configurati correttamente

ERR_IOT_HTTPS_LOAD_REQUEST_EXCEPTION

Si è verificato un errore imprevisto mentre il sistema IoT tentava di raggiungere https://www.odoo.com. Questo è probabilmente dovuto a problemi di rete, come:

  • Il sistema IoT non ha accesso a Internet
  • Restrizioni di rete (ad es. firewall o VPN) impediscono la comunicazione con https://www.odoo.com
Debug avanzato:Per accedere ai dettagli completi dell'eccezione della richiesta:
  1. Abilita la modalità sviluppatore in Laundry ERP
  2. Clicca sulla card del sistema IoT nell'app IoT
  3. Seleziona Download logs nel modulo del sistema IoT
  4. Per definire i livelli di log registrati, accedi alla homepage del sistema IoT, clicca ⚙️, quindi Log level in fondo alla pagina ::

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

Il sistema IoT ha raggiunto con successo https://www.odoo.com ma ha ricevuto una risposta HTTP (codici di stato) inaspettata.Questo codice di errore include lo stato HTTP. Ad esempio, ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404 significa che il server ha restituito una risposta "Page Not Found".Soluzione:
  1. Apri https://www.odoo.com in un browser web per verificare se il sito è temporaneamente offline per manutenzione
  2. Se il sito è operativo, contatta il supporto tecnico assicurandoti di includere il codice di stato HTTPS a 3 cifre

ERR_IOT_HTTPS_LOAD_REQUEST_NO_RESULT

Il sistema IoT si è connesso con successo a https://www.odoo.com, ma il server ha rifiutato di fornire il certificato HTTPS.Soluzione: Verifica che il sistema IoT e il database soddisfino i requisiti di idoneità per un certificato HTTPS.
Contesto lavanderia industriale:I certificati HTTPS sono particolarmente importanti per:
  • Comunicazioni sicure con terminali di pagamento
  • Protezione dei dati sensibili dei clienti
  • Conformità agli standard PCI-DSS per pagamenti con carta
  • Tracciabilità sicura dei capi tramite lettori RFID ::

Diagnostica Generale

Per qualsiasi problema non risolto con le soluzioni sopra:
  1. Verifica i log: Scarica i log del sistema IoT dalla relativa card nell'app IoT
  2. Controlla la rete: Assicurati che non ci siano firewall o proxy che blocchino la comunicazione
  3. Aggiorna il sistema: Verifica che database e sistema IoT siano aggiornati alla stessa versione
  4. Contatta il supporto: Se il problema persiste, contatta il supporto tecnico con i log e la descrizione dettagliata del problema

Connessione SSH al Box IoT

Configurazione dell'accesso SSH remoto al box IoT per debugging avanzato.

Aggiornamenti Sistema IoT

Procedura per aggiornare l'immagine, il codice core e i driver del sistema IoT.