Aggiorna¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 16.0 to Odoo 18.0). Regular upgrades are crucial as each version offers new features, bug fixes, and security patches. Using a supported version is strongly recommended. Each major version is supported for three years.
Depending on the hosting type and Odoo version used, a database upgrade can be mandatory.
If a database is on a major version (e.g., 16.0, 17.0, 18.0), an upgrade is mandatory every two years.
If a database is on a minor version (e.g., 17.1, 17.2, 17.4), an upgrade is mandatory a few weeks after the next version is released. Minor versions are usually released every two months.
After the initial three years of support, you will have another two years to complete the upgrade. You will be notified when an upgrade is required.
You can stay on the same version indefinitely, even if it is not recommended. Note that the smaller the version gap, the easier the upgrade should be.
You will receive a notification in your database a few weeks before a mandatory upgrade will be automatically carried out. You are in control of the process as long as the deadline is not reached.
Concretely, Odoo’s Upgrade Team performs a silent test upgrade of every database that should be upgraded. If the test is successful and lasts less than 20 minutes, you can directly trigger the upgrade from the database. If the test fails, you can test an upgrade using the database manager.
When you are invited to upgrade, it is strongly recommended to request an upgraded test database first and spend time testing it.
An automatic upgrade to the next version will be triggered if no action is taken before the specified due date.
Un aggiornamento non copre:
Il passaggio ad una versione precedente di Odoo
Il cambiamento di versione (ad es., da Community a Enterprise)
Il cambiamento del tipo di hosting (ad es., da on-premise a Odoo Online)
La migrazione da un altro ERP a Odoo.
Avvertimento
If your database contains custom modules, it cannot be upgraded until a version of your custom modules is available for the target version of Odoo. For customers maintaining their own custom modules, we recommend to parallelize the process by requesting an upgraded database while also upgrading the source code of your custom modules.
L’aggiornamento in breve¶
Request an upgraded test database (see obtaining an upgraded test database).
Se possibile, aggiorna il codice sorgente del modulo personalizzato per renderlo compatibile con la nuova versione di Odoo (consulta la pagina Upgrade a customized database).
Thoroughly test the upgraded database (see testing the new version of the database).
Report any issue encountered during the testing to Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)».
Una volta che tutti i problemi sono stati risolti e sei sicuro che il database aggiornato possa essere utilizzato come database principale senza problemi, pianifica l’aggiornamento del database di produzione.
Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database).
Report any issue encountered during the upgrade to Odoo by going to the Support page and selecting «An issue related to my upgrade (production)».
Ottenere un database di prova aggiornato¶
The Upgrade page is the main platform for requesting an upgraded database. However, depending on the hosting type, you can upgrade from the command line (on-premise), the Odoo Online database manager, or your Odoo.sh project.
Nota
La piattaforma di aggiornamento segue la stessa Informativa sulla privacy degli altri servizi Odoo.com. Consulta il Regolamento Generale Protezione Dati per sapere di più sul modo in cui Odoo gestisce i tuoi dati e la tua privacy.
Odoo Online databases can be manually upgraded via the database manager.
La pagina di gestione dei database mostra tutti i database associati all’account dell’utente. I database non aggiornati alla versione più recente di Odoo vengono visualizzati con una freccia in un’icona a forma di cerchio accanto al loro nome indicando la possibilità di eseguire l’aggiornamento.
Fai clic sull’icona con una freccia in un cerchio per avviare il processo di aggiornamento. Nella finestra pop-up, inserisci:
La versione di Odoo che vuoi ottenere con l’aggiornamento, di solito l’ultima versione
L’indirizzo e-mail che dovrebbe ricevere il link al database aggiornato
Lo Scopo dell’aggiornamento che viene impostato automaticamente su Test per la prima richiesta di aggiornamento
La dicitura Aggiornamento in corso viene visualizzata accanto al nome del database fino al completamento. Una volta che il processo è stato completato, verrà inviato un’e-mail all’indirizzo fornito contenente il link al database di prova aggiornato. È possibile accedere al database anche attraverso la pagina di gestione degli stessi facendo clic sulla freccia a discesa che si trova a sinistra del nome del database.
Odoo.sh viene integrato con la piattaforma di aggiornamento per semplificare il processo.
The latest production daily automatic backup is then sent to the Upgrade platform.
Una volta che la piattaforma di aggiornamento ha completato l’aggiornamento del back-up e lo ha caricato nel branch, viene attivata la modalità speciale*: ogni volta che si esegue il push del commit sul branch, si verifica una operazione di ripristino del back-up aggiornato e un aggiornamento di tutti i moduli personalizzati. L’attività permette di testare i moduli personalizzati su una copia incontaminata del database aggiornato. Il file di registro del processo di aggiornamento può essere trovato nella nuova build di staging andando su ~/logs/upgrade.log
.
Importante
Nei database con moduli personalizzati installati, il codice sorgente deve essere aggiornato con la versione di destinazione di Odoo prima che l’aggiornamento venga eseguito. Se non ce ne sono, la modalità «aggiorna su commit» viene saltata, il database aggiornato viene costruito non appena verrà trasferito dalla piattaforma di aggiornamento e si uscirà dalla modalità di aggiornamento.
Consulta la pagina Upgrade a customized database per maggiori informazioni.
Il processo di aggiornamento standard può essere avviato inserendo la seguente riga di comando nel dispositivo che ospita il database:
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Nota
This command has some requirements on the environment it runs in:
Some external commands that must be provided by the operating system, normally found in any Linux distribution (including WSL). An error will be displayed if one or several of them are missing.
The system user that executes the command needs to be configured with access to the database. Please refer to the PostgreSQL documentation of the client environment or the client password file for this requirement.
The script needs to be able to reach one or multiple servers of the upgrade platform both on TCP port 443 and to any random TCP port in the range between 32768 and 60999. This can be in conflict with your restrictive firewall and may need an exception added to the firewall configuration.
Il seguente comando può essere utilizzato per visualizzare il supporto generale e i comandi principali:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Importante
Nei database in cui sono installati moduli personalizzati, il codice sorgente deve essere aggiornato alla versione di destinazione di Odoo prima che l’aggiornamento possa essere eseguito. Consulta la pagina Upgrade a customized database per maggiori informazioni.
Nota
Per motivi di sicurezza, solo la persona che ha inviato la richiesta di aggiornamento può scaricarlo.
Per motivi di archiviazione, la copia del database viene inviata al server di aggiornamento senza un filestore. Pertanto, il database aggiornato non contiene il filestore di produzione.
Prima di ripristinare il database aggiornato, il filestore deve essere unito al filestore di produzione per essere in grado di eseguire test nelle condizioni che saranno anche quelle della nuova versione.
Il database aggiornato contiene:
Il file
dump.sql
contiene il database aggiornatoUna cartella
filestore
contenente file estratti dai record del database come allegati (se ce ne sono) e nuovi file Odoo standard dalla versione Odoo di destinazione (ad es., nuove immagini, icone, loghi dei fornitori di pagamento, ecc.). Questa è la cartella che deve unita al filestore di produzione per ottenere il filestore completamente aggiornato.
Nota
È possibile richiedere database di prova multipli se vuoi provare un aggiornamento più di una volta.
Nota
Quando una richiesta di aggiornamento viene completata, un resoconto relativo all’aggiornamento viene allegato all’e-mail di aggiornamento riuscito ed è disponibile nell’app Comunicazioni per gli utenti che fanno parte del gruppo «Amministrazione/Impostazioni». Il resoconto fornisce informazioni importanti sui cambiamenti introdotti dalla nuova versione.
Testare la nuova versione del database¶
It is essential to test the upgraded test database to ensure that you are not stuck in your day-to-day activities by a change in views, behavior, or an error message once the upgrade goes live.
Nota
I database di prova sono neutralizzati e alcune funzionalità vengono disattivate per evitare di avere un impatto sul database di produzione:
Le azioni programmate sono disattivate.
I server e-mail in uscita vengono disabilitati archiviando quelli esistenti e aggiungendone uno falso.
I fornitori di pagamento ed i corrieri vengono ripristinati all’ambiente di test.
La sincronizzazione bancaria viene disattivata. Se vuoi testare la sincronizzazione, contatta il tuo fornitore per ottenere credenziali sandbox.
Ti consigliamo di testare il maggior numero possibile di flussi aziendali per assicurarti che funzionino correttamente e per acquisire maggiore familiarità con la nuova versione.
Elenco test di base
Ci sono viste disattivate nel database di prova ma attive nel database di produzione?
Le viste che utilizzi di solito vengono ancora visualizzate correttamente?
I tuoi rendiconti (fatture, ordini di vendita, ecc,) vengono generati correttamente?
Le pagine del tuo sito web funzionano correttamente?
Sei capace di creare e modificare record? (Ordini di vendita, fatture, acquisti, utenti, contatti, aziende, ecc.)
Stai riscontrando problemi con i modelli e-mail?
Stai riscontrando problemi con traduzioni salvate?
I tuoi filtri di ricerca sono ancora presenti?
Puoi esportare i dati?
Controllare un prodotto a caso nel tuo catalogo e comparare i dati di test e produzione per verificare tutto è la stessa cosa (categoria prodotto, prezzo di vendita, costo, fornitore, conti, percorsi, ecc.).
Acquistare il prodotto (app Acquisti).
Confermare la ricezione del prodotto (app Magazzino).
Verificare che il percorso per ricevere il prodotto sia lo stesso nel database di produzione (app Magazzino).
Vendere il prodotto (app Vendite) ad un cliente casuale.
Aprire il database del cliente (app Clienti), selezionare un cliente (o azienda) e verificare i dati.
Spedire il prodotto (app Magazzino).
Verificare che il percorso per spedire il prodotto sia lo stesso nel database di produzione (app Magazzino).
Convalidare la fattura del cliente (app Fatturazione o Contabilità).
Accreditare la fattura (emettere una nota di credito) e verificare se si comporta come nel database di produzione.
Controllare i risultati dei rendiconti (app Contabilità).
Controllare di tanto in tanto le imposte, valute, i conti bancari e l’anno fiscale (app Contabilità).
Realizzare un ordine online (app Sito web) dalla selezione prodotti nel negozio fino al processo di pagamento e verificare che tutto venga eseguito come nel database di produzione.
Il presente elenco non è esaustivo. Estendi l’esempio alle altre applicazioni in base all’utilizzo di Odoo.
If you face an issue while testing your upgraded test database, you can request the assistance of Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)». In any case, it is essential to report any problem encountered during the testing to fix it before upgrading your production database.
Potresti riscontrare differenze significative con viste, funzionalità, campi e modelli standard durante la fase di prova. Tali modifiche non possono essere annullate caso per caso. Tuttavia, se una modifica introdotta da una nuova versione impatta una personalizzazione, è responsabilità del manutentore del modulo personalizzato renderla compatibile con la nuova versione di Odoo.
Suggerimento
Non dimenticare di testare:
Integrazioni con software esterni (EDI, API, ecc.)
I flussi di lavoro tra varie applicazioni (vendite online con e-commerce convertendo un lead direttamente in ordine di vendita, consegna dei prodotti, ecc.)
Esportazione dati
Azioni automatiche
Le azioni del server nel menu azioni dalle viste modulo o selezionando più record dalle viste elenco
Aggiornare il database di produzione¶
Once the tests are completed and you are confident that the upgraded database can be used as your main database without any issues, it is time to plan the go-live day.
Il tuo database di produzione non sarà disponibile durante l’aggiornamento. Di conseguenza, consigliamo di pianificare l’aggiornamento in un momento in cui l’utilizzo del database è minimo.
Dato che il tuo database e gli script di aggiornamento standard sono in continua evoluzione, è consigliato richiedere frequentemente un altro database di prova aggiornato per garantire che il processo di aggiornamento avvenga ancora con successo, specialmente se il tempo necessario al completamento è elevato. Inoltre, consigliamo di provare completamente il processo di aggiornamento il giorno prima di aggiornare il database di produzione.
Importante
Andare in produzione senza prima testare potrebbe portare a:
Fallimento degli utenti nel sistemare le modifiche e le nuove funzionalità
Interruzioni dell’attività (ad es., non avere più la possibilità di convalidare un’azione)
Esperienza utente ridotta (ad es., un sito web e-commerce che non funziona correttamente)
The process of upgrading a production database is similar to upgrading a test database, but with a few exceptions.
The process is similar to obtaining an upgraded test database, except for the purpose option, which must be set to Production instead of Test.
Avvertimento
Una volta richiesto l’aggiornamento, il database non sarà disponibile fino al completamento. Quando il processo sarà completo, non sarà possibile ripristinare la vecchia versione.
The process is similar to obtaining an upgraded test database on the Production branch.
Il processo viene attivato non appena viene realizzato un nuovo commit sul branch. Questo consente di sincronizzare il processo di aggiornamento con la distribuzione del codice sorgente dei moduli personalizzati aggiornato. Se non ci sono moduli personalizzati, il processo di aggiornamento viene attivato immediatamente.
Importante
Il database non è disponibile durante il processo. Se qualcosa va storto, la piattaforma ripristina automaticamente l’aggiornamento, come nel caso di un aggiornamento regolare. In caso di successo, effettua un back-up del database prima che l’aggiornamento venga creato.
L’aggiornamento dei moduli personalizzati deve avvenire con successo per completare l’intero processo di aggiornamento. Assicurati che lo stato dell’aggiornamento di staging sia riuscito prima di testarlo in produzione. Maggiori informazioni su come aggiornare i moduli personalizzati possono essere trovate alla pagina Upgrade a customized database.
Il comando per aggiornare un database alla produzione è simile all’aggiornamento di un database di prova tranne per l’argomento test
che deve essere sostituito da production
:
$ python <(curl -s https://upgrade.odoo.com/upgrade) production -d <your db name> -t <target version>
An upgraded production database can also be requested via the Upgrade page.
Once the database is uploaded, any modification to your production database will not be present on your upgraded database. This is why we recommend not using it during the upgrade process.
Importante
Al momento della richiesta di un database aggiornato per motivi di produzione, la copia viene inviata senza filestore. Per cui, il filestore del database aggiornato deve essere unito al filestore di produzione prima di distribuire la nuova versione.
In case of an issue with your production database, you can request the assistance of Odoo by going to the Support page and selecting «An issue related to my future upgrade (I am testing an upgrade)».
Accordo sul livello dei servizi (SLA)¶
Con Odoo Enterprise, l’aggiornamento di un database alla versione più recente di Odoo è gratuito, compreso il supporto richiesto per rettificare potenziali discrepanze nel database aggiornato.
Le informazioni sui servizi di aggiornamento incluse nella licenza Enterprise sono disponibili nel Contratto di abbonamento a Odoo Enterprise. In ogni caso, la presente sezione chiarisce quali servizi di aggiornamento puoi aspettarti.
Servizi di aggiornamento coperti dallo SLA¶
I database ospitati su piattaforme cloud Odoo (Odoo Online e Odoo.sh) o ospitati autonomamente (On-Premise) possono beneficiare dei servizi di aggiornamento in qualsiasi momento per:
aggiornare tutte le applicazioni standard;
aggiornare tutte le personalizzazioni create con l’app Studio se Studio è ancora installato e l’abbonamento relativo è ancora attivo;
aggiornare tutti gli sviluppi e personalizzazioni coperti da un abbonamento per la manutenzione delle personalizzazioni.
I servizi di aggiornamento sono limitati alla conversione e all’adattamento tecnico di un database (moduli standard e dati) per renderlo compatibile con la versione di destinazione dell’aggiornamento stesso.
Servizi di aggiornamento non coperti dallo SLA¶
I seguenti servizi legati all’aggiornamento non sono inclusi:
pulizia di dati e configurazioni pre-esistenti durante l’aggiornamento;
the upgrade of additional modules not covered by a maintenance contract that are created in-house or by third parties, including Odoo partners; and
formazione sull’utilizzo di funzionalità della versione aggiornata e flussi di lavoro.