# Hotfix: Aggiornamenti importanti

<span>Per le versioni supportate (vedi </span>[Product EOL)](https://usermanual.vtenext.com/books/product-eol-%28end-of-life%29 "Product EOL (End of Life)")<span> è possibile applicare degli aggiornamenti importanti (hotfix) senza necessariamente aggiornare vtenext all'ultima versione.</span>

Spesso l'aggiornamento di versione non può essere immediato a causa di personalizzazioni sul codice o di necessità di formazione del personale.  
Abbiamo quindi introdotto un nuovo strumento che permette di installare miglioramenti di stabilità e sicurezza per le installazioni che non possono essere subito aggiornate.

Questi hotfix includono miglioramenti di performance, soluzioni a bug impattanti, patch di sicurezza, ecc. ed è quindi consigliato applicarli immediatamente.

Dalla versione 25.02.2 l'installazione degli hotfix è integrata nel sistema di aggiornamento presente nelle Impostazioni mentre per tutte le versioni precedenti supportate sarà possibile applicarli tramite lo script vteUpdater.

# Installazione di hotfix tramite vteUpdater

Lo script vteUpdater supporta l'applicazione di hotfix dalla versione 1.64 quindi per aggiornarlo all'ultima versione posizionarsi nella cartella root di vtenext ed eseguire il comando:  
`./vteUpdater.sh --force-upgrade`

Il modo più semplice è lanciare il vteUpdater con il parametro `--hotfix` (o `-x`) che cercherà, scaricherà e installerà gli hotfix disponibili per la versione installata:  
`./vteUpdater.sh -x`

è anche possibile specificare manualmente la patch da installare:  
`./vteUpdater.sh --hotfix=ID`Dove ID è l'id di un hotfix, ad esempio: "2887\_2926/hotfix\_20250701.tgz"

Per vedere tutti gli hotfix disponibili per la versione installata si usa l'opzione `--list-hotfix`, che mostra anche l'ID degli hotfix e lo stato (installato, bloccato o non installato):  
`./vteUpdater.sh --list-hotfix`

E' possibile anche bloccare uno specifico hotfix nel caso in cui questo non si debba installare in automatico (es. perchè non è compatibile con del codice custom presente):  
`./vteUpdater.sh --block-hotfix=ID`Mentre per sbloccare:  
`./vteUpdater.sh --unblock-hotfix=ID`

Se un hotfix causa problemi, lo si può rimuovere con il seguente comando e i file che erano stati sovrascritti verranno ripristinati con quelli precedenti:  
`./vteUpdater.sh --revert-hotfix=ID`NOTA: Se l'hotfix ha eseguito anche degli script dopo la copia dei file, quello che faceva lo script non è noto e le modifiche effettuate dallo script NON verranno ripristinate.

Prima di applicare l'hotfix lo script verifica che i file che si andranno a sovrascrivere non siano stati modificati ed eventualmente elenca questi file e si interrompe. In questo caso consigliamo di verificare quali sono le differenze, applicare comunque l'hotfix e riapplicare se necessario le modifche a quei file. Per forzare l'hotfix ignorando la verifica dei file usare l'opzione `--skip-file-check`:  
`./vteUpdater.sh --hotfix --skip-file-check`