Central de Atualizações

Central de Atualizações

1) Problema típico: como descobrir e controlar o que está desatualizado?

Uma equipe de infraestrutura recebe um chamado: um processo crítico falhou depois de mudanças em bibliotecas e ninguém sabe se foi por binários desatualizados, patches faltantes ou divergência no dicionário. Esse cenário é comum em ambientes Protheus com múltiplas instâncias, integrações e personalizações. A ausência de um ponto central que liste componentes desatualizados aumenta o tempo de diagnóstico e o risco de aplicar updates errados em produção.

A central de atualizações foi criada exatamente para reduzir essa incerteza: ela identifica componentes como binários (dbAccess, libs), patches e rotinas desatualizadas e aponta para os artefatos a serem aplicados, eliminando parte da investigação manual.

2) Pré-requisitos técnicos e limitações de ambiente

Antes de qualquer ação de atualização automatizada é indispensável validar requisitos mínimos do ambiente. Pontos técnicos a conferir:

  • Release do produto: a central exige versão igual ou superior a 12.1.23 do Protheus para funcionar.
  • Licenciamento: a funcionalidade depende do license server integrado ao TOTVS ID — ambientes sem license server com TOTVS ID não conseguem usar a central. Em teste, é possível apontar licenças para um license server com TOTVS ID; sem isso, a central fica indisponível mesmo usando empresas de teste como a 99.
  • Chave de servidor: a chave MaxStringSize no appserver (server) deve ter valor superior a 5 em alguns cenários; na ausência dela alguns clientes relatam que a central continua funcional, mas é um ajuste recomendado quando indicado.
  • Acesso de rede: o servidor precisa conseguir acesso externo ao endpoint técnico utilizado para central de atualizações (ex.: https://api.tph.engpro.totvs.com.br). Sem conectividade externa a central não consegue obter metadados e links de download.
  • Idioma/região: ambientes configurados para Brasil e idioma Português são o alvo primário da solução; verifique o locale do ambiente quando houver inconsistências.

Confirmar essas dependências evita situações nas quais a ferramenta não aparece ou retorna resultados incompletos.

3) O que a Central reporta e como interpretar os resultados

A central apresenta um diagnóstico agregado do ambiente; entre os itens relatados comumente estão:

  • Binários instalados (ex.: dbAccess, bibliotecas) e discrepância de versão frente ao baseline.
  • Patches disponíveis e patches já aplicados — a ferramenta indica quais patches faltam.
  • Routines/fontes desatualizados em relação ao repositório de referência.
  • Links diretos para download das atualizações correspondentes, facilitando o fluxo de obtenção dos pacotes.

Interpretação técnica: a saída da central é um ponto de partida para a validação. Nem todo item listado deve ser aplicado automaticamente; o time de suporte precisa avaliar impacto por módulo, compatibilidade com personalizações e dependências de integrações. A central não substitui a governança de mudanças — ela simplifica a identificação de gaps entre o ambiente e o baseline oficial.

4) Fluxo recomendado antes de aplicar atualizações

Atualizar Protheus exige um fluxo estruturado. Recomenda-se o seguinte pipeline:

  1. Inventário: gere a listagem completa de componentes apontados pela central e categorize por criticidade (segurança, correção funcional, binário de acesso a dados).
  2. Ambiente de testes/homologação: aplique as atualizações primeiramente em um ambiente que replique o mais fielmente possível a produção (mesmas versões de SGBD, mesmas customizações e cargas de dados amostrais).
  3. Backup completo: antes de qualquer alteração, realize backup do banco de dados, do repositório (RPO/objetos de fontes) e das pastas de configuração. Pontos práticos: as pastas principais do Protheus normalmente são a pasta do produto e a pasta Protheus_Data — verifique os caminhos SourcePath e RootPath no arquivo de configuração do appserver (appserver.ini) para localizar as pastas a serem preservadas.
  4. Sequência de atualização: atualize binários (lib/dbAccess) antes do repositório de fontes; execute compatibilizadores de dicionário quando houver alterações de estrutura (UPDDISTR ou rotinas equivalentes).
  5. Testes integrais: execute cenários-chave (integrações batch, geração de obrigações fiscais, processos de cálculo) e monitore logs para identificar regressões.
  6. Plano de rollback: valide procedimentos de restauração a partir dos backups e, se necessário, fórmulas para remover patches (alguns patches exigem scripts de reversão específicos).

5) Backup e rollback: procedimentos práticos

