Passa al contenuto principale

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.