Guida di aggiornamento versione

• Aggiornamento tramite interfaccia Web
• Aggiornamento dal terminale

Aggiornamento tramite interfaccia Web

Prerequisiti

Prima di avviare la procedura di aggiornamento, verificare che siano soddisfatti i seguenti requisiti:

1. vtenext deve essere aggiornato almeno alla versione 25.02.2. Solo a partire da questa versione è possibile procedere con l'aggiornamento alla release 26.*.
2. Deve essere presente una licenza valida e attiva.
3. Deve essere disponibile un utente amministratore attivo con autenticazione locale (autenticazione tramite password locale senza autenticazione a due fattori).

Procedura di aggiornamento

Nella versione 25.02.2, se è abilitato il controllo automatico degli aggiornamenti, l'utente amministratore riceverà una notifica della disponibilità della nuova versione, che segnalerà la necessità di aggiornare la versione di PHP.

A questo punto sono disponibili due possibili modalità per proseguire con l'aggiornamento.

• Migrazione su un nuovo server
  La soluzione consigliata consiste nello spostare l'intera installazione su un nuovo server con:
  - Ubuntu Server 24.04 (raccomandato);
  - PHP 8.3;
  - tutti i pacchetti richiesti dalla documentazione di installazione.
  Dopo la migrazione verificare che:
  - il file config.inc.php contenga i corretti parametri di connessione al database;
  - tutti i cron job siano stati configurati e attivati correttamente sul nuovo server.

• Aggiornamento del server esistente. In alternativa è possibile aggiornare direttamente il sistema operativo del server attuale installando una versione compatibile con PHP 8.3. Prima di procedere è fortemente consigliato creare uno snapshot (o un backup completo) della macchina, così da poter ripristinare rapidamente l'ambiente in caso di problemi.

Una volta completata la migrazione o l'aggiornamento del server, vtenext entrerà automaticamente in modalità "Update Only".
In questa modalità l'applicazione consentirà esclusivamente il completamento della procedura di aggiornamento e non sarà possibile utilizzare normalmente il CRM fino al termine dell'upgrade.

Dopo aver effettuato l'accesso con un utente amministratore, il sistema mostrerà una pagina semplificata dedicata esclusivamente all'aggiornamento.

Se i cron job di vtenext non sono attivi o non sono stati eseguiti di recente, la pagina di aggiornamento potrebbe non mostrare la disponibilità della nuova versione. In questo caso fare clic sul pulsante "Check now" e attendere alcuni minuti. Se l'aggiornamento continua a non essere disponibile, eseguire manualmente il cron dalla directory di installazione di vtenext:
./cron/RunCron.sh  In alcuni casi potrebbe essere necessario eseguire il comando due volte, fino a quando l'output non mostrerà un messaggio simile a "[INFO] Found new version available (...), checking for compatibility...", a conferma che il sistema ha rilevato la nuova versione e ne sta verificando la compatibilità prima di consentire l'aggiornamento.

Dopo aver fatto clic sul pulsante "Inizia aggiornamento", il sistema mostrerà un'ultima schermata di conferma.

Una volta confermato, l'aggiornamento verrà eseguito in background. Se i cron job sono attivi, la procedura proseguirà automaticamente. In caso contrario, sarà necessario eseguire manualmente il comando ./cron/RunCron.sh dalla directory di installazione di vtenext fino al completamento dell'intero processo di aggiornamento.

Quando inizia l'aggiornamento l'utente vedrà questa schermata:

Durante l'aggiornamento è consigliabile aggiornare la pagina del browser ogni 5-10 minuti per verificare l'eventuale presenza di errori o anomalie. Al termine della procedura, il sistema reindirizzerà automaticamente alla pagina di login. A questo punto sarà possibile autenticarsi e iniziare a utilizzare la nuova versione di vtenext.

 

Aggiornamento dal terminale

Prerequisiti

Prima di procedere con l'aggiornamento, assicurarsi che siano soddisfatte le seguenti condizioni:

1. vtenext deve essere aggiornato alla versione 25.02.2. Solo a partire da questa versione è possibile procedere con il passaggio successivo dell'aggiornamento.
2. Deve essere presente una licenza valida e attiva.
   

La seguente procedura è dis

Aggiornamento con vteUpdater

Poiché questa versione di vtenext supporta esclusivamente PHP 8.3 o superiore, sono disponibili due modalità di aggiornamento:

• Spostare l'intera installazione su un nuovo server con PHP 8.3 (è consigliato Ubuntu Server 24.04), completo di tutti i pacchetti necessari (fare riferimento alla pagina Requisiti di Installazione). In questo caso, verificare che i parametri di connessione presenti nel file config.inc.php siano corretti nel nuovo server.

• Aggiornare il sistema operativo del server attuale a una versione che includa PHP 8.3. In questo caso è fortemente consigliato eseguire uno snapshot del sistema prima di avviare la procedura di aggiornamento.

Dopo questo, è possibile avviare la procedura di aggiornamento:

1. Accedere tramite SSH al server che ospita vtenext e posizionarsi nella relativa directory.
2. Se vengono rilevati errori, verrà mostrato un log che consentirà di valutarli e scegliere se ripristinare il sistema utilizzando i backup creati in precedenza oppure proseguire e completare l'aggiornamento.
   Proseguendo l'aggiornamento in presenza di errori, la fase di post-update verrà saltata e dovrà essere eseguita manualmente con il comando:
   ./vteUpdater.sh --only-delete
   Questa fase viene eseguita automaticamente se non vengono rilevati errori.
   Questa fase elimina i file obsoleti e applica gli script al termine dell'aggiornamento.
3. Eseguire ./vteUpdater.sh (rendendolo eseguibile, se necessario) e seguire le istruzioni.
   L'output dovrebbe essere simile al seguente:
   

   root@testhost:/var/www/html/vte3001upd# ./vteUpdater.sh
   
   VTE Automatic Updater -- version 1.72
   [INFO] Checking for upgrades of this script...
   [INFO] Found VTE at revision 3001
   [INFO] Checking for latest available version...
   
   You can update to revision ????, . Do you want to proceed? (Y/N) : y
   
   Please type your username : **********
   Password: *****************
   [INFO] Validating credentials...
   [INFO] Downloading package...
   [INFO] Packages downloaded succesfully
   [INFO] Updating VTE to revision ????
   mysql: [Warning] Using a password on the command line interface can be insecure.
   mysql: [Warning] Using a password on the command line interface can be insecure.
   [INFO] Database size is 140 MB, (biggest table is sdk_language, 15 MB)
   
   The user and group for the web server have been detected as www-data:www-data. Is this correct? (Y/N) : y
   [INFO] Starting file comparison...
   File comparison: [########################################] 100%
   [INFO] No differences found
   [INFO] Waiting 2 minutes for cron processes to finish...
   [INFO] Creating backup of VTE files...
   Do you want to backup the database? (Y/N) : y
   [INFO] Creating backup of database...
   [INFO] Starting update...
   [INFO] Files copied. Executing schema update...
   [INFO] Removing obsolete files...
   [WARNING] The file ./config.template.php might have some custom code, left untouched
   [INFO] Removed 6289 files and 1126 directories
   [INFO] Executing post-delete scripts...
   [INFO] Update notes:
   [INFO] The obsolete module Dashboard has been eliminated, as well as the method SDK::setDashboard
   [INFO] If you were still using Dashboards, please migrate them to Charts or custom Iframe
   [INFO] 
   [INFO] Classes Vtiger_Net_Client and Vtiger_Feed_Parser have been eliminated.
   [INFO] Please review the custom code if they were still used
   [INFO] 
   [... redacted ...]
   [INFO] 
   [INFO] Update successful!

   Se si verificano errori, è possibile consultare il log per valutarne la gravità e scegliere se ripristinare il sistema utilizzando i backup creati in precedenza oppure proseguire e completare l'aggiornamento.

   Se vengono rilevati errori e si decide di proseguire, la fase di post-update verrà saltata e dovrà essere eseguita manualmente con il comando:

   ./vteUpdater.sh --only-delete

   Questa fase viene eseguita automaticamente se non vengono rilevati errori.

   Questa fase elimina i file obsoleti e applica gli script una volta completato con successo l'aggiornamento.

   
   

4. Nel caso siano presenti modifiche personalizzate al codice, queste dovranno essere riportate manualmente nella nuova versione e verificate per assicurarsi che siano compatibili con PHP 8.3. Fare riferimento al manuale per gli sviluppatori per conoscere le modifiche introdotte.

   È inoltre disponibile una review skill utilizzabile con gli agenti AI all'interno del proprio IDE, che aiuta ad adattare il codice alla nuova versione.

   Maggiori dettagli sono disponibili nella documentazione.