Ir para o conteúdo principal

Funcionamento do Updater (Problemas x Soluções)

O Updater é um sistema fundamental para a Alterdata, responsável por gerenciar e entregar atualizações para a maioria dos softwares desenvolvidos pela empresa. Para cumprir seu objetivo, ele utiliza diversas APIs e executa várias funções, garantindo que os clientes tenham acesso às versões mais recentes de seus sistemas.

1. Funções do Updater

O Updater desempenha um papel crucial na gestão de software, realizando as seguintes funções principais:

  • Entrega de Atualizações: O Updater baixa e distribui as atualizações dos sistemas para as máquinas dos clientes.

  • Gerenciamento de Versões: Garante que a versão correta da atualização seja baixada  e que os arquivos de download estejam presentes na pasta designada. Ele também lida com problemas de MD5 (módulos do sistema), onde as versões podem estar corrompidas ou com o mesmo nome de versões antigas, exigindo que sejam renomeadas e anexadas novamente.

  • Verificação de Licença e Acesso: Interage com APIs para verificar a licença do cliente e garantir o acesso ao sistema.

  • Sincronização de Máquinas: Em redes com máquinas "master" e "slave", o Updater gerencia o download da versão pelo master e a sincronização com as slaves.

  • Download de Sistemas: Permite o download de sistemas através do Update Center.

2. Problemas Recorrentes e Soluções

Esta seção detalha os problemas mais comuns enfrentados com o Updater e as etapas para resolvê-los.

2.1. Atualização do Sistema

Problema 1: Updater baixou a atualização, mas não está entregando.
Sim

Use o aplicativo de teste na máquina do cliente para simular a solicitação e verificar se a entrega falha.

Não

O problema reside no download para o código incorreto.

Sim

Procure ajuda.

Não

O problema é a ausência do arquivo.

Problema 2: Updater não está baixando a atualização. 
Sim

Confirme no endpoint de verificação de atualizações (Postman) se a versão é entregue na consulta20.

Se a atualização for entregue no Postman, analise a máquina do cliente para erros de download (verificar logs do Updater Manager ou log de eventos) ou outros impedimentos (ex: sistema registrado com outro código, versões superiores na base de dados)21.

Se a versão estiver liberada para o cliente (CRM, UF, cidade, etc.) mas não for entregue pelo Postman, pode ter ocorrido um problema no processamento da versão. Peça ajuda a alguém do dsn.cir22.

Não

Verifique com o responsável pela versão a possibilidade de liberá-la para o cliente23.

Problema 3: Updater não está baixando uma atualização e apresenta a mensagem:
"Solicitação da URL de download para o aplicativo apagar, setor: ERP, versão xxxxxxx Retorno: 1401 - Não existe no Updatecenter aplicativo com id 107". 

  • Verificação: Verifique pela API solicitar_url_download se um link para download é gerado com o código do cliente e o ID da versão
    Testes Adicionais: Se a URL não for gerada, teste com código CRM, CPF, CNPJ ou codigo_cliente

Problema 4: Updater não está baixando a atualização (genérico).

  • Teste na sua máquina se o Updater baixa a versão com o código do cliente28.

  • Teste se o problema é para baixar um módulo específico ou qualquer módulo29.

  • Teste se o computador do cliente consegue acessar o UpdateCenter e baixar o sistema pelo "Download de versão".

Problema 5: Liberação de versão não processa o cliente - A versão está liberada no UpdateCenter, porém não baixa no cliente. 

OBS: Em alguns casos, mesmo liberando o cliente no UpdateCenter, a versão não é liberada para ele, tendo que processar novamente o código do cliente. Isso ocorre por que hoje não conseguimos processar todos os clientes, mas nesses casos podemos fazer o seguinte procedimento:

1. Processar novamente o código do cliente pelo Postman:

 Pegue o id_crm do cliente na API de licença http://updatecenter.alterdata.com.br/api/licenca pelo postman, e após processe o id_crm do mesmo no cron de atualizar cliente:
GET  https://updatecenter.alterdata.com.br/api/cron/atualizar-cliente/?id_externo= com o id_crm do cliente inserido após o “externo=”

Após realizar esse procedimento, basta buscar atualização no UpdaterManager.exe do cliente e ver se a versão irá baixar.

  • O Updater desta máquina está como master? 

Sim: Vá para o item 3 (desativar antivírus).