Backup é a peça-chave do plano de rollback. Regras e práticas operacionais:

  • Backup do banco de dados: cópia consistente (dump/backup online ou snapshot) com verificação de integridade e documentação do ponto de restauração.
  • Backup de arquivos do Protheus: preserve a pasta do produto e a Protheus_Data (ou seus equivalentes apontados por SourcePath/RootPath). Pare serviços do Protheus e do banco antes de copiar arquivos que possam estar em uso para garantir consistência.
  • Repositório de fontes e dicionário: inclua RPO, arquivos DIF/UPD fornecidos e qualquer arquivo de dicionário diferencial. Para restauração, documente a ordem de restauração (repor dicionário, repor RPO, reativar serviços).
  • Teste de restauração: periodicamente execute um teste de rollback em ambiente isolado para garantir que backups são funcionais e que o tempo de recuperação está dentro dos objetivos acordados (RTO/RPO).

Observações operacionais: a central facilita identificar quais binários e patches faltam, mas o ponto seguro para rollback é o backup tradicional. Em muitos casos, aplicar um binário envolve substituir bibliotecas em múltiplas máquinas (AppServer, ambientes gráficos, serviços). Documente cada etapa e verifique permissões e bloqueios de arquivos.

6) Interação com componentes do ecossistema Protheus (TAF, compatibilizadores e stored procedures)

Atualizações de módulos com integração técnica exigem passos adicionais. Exemplos práticos observados em operações:

  • Compatibilizador de dicionário: quando um pacote traz alterações no dicionário, é necessário rodar o compatibilizador (por exemplo, UPDDISTR) e resolver críticas reportadas até término sem erros; normalmente isso é feito após aplicar os arquivos diferenciais na pasta de carga do servidor.
  • Stored procedures: a ativação de novas stored procedures em bases SQL costuma seguir um procedimento controlado. Há um parâmetro (ex.: MV_PROCSP — observe que parâmetros iniciados por MV_ são exemplos de parâmetros de ambiente e podem variar conforme implementação) que habilita o uso das novas procedures. O fluxo inclui colocar os pacotes na pasta definida pelo STARTPATH no INI do server, ativar o parâmetro e executar a instalação via configurador para as empresas desejadas.
  • Processos TAF/TAFLOAD: pacotes ligados a obrigações fiscais (TAF) frequentemente requerem a execução de rotinas específicas. Exemplos: executar TAFLOAD para processar autocontidas, usar UPDCTB para atualizar componentes do TAF, e checar que processos internos (ex.: cópias entre TAFST1 e TAFST2) estão sendo executados; há rotinas de processamento numeradas (processo 0, processo 2) que controlam a movimentação entre estágios.
  • Parâmetros de controle: alguns parâmetros precisam ser temporariamente alterados para permitir atualização de tabelas autocontidas — por exemplo, deixar MV_VAUTCON vazio para permitir a atualização das autocontidas antes de rodar o wizard de configuração. Em caso de problemas no wizard, é prática colocar MV_TAFWIZ em .F. para liberar o ambiente dos bloqueios até resolver o problema. Reforce: MV_* são mostrados como exemplos de parâmetros de ambiente; confirme a existência e o uso desses parâmetros no seu ambiente antes de alterá-los.

7) Boas práticas de governança de mudanças para atualizações

Atualizar sem gerenciamento é arriscado. Adoção de processos formais reduz retrabalho:

  • Change Advisory Board (CAB): registre a atualização em mudança controlada com análise de impacto, janela de manutenção e plano de testes.
  • Release notes e trackers: mantenha registro do baseline antes e depois da atualização (versões de binários, hash de RPO, ID dos patches aplicados).
  • Rollback testado: antes de aprovar promoção para produção, execute rollback em homologação e cronometre o tempo necessário para restaurar a operação normal.
  • Automação de validação pós-update: crie scripts/rotinas de smoke-tests que executem consultas e processos críticos automaticamente e validem respostas esperadas.
  • Plano de comunicação: avise áreas afetadas (negócio, contabilidade, logística) sobre janelas planejadas e procedimentos de contingência.

8) Procedimentos específicos ao usar a Central: passos operacionais

