# JM4.3 - Se qualcosa non va

**In una frase.** I problemi più comuni di un aggiornamento, come «vedo questo, faccio questo», e le parole da sapere.

Quando un aggiornamento non va, la domanda utile è: a che passo si è fermato? Prima del clic non è cambiato niente sul server. Dopo il clic, quasi sempre il problema è un servizio solo, e quasi sempre gli manca qualcosa per partire.

## Per chi usa il gestionale

- **Vedo «Errore server 503» subito dopo un aggiornamento.** I servizi stanno ripartendo. Aspetta un minuto e riprova.
- **Dopo qualche minuto l'errore c'è ancora, su una funzione sola.** Quel servizio non è partito. Il resto puoi usarlo. Avvisa chi gestisce il server.
- **Stavo lavorando in una maschera storica e la sessione si è chiusa.** L'aggiornamento ha riacceso il Ponte col COBOL. Rientra: il lavoro non confermato va rifatto.
- **Non vedo la funzione nuova.** Ricarica la pagina. Se non c'è ancora, il pulsante del deploy forse non è stato premuto: la modifica è pronta ma non è sul server.

## Per chi fa l'aggiornamento

- **La pipeline non è partita.** Parte solo quando la modifica entra nella versione principale. Su un ramo a parte non parte niente.
- **Il build non ha ricostruito niente.** È giusto, se la modifica non tocca nessun servizio: per esempio solo documentazione.
- **Il deploy si ferma subito e nomina una password.** Mancano le righe dell'Assistente dei dati nel file delle impostazioni. Non ha toccato nessun servizio: aggiungile e premi di nuovo.
- **Ogni comando si ferma e chiede `AUTH_ENABLED`.** La riga è obbligatoria nel file delle impostazioni: scrivila, con `true` o `false`.
- **GPEnext torna sempre «sta partendo».** Mancano le righe del suo archivio: `GPE_DB_URL`, `GPE_DB_USER`, `GPE_DB_PASSWORD`. Oppure l'archivio non è stato creato.
- **GPEnext è acceso ma l'importazione dei vecchi modelli non elenca niente.** Nella cartella dei dati GPE manca la sottocartella `local/model`, o il servizio non la può leggere.
- **Un servizio che non avevo toccato è ripartito.** È cambiata una sua impostazione, o un file che entra nella sua impronta.
- **Ho tolto un servizio dall'elenco ma gira ancora.** Il deploy non spegne chi esce dall'elenco: va fermato a mano.
- **Un servizio dà 503 e non passa.** Guarda sul server la pagina del Monitor servizi e il registro del servizio: vedi il libro JC - Gateway e Monitor servizi.

Se serve tornare alla versione di prima: [Tornare indietro](https://gsdoc.genesyssoftware.eu/link/37915).

## Parole da sapere

- **Server di prova.** L'installazione dove si guarda il lavoro prima di portarlo altrove. Oggi è l'unica tenuta aggiornata dalla pipeline.
- **Versione principale.** Il codice approvato, da cui si costruisce ciò che va sul server.
- **Pipeline.** La sequenza di passi automatici: test, build, deploy.
- **Build.** Preparare la versione nuova di un servizio. Non cambia ancora niente sul server.
- **Deploy.** Mettere la versione nuova al posto della vecchia. Parte con un clic.
- **Impronta.** Il segno che dice se il contenuto di un servizio è cambiato. Uguale: non si ricostruisce.
- **Contenitore.** La scatola chiusa in cui gira un servizio, con tutto ciò che gli serve.
- **File delle impostazioni.** Il file sul server con indirizzi, cartelle e password. Non sta nel codice.
- **Migrazione.** Un passaggio che cambia la forma di un archivio. Parte da solo all'avvio del servizio e va solo in avanti.
- **Avviso.** La voce che dice cosa fare dopo un cambiamento.

<p class="callout info">**Per chi sviluppa.** Registri e stato: `docker compose ps` e `docker logs <contenitore>` sul server. I passi operativi, con la verifica di ognuno, sono in `devops/deploy/RUNBOOK-simil-prod.md`.</p>