Upgrade¶
Um upgrade envolve a passagem de uma base de dados de uma versão mais antiga para uma versão mais recente suportada (ex.: do Odoo 17.0 para o Odoo 18.0). Upgrades regulares são cruciais, pois cada versão oferece novos recursos, correções de bugs e patches de segurança. É altamente recomendável usar uma versão com suporte. Cada versão principal tem suporte por três anos.
Dependendo do tipo de hospedagem e da versão do Odoo utilizada, um upgrade da base de dados pode ser obrigatória.
Se uma base de dados estiver em uma versão principal (ex.: 16.0, 17.0, 18.0), é obrigatório fazer upgrade a cada dois anos.
Se uma base de dados estiver em uma versão secundária (ex.: 17.1, 17.2, 17.4), é obrigatório fazer um upgrade algumas semanas após o lançamento da próxima versão. Geralmente, as versões secundárias são lançadas a cada dois meses.
Após os três anos iniciais de suporte, você terá mais dois anos para concluir o upgrade. Você será notificado quando for necessário fazer um upgrade.

Você pode permanecer na mesma versão indefinidamente, mesmo que isso não seja recomendado. Observe que quanto menor for a diferença de versão, mais fácil será o upgrade.
Você receberá uma notificação em sua base de dados algumas semanas antes de um upgrade obrigatório ser executado automaticamente. Você tem o controle do processo, desde que o prazo não seja atingido.

Concretamente, a equipe de upgrades do Odoo realiza um teste silencioso de upgrade de cada base de dados que deve ser atualizado. Se o teste for bem-sucedido e durar menos de 20 minutos, você poderá acionar diretamente o upgrade da base de dados. Se o teste falhar, você poderá testar o upgrade usando o gerenciador de base de dados.
Quando você for convidado a fazer upgrade, é altamente recomendável solicitar uma base de dados de teste com upgrade primeiro e dedicar algum tempo a testá-lo.
Um upgrade automático para a próxima versão será acionado se nenhuma ação for tomada antes da data de vencimento especificada.
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
Se a sua base de dados contiver módulos personalizados, seu upgrade não poderá ser realizado até que uma versão de seus módulos personalizados esteja disponível para a versão de destino do Odoo. Para clientes que mantêm seus próprios módulos personalizados, recomendamos paralelizar o processo ao solicitar uma base de dados atualizada enquanto também faz upgrade o código-fonte de seus módulos personalizados.
Resumo do upgrade¶
Solicite uma base de dados de teste com upgrade (consulte obtenção de uma base de dados de teste com upgrade).
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).
Teste exaustivamente a base de dados com o upgrade (consulte como testar a nova versão da base de dados).
Relate ao Odoo qualquer problema encontrado durante o teste, acessando a página Suporte e selecionando “Problema relacionado a um upgrade futuro (estou testando um 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.
Solicite o upgrade da base de dados de produção, deixando-a indisponível pelo tempo necessário para concluir o processo (consulte fazer upgrade da base de dados de produção).
Relate qualquer problema encontrado durante o upgrade para o Odoo acessando a página Suporte e selecionando “Problema relacionado ao meu upgrade (produção)”.
Obter upgrade de uma base de dados de teste¶
A Página de upgrade é a principal plataforma para solicitar um upgrade da base de dados. No entanto, dependendo do tipo de hospedagem, você pode fazer upgrade a partir da linha de comando (local), do gerenciador de bases de dados do Odoo Online ou do seu projeto do Odoo.sh.
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.
É possível fazer o upgrade de bases de dados do Odoo Online manualmente pelo gerenciador de bases de dados.
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.

O último backup automático diário de produção é então enviado para a plataforma de upgrade.
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
Esse comando tem alguns requisitos sobre o ambiente em que é executado:
Alguns comandos externos que devem ser fornecidos pelo sistema operacional, normalmente encontrados em qualquer distribuição Linux (incluindo a WSL). Um erro será exibido se um ou vários deles estiverem faltando.
O usuário do sistema que executa o comando precisa ser configurado com acesso à base de dados. Consulte a documentação do PostgreSQL sobre o ambiente do cliente ou o arquivo de senha do cliente para obter esse requisito.
O script precisa ser capaz de acessar um ou vários servidores da plataforma de upgrade, tanto na porta TCP 443 quanto em qualquer porta TCP aleatória no intervalo entre 32768 e 60999. Isso pode entrar em conflito com seu firewall restritivo e pode ser necessário adicionar uma exceção à configuração do firewall.
O seguinte comando pode ser usado para exibir a ajuda geral e os principais comandos:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
Uma base de dados de teste com upgrade também pode ser solicitada por meio da Página de upgrade.
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¶
É essencial testar a base de dados de teste com upgrade para garantir que você não fique preso em suas atividades diárias por causa de uma alteração nas visualizações, no comportamento ou em uma mensagem de erro quando o upgrade entrar em operação.
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.
Se você enfrentar um problema ao testar sua base de dados de teste do upgrade, poderá solicitar a assistência da Odoo acessando a página Suporte e selecionando “Problema relacionado ao meu upgrade futuro (estou testando um upgrade)”. Em qualquer caso, é essencial relatar qualquer problema encontrado durante o teste para corrigi-lo antes de fazer upgrade da sua base de dados de produção.
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¶
Depois que os testes forem concluídos e você tiver certeza de que a base de dados do upgrade pode ser usada como sua base de dados principal sem problemas, é hora de planejar o dia do go-live.
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)
O processo de upgrade de uma base de dados de produção é semelhante ao upgrade de uma base de dados de teste, mas com algumas exceções.
O processo é semelhante ao obtenção de uma base de dados de teste do upgrade, exceto pela opção de finalidade, que deve ser definida como Produção em vez de Teste.
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.
O processo é semelhante à obtenção de uma base de dados de teste de upgrade na ramificação Produção.

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>
Uma base de dados de produção com upgrade também pode ser solicitada pela Página de upgrade.
Depois que a base de dados for carregada, as modificações da sua base de dados de produção não estarão presentes na base de dados com upgrade. É por isso que recomendamos não usá-la durante o processo de upgrade.
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.
No caso de um problema com sua base de dados de produção, você pode solicitar a assistência da Odoo acessando a Página de Suporte e selecionando “Um problema relacionado à minha atualização (produção)”.
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 adicionais não cobertos por um contrato de manutenção que são criados internamente ou por terceiros, incluindo parceiros da Odoo; e
treinamento sobre o uso dos recursos e fluxos de trabalho da versão do upgrade.
Veja também