Um procedimento prático para uso da central, alinhado com as recomendações técnicas:

  1. Verificação inicial: confirme release do Protheus >= 12.1.23, licença com TOTVS ID e conectividade ao endpoint técnico.
  2. Coleta: na central, obtenha a listagem completa de itens pendentes (binários, patches, libs). Exporte a lista e classifique por prioridade.
  3. Planejamento: selecione um subconjunto inicial (ex.: patches de segurança e correções críticas) para validar em homologação.
  4. Homologação: em ambiente de teste (mesmo SGBD, mesmas customizações), aplique binários e patches na ordem inversa da aplicação (binários primeiro, patches depois). Em pacotes que alteram dicionário, execute o compatibilizador e corrija críticas (UPDDISTR/UPDCTB/UPDTAF quando aplicável).
  5. Validação funcional: execute as rotinas mais críticas e rotinas de integração (por exemplo, geração de obrigações que dependem do TAF e processos de integração entre TAFST1 e TAFST2, se existirem no seu ambiente).
  6. Promoção para produção: execute o procedimento validado, controlando downtime e monitorando erros. Tenha equipe de plantão para reversão imediata se necessário.
  7. Pós-implantação: registre o estado final e atualize inventário de versões; automatize o processo de inventário para próximas rodadas.

9) Considerações sobre customizações e impactos

Alterações locais (customizações) são as maiores fontes de conflito em updates. Aspectos a considerar:

  • Identifique funções/routines customizadas que possam sobrescrever comportamentos padrão. Padrões de nomenclatura como U_ ou prefixos 'z' e tabelas/campos iniciados por Z geralmente indicam customizações — trate esses objetos com atenção especial.
  • Evite substituir fontes customizadas sem analisar o delta; prefira aplicar patches em cópia, testar e somente então incorporar mudanças ao repositório compartilhado.
  • Documente dependências de integrações externas e testes de contrato (APIs, arquivos de integração), pois alterações em binários podem alterar formatos esperados.

10) Checklist operacional resumido antes de qualquer atualização

  • Backup do banco e das pastas apontadas por SourcePath/RootPath.
  • Confirmação de release >= 12.1.23 e license server com TOTVS ID.
  • Validação de conectividade com o endpoint da central (por exemplo, https://api.tph.engpro.totvs.com.br).
  • Lista de patches/binários a aplicar, com ordem definida e classificação de risco.
  • Ambiente de homologação pronto e sincronizado com produção em termos de customizações e dados amostrais.
  • Plano de rollback validado e equipe disponível para execução.
  • Comunicação com usuários e janelas de manutenção definidas.

11) Casos especiais e alertas técnicos

Algumas situações exigem cuidado extra:

  • Atualizações que envolvem dicionário podem gerar críticas que impedem normalização das tabelas — executar UPDDISTR e iterar correções até que não haja críticas é requisito para estabilidade.
  • Quando stored procedures são atualizadas, a recomendação é remover versões antigas antes de instalar as novas, para evitar conflitos de execução; habilite o uso das novas procedures via parâmetro (por exemplo, MV_PROCSP) e garanta que os pacotes estão no STARTPATH configurado.
  • Processos de integração fiscal (TAF) geralmente têm etapas encadeadas — rodar TAFLOAD, atualizar autocontidas (deixando MV_VAUTCON vazio quando necessário) e executar processos de sincronização (cópia entre TAFST1 e TAFST2) numa ordem adequada evita inconsistências.

12) Conclusão técnica e recomendações finais

A central de atualizações reduz a latência de identificação de componentes desatualizados e acelera o acesso a artefatos de correção. Porém, por si só, não elimina a necessidade de processos de governança: a atualização ainda exige inventário, homologação, backups e validação pós-implantação. Siga um fluxo controlado, documente cada alteração e trate parâmetros de ambiente (os exemplos de parâmetros iniciados por MV_ citados nos procedimentos devem ser verificados no seu ambiente antes de alterá-los) como configurações que impactam execução e compatibilidade.

Finalmente, automatize o inventário pós-update e mantenha testes automatizados para reduzir tempo de validação e risco operacional em atualizações subsequentes.

Index

Categorias

Sobre o Autor

Foto do Autor
Fábio Hayama

Apaixonado por gestão, tecnologia e inovação, Fábio Hayama possui mais de 15 anos de experiência no universo do ERP Protheus, estratégia empresarial e automação de processos.

Leia mais sobre o Fábio

Entre em contato conosco

Veja mais artigos relacionados

Central de Atualizações
Uma equipe de infraestrutura recebe um chamado: um processo crítico falhou depois de mudanças em bibliotecas e ninguém sabe se...
De São Paulo para o mundo
De São Paulo para o mundo
A Geeker atende empresas em todo o Brasil e no exterior — França e Argentina já foram palco de projetos reais. Veja como funciona.
TES no Protheus
Imagine a rotina do faturamento: um atendente inclui vários pedidos de venda por dia, cada cliente tem um convênio fiscal difer...
Protheus: módulos e funcionalidades
Você precisa mapear quais módulos do Protheus suportam um processo crítico — por exemplo, desde a requisição de compra até a ba...