Não: 

          • Sim: Provavelmente o master ainda não fez o download da versão, o slave ainda não sincronizou a nova versão, ou a versão foi instalada manualmente em alguma máquina na rede (ou no master).

          • Não: Vá para o item "b" (acesso à internet).

          • Sim: Vá para o item 3 (desativar antivírus).

          • Não: Verifique o acesso à internet em outros sites e a existência de proxy na rede (configure-o se houver

  • Identificou o log que corresponde à versão esperada?
    Sim: Se souber resolver, siga em frente; caso contrário, peça ajuda
    Não: Peça ajuda.

 

2.2. Acesso ao Sistema: Segurança

Problema 1: Sistema está sempre solicitando as informações do contador. 48

  • Sim: Esse é o problema, pois o limite para esse campo no Bimer é de 50 caracteres.

  • Não: Vá para o item 2 (licenças adicionais).

  • Sim: Consulte o bureau do cliente utilizando a aplicação de teste da DLL de segurança.

  • Não: Force a atualização da licença na máquina e verifique se o problema persiste.

Problema 2: Cliente não consegue acessar o sistema, não tem o aplicativo cadastrado no UpdateCenter. 

  • Sim: Verifique no UpdateCenter se o aplicativo está cadastrado corretamente, conforme a licença do cliente.
    Se não estiver cadastrado no UpdaterCenter, entre em contato com o setor responsável e solicite a criação do aplicativo.

  • Não: Peça para verificar com a ADM e STAFF para incluir o produto no CRM corretamente.

Problema 3: Bloqueios de licença.

  • Não tem: O cliente deve entrar em contato com o setor responsável pela inclusão.

  • Sim, tem: Verifique se há alguma restrição, como inadimplência, produto cancelado, ou outros problemas de cadastro no CRM (ex: falta de CPF/CNPJ).

  • Sim: Verifique se a versão foi liberada para esse cliente.

  • Não: Execute o Diagnóstico.

Problemas 4: Cliente encontrado/ Cliente não encontrado.

  • Sim: Vá no Manager do Updater e configure as informações de proxy, solicitando ao cliente que preencha essas informações.

  • Não: Possível falha de conexão; verifique se há antivírus, Warsaw, firewall ou outros aplicativos bloqueando o acesso.

Problema 5: "Este computador não pode ser identificado"
Problema 6: "Object reference not set to an instance of an object.". 
🧠 Linha de Raciocínio

Updater bloqueando/permitindo acesso ao sistema :

  • Verificar no CRM se o bloqueio/permissão está de acordo com as informações de produto/características do cliente

  • Verificar pelo DLL From /ReadDllFromCSharp qual a resposta do Permissão V2.

  • Verificar pelo manager (botão escondido) se o sistema está autorizado, comparar com a resposta da api de licença. Caso seja necessário forçar atualização da licença.

Updater baixou atualização, mas não entrega:

  • Verificar por qual identidade foi feito o download

  • Verificar se pelo app azul entrega a atualização

Updater não baixa atualização para um sistema:

  • Verificar pela console se o código/cnpj/cpf do cliente faz chamada para este sistema.

  • Verificar pela console apresenta algum erro ao solicitar download.

  • Verifique se o aplicativo existe na base do updater e qual identidade está vinculada.

  • Verificar se a api “Verificar atualizações” entrega a versão.

  • Verificar se na base não existe uma versão >= que a versão que precisa baixar;

  • Verificar se o cliente acessa o site do update center e faz download de versão;

  • Desativar firewall/Antivírus

Versão liberada para um cliente, mas a api não entrega:

  • Verificar como foi a liberação (crm, cidade, uf, característica ou todos). Caso tenha sido por região, verifique o endereço do cliente no crm.

  • Verificar se a versão é homologada e o cliente possui alguma característica que impeça liberação;

  • Verificar Maior data entre Carência,Validade da cobrança e Alteração da situação do produto;

Assinatura/Aluguel
com inadimplência

Com título de renegociação

Demonstração

Não atualiza 

Vencido: Se baseia na data de ativação da inadimplência

St. Prod :        Demonstração

Não utiliza

A vencer: Pode atualizar com versões liberadas até o primeiro título a vencer

Tp. Mov. Cob: Demonstração

-

-

Não pode estar em branco e não pode ser diferente de demonstração

 

2.3. Acesso ao Sistema: Updater Parado

Problema 1: Serviço do Updater parado. 
  • Sim: Quando a máquina é reiniciada, o serviço volta a ficar parado?

      • a. Procure no log de eventos do sistema por um log do Service Control Manager com data/hora próxima da última inicialização da máquina, contendo: 
        "Tempo limite esgotado (30000 milissegundos) ao aguardar a conexão do serviço Alterdata Updater." 
        ou
        "Não foi possível iniciar o serviço Alterdata Updater devido ao seguinte erro: O serviço não respondeu à requisição de início ou controle em tempo hábil." 

      • b. Procure no log de eventos do aplicativo por algum log de erro do Updater que possa ter encerrado o processo. Se encontrar, informe a equipe de desenvolvimento.

  • Não: Procure a equipe de desenvolvimento. 

2. O serviço Alterdata Updater está instalado nos serviços do Windows? 

Problema 2: Serviço do Updater rodando (mas com falha no funcionamento). 

  • Conseguiu localizar o problema pelo Diagnóstico?
    Sim: Se souber resolver, vá em frente.
    Não: Peça ajuda!

Problema 3: Não foi possível se conectar ao link http://localhost:8766

  • Sim: Vá no Manager do Updater e configure as informações de proxy, solicitando ao cliente que preencha esses dados.

  • Não: Possível falha de conexão; verifique se há antivírus, Warsaw, firewall ou outros aplicativos bloqueando o acesso.