JC4.3 - Se qualcosa non va
In una frase. I problemi più comuni con Gateway e Monitor servizi, come «vedo questo, faccio questo», e le parole da sapere.
Quando una pagina non risponde, la domanda utile è: dove si è fermata la richiesta? Il numero dell'errore lo dice quasi sempre. Qui trovi cosa fare caso per caso.
Per chi usa il gestionale
- Mi ritrovo alla pagina di accesso mentre lavoravo. Il lasciapassare non vale più. Rientra: è l'errore 401.
- Vedo «Accesso negato». Il tuo livello non basta per quella operazione. Chiedi a chi amministra: è l'errore 403.
- Vedo «Errore server 503» subito dopo un aggiornamento. I servizi stanno ripartendo. Aspetta un minuto e riprova.
- Vedo «Errore server 503» su una cosa sola, per esempio le stampe. È fermo quel servizio. Il resto puoi usarlo. Avvisa chi gestisce il server.
- Vedo «Server non raggiungibile» o «Errore server 502». Non risponde il Gateway, oppure è caduta la rete. Controlla la connessione, poi avvisa chi gestisce il server.
- Le pagine nuove non vanno, le maschere storiche sì. Può succedere: fanno due strade diverse. Il problema è dalla parte del Gateway.
I tre numeri sono spiegati in Errori 401, 403 e 503: cosa vogliono dire.
Per chi gestisce il server
- Un servizio dà 503 e non passa. Apri la pagina del Monitor servizi e guarda se è nell'elenco: vedi Vedere quali servizi sono accesi. Se manca, guarda il registro di quel servizio: non è partito o non raggiunge il Monitor servizi.
- Tutti i servizi danno 503. Controlla che il Monitor servizi sia acceso. Senza di lui i servizi non riescono a iscriversi.
- Tutti ricevono 401, anche appena entrati. Il Gateway non riesce a verificare i lasciapassare: controlla gli indirizzi dell'Accesso nella configurazione. Se mancano, li rifiuta tutti.
- Dal mio PC la pagina del Monitor servizi non si apre. È voluto: si apre solo dal server.
- Un servizio spento compare ancora nell'elenco. Il Monitor servizi aspetta prima di cancellarlo.
Parole da sapere
- Gateway. La porta unica: controlla chi sei e manda ogni richiesta al servizio giusto.
- Monitor servizi. L'elenco dei servizi accesi, con nome e indirizzo.
- Servizio. Un programma che fa una cosa sola: le stampe, i dati del gestionale, le schermate.
- Richiesta. Una domanda che la pagina fa a un servizio: «dammi questa tabella», «salva questo».
- Rotta. La regola del Gateway che lega l'inizio di un indirizzo a un servizio.
- Lasciapassare. La prova che sei entrato: lo firma l'Accesso, dice chi sei e che livello hai, scade dopo poco.
- Livello. Quello che puoi fare: lettore, base, avanzato, staff.
- Iscriversi. Quello che fa un servizio quando si accende: dice al Monitor servizi «sono qui».
- Ponte col COBOL. L'altra strada: porta le maschere storiche nel browser, senza passare dal Gateway.
Per chi sviluppa. Lo stato si controlla con /actuator/health su Gateway e servizi. Variabili e porte: docs/devops/ENVIRONMENT.md e devops/deploy/README.md.
Nessun commento