Upgrade¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 15.0 to Odoo 17.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., 15.0, 16.0, 17.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 three 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.
Um upgrade não cobre:
Fazer downgrade para uma versão anterior do Odoo
Alteração de edições (ex.: de Community para Enterprise)
Alteração do tipo de hospedagem (ex.: de on-premise para o Odoo Online)
Migração de outro ERP para o Odoo
Aviso
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.
Resumo do upgrade¶
Request an upgraded test database (see obtaining an upgraded test database).
Se for o caso, faça upgrade do código-fonte de seu módulo personalizado para que ele seja compatível com a nova versão do Odoo (consulte 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)”.
Depois que todos os problemas forem resolvidos e você tiver certeza de que o upgrade da base de dados pode ser usado como sua base de dados principal sem problemas, planeje a o upgrade da sua base de dados de produção.
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)”.
Obter upgrade de uma base de dados de teste¶
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
A plataforma de upgrade segue a mesma Política de Privacidade que os outros serviços da Odoo.com. Visite a página Lei geral de proteção de dados pessoais para saber mais sobre como a Odoo lida com seus dados e privacidade.
Odoo Online databases can be manually upgraded via the database manager.
O gerenciador de bases de dados exibe todos as bases de dados associados à conta do usuário. As bases de dados que não estão na versão mais recente do Odoo exibem uma seta em um ícone de círculo ao lado de seu nome, indicando que é possível fazer upgrade.
Clique no ícone seta em um círculo para iniciar o processo de upgrade. Na janela pop-up, preencha:
A versão do Odoo para a qual você quer fazer upgrade, geralmente a versão mais recente
O endereço de e-mail que deve receber o link da base de dados com upgrade
O objetivo do upgrade, que é automaticamente definido como Testar para sua primeira solicitação de upgrade
O marcador Upgrade em andamento é exibido ao lado do nome da base de dados até a conclusão. Quando o processo for bem-sucedido, um e-mail contendo um link para a base de dados de teste com upgrade será enviado ao endereço fornecido. A base de dados também pode ser acessada no gerenciador de bases de dados, clicando na seta suspensa antes do nome da base de dados.
O Odoo.sh é integrado à plataforma de upgrade para simplificar o processo.
The latest production daily automatic backup is then sent to the Upgrade platform.
Quando a plataforma de upgrade termina de atualizar o backup e de carregá-lo na filial, ela é colocada em um modo especial: toda vez que um commit é enviado para a ramificação, ocorre uma operação de restauração do backup atualizado e uma atualização de todos os módulos personalizados. Isso permite que você teste seus módulos personalizados em uma cópia original da base de dados com upgrade. O arquivo de registro do processo de upgrade pode ser encontrado na compilação de teste recém-atualizada, acessando ~/logs/upgrade.log
.
Importante
Nas bases de dados com módulos personalizados instalados, o código-fonte deve estar atualizado com a versão de destino do Odoo antes que o upgrade possa ser realizado. Se não houver nenhum, o modo “atualizar ao fazer commit” é ignorado, a base de dados com upgrade é compilada assim que é transferida da plataforma de upgrade e o modo de upgrade é fechado.
Consulte a página Upgrade a customized database para obter mais informações.
O processo de upgrade padrão pode ser iniciado digitando a seguinte linha de comando na máquina em que a base de dados está hospedada:
$ 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.
O seguinte comando pode ser usado para exibir a ajuda geral e os principais comandos:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Importante
Nas bases de dados com módulos personalizados instalados, o código-fonte deve estar atualizado com a versão de destino do Odoo antes que o upgrade possa ser realizado. Consulte a página Upgrade a customized database para obter mais informações.
Nota
Por motivos de segurança, somente a pessoa que enviou a solicitação de upgrade pode baixá-la
Por motivos de armazenamento, a cópia da base de dados é enviada sem um armazenamento de arquivos para o servidor de upgrade. Portanto, a base de dados em upgrade não contém o armazenamento de arquivos de produção.
Antes de restaurar a base de dados com upgrade, seu repositório de arquivos deve ser mesclado com o repositório de arquivos de produção para que seja possível realizar testes nas mesmas condições em que estaria na nova versão.
A base de dados com upgrade contém:
Um arquivo
dump.sql
que contém a base de dados com upgradeUma pasta
filestore
que contém arquivos extraídos de registros na base de dados em anexos (se houver algum) e novos arquivos padrão da versão de destino do Odoo (por exemplo, novas imagens, ícones, logotipos de provedores de pagamento, etc.). Essa é a pasta que deve ser mesclada com o armazenamento de arquivos de produção para obter o armazenamento de arquivos totalmente atualizado.
Nota
Você pode solicitar várias bases de dados de teste se quiser testar um upgrade mais de uma vez.
Nota
Quando uma solicitação de upgrade é concluída, um relatório é anexado ao e-mail de upgrade bem-sucedido e fica disponível no aplicativo Mensagens para usuários que fazem parte do grupo “Administração/Configurações”. Esse relatório fornece informações importantes sobre as alterações introduzidas pela nova versão.
Testar a nova versão da base de dados¶
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
As bases de dados de teste são neutralizadas e alguns recursos são desativados para evitar que afetem a base de dados de produção:
As ações agendadas são desativadas.
Os servidores de envio de e-mail são desativados arquivando os existentes e adicionando um falso.
Os provedores de pagamento e as transportadoras de entrega são redefinidos para o ambiente de teste.
A sincronização bancária é desativada. Se quiser testar a sincronização, entre em contato com o provedor de sincronização bancária para obter credenciais de sandbox.
É altamente recomendável testar o maior número possível de fluxos de negócios para garantir que estejam funcionando corretamente e para se familiarizar com a nova versão.
Checklist básica de teste
Há visualizações desativadas em sua base de dados de teste, mas ativas na basede dados de produção?
Suas visualizações habituais ainda são exibidas corretamente?
Seus relatórios (fatura, pedido de vendas, etc.) estão sendo gerados corretamente?
As páginas do seu site estão funcionando corretamente?
Você é capaz de criar e modificar registros? (pedidos de vendas, faturas, compras, usuários, contatos, empresas etc.)
Há algum problema com seus modelos de e-mail?
Há algum problema com as traduções salvas?
Seus filtros de pesquisa ainda estão presentes?
Você consegue exportar dados?
Verificar um produto aleatório em seu catálogo e comparar seus dados de teste e produção para ver se tudo está igual (categoria do produto, preço de venda, preço de custo, fornecedor, contas, rotas etc.).
Comprar este produto (aplicativo Compras).
Confirmar o recebimento deste produto (aplicativo Inventário).
Verificar se a rota para receber o produto é a mesma em sua base de dados de produção (aplicativo Inventário).
Vender este produto (aplicativo Vendas) a um cliente aleatório.
Abrir a base de dados de clientes (aplicativo Contatos), selecionar um cliente (ou empresa) e verificar seus dados.
Enviar o produto (aplicativo Inventário).
Verificar se a rota de envio desse produto é a mesma da sua base de dados de produção (aplicativo Inventário).
Validar uma fatura de cliente (aplicativo Faturamento ou Financeiro).
Creditar a fatura (emitir uma nota de crédito) e verificar se ela se comporta como em sua base de dados de produção.
Verificar os resultados de seus relatórios (aplicativo Financeiro).
Verificar aleatoriamente seus impostos, moedas, contas bancárias e ano fiscal (aplicativo Financeiro).
Fazer um pedido on-line (aplicativo Site), desde a seleção do produto em sua loja até o processo de checkout, e verificar se tudo se comporta como na sua base de dados de produção.
Essa lista é não exaustiva. Estenda o exemplo para os outros aplicativos com base no seu uso do 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.
Você pode encontrar diferenças significativas com visualizações, recursos, campos e modelos padrão durante o teste. Essas alterações não podem ser revertidas caso a caso. No entanto, se uma alteração introduzida por uma nova versão interromper uma personalização, é responsabilidade do mantedor do seu módulo personalizado torná-lo compatível com a nova versão do Odoo.
Dica
Não se esqueça de testar:
Integrações com softwares externos (EDI, APIs, etc.)
Fluxos de trabalho entre diferentes aplicativos (vendas on-line com e-Commerce, conversão de um lead em um pedido de venda, entrega de produtos, etc.)
Exportação de dados
Ações automatizadas
Ações do servidor no menu de ação em visualizações de formulário, bem como ao selecionar vários registros em visualizações de lista
Fazer upgrade da base de dados de produção¶
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.
Sua base de dados de produção ficará indisponível durante o upgrade. Por isso, recomendamos planejar o upgrade em um momento de uso mínimo da base de dados.
Como os scripts de upgrade padrão e sua base de dados estão em constante evolução, também é recomendável solicitar com frequência outra base de dados de teste com upgrade para garantir que o processo de upgrade ainda seja bem-sucedido, especialmente se demorar muito para ser concluído. Recomenda-se também ensaiar completamente o processo de upgrade um dia antes de fazer o upgrade da base de dados de produção.
Importante
Entrar em produção sem antes testar pode levar a:
Usuários não conseguindo se adaptar às mudanças e aos novos recursos
Interrupções de negócios (ex.: não ter mais a possibilidade de validar uma ação)
Experiência do cliente negativa (ex.: um site de e-Commerce que não funciona corretamente)
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.
Aviso
Após a solicitação de upgrade, a base de dados ficará indisponível até que o upgrade seja concluído. Depois que o processo for concluído, será impossível reverter para a versão anterior.
The process is similar to obtaining an upgraded test database on the Production branch.
O processo é acionado assim que um novo commit é feito na ramificação. Isso permite que o processo de upgrade seja sincronizado com a implementação do código-fonte atualizado dos módulos personalizados. Se não houver módulos personalizados, o processo de upgrade será acionado imediatamente.
Importante
A base de dados fica indisponível durante todo o processo. Se algo der errado, a plataforma reverterá automaticamente o upgrade, como aconteceria em uma atualização regular. Em caso de sucesso, é criado um backup da base de dados antes do upgrade.
A atualização de seus módulos personalizados deve ser bem-sucedida para concluir todo o processo de upgrade. Certifique-se de que o status de seu upgrade de teste seja bem-sucedido antes de tentar fazer upgrade na de produção. Mais informações sobre como atualizar seus módulos personalizados podem ser encontradas em Upgrade a customized database.
O comando para upgrade uma base de dados para produção é semelhante ao de upgrade de uma base de dados de teste, exceto pelo argumento test
, que deve ser substituído por 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
Ao solicitar um upgrade de base de dados para fins de produção, a cópia é enviada sem um armazenamento de arquivos. Portanto, o armazenamento de arquivos da base de dados com upgrade deve ser mesclado com o armazenamento de arquivos de produção antes de implementar a nova versão.
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)”.
Acordos de Nível de Serviço (SLA)¶
Com o Odoo Enterprise, o upgrade de uma base de dados para a versão mais recente do Odoo é gratuito, incluindo qualquer suporte necessário para corrigir possíveis discrepâncias na base de dados com upgrade.
As informações sobre os serviços de upgrade incluídos na licença Enterprice estão disponíveis no Contrato de Assinatura Enterprise da Odoo. No entanto, esta seção esclarece quais serviços de upgrade você pode esperar.
Serviços de upgrade cobertos pelo SLA¶
As bases de dados hospedadas nas plataformas de nuvem da Odoo (Odoo Online e Odoo.sh) ou auto-hospedadas (On-Premise) podem se beneficiar dos serviços de upgrade a qualquer momento para:
fazer upgrade de todos os aplicativos padrão;
fazer upgrade de todas as personalizações criadas com o aplicativo Estúdio, desde que ele ainda esteja instalado e a respectiva assinatura ainda esteja ativa; e
fazer upgrade de todos os desenvolvimentos e personalizações cobertos por uma assinatura de manutenção de personalizações.
Os serviços de upgrade estão limitados à conversão técnica e à adaptação de uma base de dados (módulos e dados padrão) para torná-lo compatível com a versão de destino do upgrade.
Serviços de upgrade não cobertos pelo SLA¶
Os seguintes serviços relacionados a upgrade não estão incluídos:
a limpeza de dados e configurações pré-existentes durante o upgrade;
o upgrade de módulos personalizados criados internamente ou por terceiros, incluindo parceiros da Odoo;
linhas de código adicionadas aos módulos padrão, ou seja, personalizações criadas fora do aplicativo Estúdio, código inserido manualmente e ações automatizadas usando código Python; e
treinamento sobre o uso dos recursos e fluxos de trabalho da versão do upgrade.
Veja também