# Aggiornamento

**OpenSTAManager** supporta due procedure distinte per il caricamento degli aggiornamenti:

* Automatici tramite caricamento del file ZIP nel modulo Aggiornamenti
* Manuali tramite la scompattazione del file ZIP

Per un approfondimento su entrambe queste tipologie, siete pregati di visitare la sezione sui [Dettagli tecnici](#dettagli-tecnici).

Dopo il caricamento dell'aggiornamento, potrebbe richiedere richiesto anche l'aggiornamento del database.

In questo caso, ogni utente presente all'interno del gestionale verrà automaticamente reindirizzato verso il logout e sarà possibile aggiornare il database come richiesto attraverso delle apposite schermate e il pulsante ![](https://879434904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudbmyQrl0FL3lcDlHZWD%2Fuploads%2FTZWIBSyuwEjQ6xQaEIVg%2FAggiorna.PNG?alt=media) .

Al termine dell'aggiornamento si presenterà la seguente schermata.​

![Aggiornamento del database completato](https://879434904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudbmyQrl0FL3lcDlHZWD%2Fuploads%2FceiTPmpwjd7eJwbMd5ho%2Fupdated.png?alt=media)

## ⚠️ Errori di aggiornamento

La procedura di aggiornamento, come ogni componente software, è soggetta a possibili errori.

![Errore aggiornamento](https://879434904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudbmyQrl0FL3lcDlHZWD%2Fuploads%2F0m9Syc2X08NvRtyNIzsD%2Ferror.png?alt=media)

Nel caso questi si verifichino, l'utente dovrebbe riuscire a visualizzare il seguente messaggio informativo:

![Errore aggiornamento](https://879434904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FudbmyQrl0FL3lcDlHZWD%2Fuploads%2F3KhX3oySmcNwSEg5QdV1%2Falready-updating.png?alt=media)

In questi casi, si consiglia di contattare gli sviluppatori ufficiali e di consultare il [forum ufficiale](https://www.openstamanager.com/forum/) per eventuali segnalazioni simili.

## 🔄 Aggiornamento in corso

{% hint style="info" %}
Mentre l'aggiornamento è in esecuzione, il gestionale rimarrà bloccato per tutti gli utenti ad eccezione di quello responsabile dell'inizio della procedura di aggiornamento.

Nel caso la procedura rimanga persistente per un periodo molto prolungato di tempo, è possibile che si sia verificato un errore non rilevato dall'utente durante l'aggiornamento. In questo caso si consiglia di consultare la sezione di [Ripresa forzata](#ripresa-forzata) oppure di contattare gli sviluppatori ufficiali.
{% endhint %}

### 🔃 Ripresa forzata

In alcuni casi particolari, può essere necessario riprendere forzatamente l'esecuzione di un aggiornamento andato in errore.

Questo viene reso possibile visitando l'URL a cui è possibile accedere a OpenSTAManager con l'aggiunta del testo `?force`.

{% hint style="warning" %}
**Attenzione**: quest'azione è sconsigliata a utenti non esperti.
{% endhint %}

### ⏺️ Aggiornamento semplificato

La procedura di aggiornamento semplificato ha l'obiettivo di fornire un sistema di facile utilizzo per favorire l'aggiornamento, e migliorare in questo modo l'interazione con l'utente finale.

L'utilizzo di questa procedura è però sottoposto alla seguenti condizioni nelle impostazioni PHP:

* `upload_max_filesize` >= 16MB
* `post_max_size` >= 16MB

Di seguito la procedura:

1. Accedere con un account amministrativo
2. Entrare nel modulo **Aggiornamenti** (disponibile nel menu principale a sinistra, eventualmente sotto la dicitura **Strumenti**)
3. Selezionare il file *.zip* della release attraverso l'apposita sezione "Carica un aggiornamento" e cliccare sul pulsante "Carica"

Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.

### ⏹️ Aggiornamento manuale

La procedura di aggiornamento manuale è resa disponibile per ovviare ai problemi relativi al caricamento del file *.zip* (in alcuni casi il file non viene correttamente rilevato, non sono disponibili i permessi per caricare file oppure la dimensione del file eccede il limite di upload sul server).

Di seguito la procedura:

1. De-comprimere il contenuto del file *.zip* in una cartella temporanea
2. Rinominare il file `VERSION` dell'installazione corrente in `VERSION.old` (rispettando minuscole e maiuscole) \[facoltativo a partire dalla versione 2.3]
3. Copiare i file della nuova versione dalla cartella temporanea alla cartella del server, in modo che le cartelle principali (`files`, `modules`, `templates`, ...) vengano sovrascritte

Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.