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.

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.

O prompt da mensagem de atualização na parte superior direita da base de dados

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

  1. Request an upgraded test database (see obtaining an upgraded test database).

  2. 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).

  3. Thoroughly test the upgraded database (see testing the new version of the database).

  4. 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)”.

  5. 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.

  6. Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database).

  7. 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.

O gerenciador de bases de dados com um botão de upgrade ao lado do nome de uma base de dados.

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 pop-up "Upgrade da base de dados".

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.

Clicar na seta de menu exibe a base de dados de teste com upgrade.

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:

  1. As ações agendadas são desativadas.

  2. Os servidores de envio de e-mail são desativados arquivando os existentes e adicionando um falso.

  3. Os provedores de pagamento e as transportadoras de entrega são redefinidos para o ambiente de teste.

  4. 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.

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.