🆙Aggiornamento

Come aggiornare OpenSTAManager

Con il passaggio da OSM 2.4.54 a OSM 2.5 sono cambiati i requisiti di php del gestionale. Per poter utilizzare le versioni a partire dalla 2.5 è pertanto necessario effettuare l'aggiornamento estraendo manualmente lo zip della release all'interno della directory in cui si trova il gestionale.

La procedura corretta per installare i nuovi aggiornamenti di OSM è:

• eseguire i controlli di integrità del database e correggere ogni errore segnalato, in modo da evitare che le query diano errore in fase di aggiornamento: https://docs.openstamanager.com/v/2.8.1/guide/esempi/verificare-linstallazione-di-osm#controllo-sul-database

• effettuare un backup del gestionale

• cambiare versione di php in php>=8.1

• estrarre lo zip della release all'interno della root del gestionale

• seguire la procedura guidata dell'aggiornamento, cliccando sul tasto Aggiorna!

Nel caso di aggiornamento da vecchie versioni consigliamo di cancellare il file config.inc.php e di ricrearlo tramite procedura guidata, che si avvierà automaticamente al primo accesso al gestionale.

Con l'aggiornamento di alcune librerie di composer nella versione 2.8, per poter aggiornare il gestionale potrebbe essere necessario cancellare la cartella vendor ed estrarre manualmente i file presenti nella release nella root del gestionale. Questo perchè vecchi file presenti in vendor danno errore in fase di aggiornamento. A partire dalla versione 2.8.1 la sovrascrittura completa della cartella vendor è stata gestita.

● Errori di aggiornamento

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

In questi casi, si consiglia di contattare gli sviluppatori ufficiali e di consultare il forum ufficiale per eventuali segnalazioni simili.

● Aggiornamento in corso

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 oppure di contattare gli sviluppatori ufficiali.

● 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=1.

Attenzione: quest'azione è sconsigliata a utenti non esperti.