# 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](https://gsdoc.genesyssoftware.eu/link/37807).

## 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](https://gsdoc.genesyssoftware.eu/link/37804). 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.

<p class="callout info">**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`.</p>