Documentaçao Updater

Sure, I can help you transform this PDF into a comprehensive and user-friendly documentation for your Updater system. I will organize the information into logical sections, detailing its functions, common problems and their solutions, and the APIs it interacts with.

Here's the structured documentation for your Updater system:

Documentação do Sistema Updater

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

Verificação:

O Updater baixou a atualização para o código correto?

Sim: Use o aplicativo de teste (app azul) 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.

O arquivo de download da versão está na pasta de downloads?

Sim: Procure ajuda.
Não: O problema é a ausência do arquivo.

Problema de Atualização MD5 (módulos do sistema): Indica que a versão do executável pode estar corrompida ou ter sido atualizada mantendo o mesmo nome da versão antiga no UpdateCenter.

Possível Solução: Anexe o executável da versão novamente, renomeando-o. Em alguns casos, é necessário remover o registro da versão na base do Updater para que ele entregue a atualização do MD5 ao sistema.

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

Verificação:

A versão está liberada para o cliente no UpdateCenter? 19

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

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ão25.
Testes Adicionais: Se a URL não for gerada, teste com código CRM, CPF, CNPJ ou codigo_cliente26.

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

Testes:

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

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

Solução: Pegue o id_crm do cliente na API de licença (http://updatecenter.alterdata.com.br/api/licenca) pelo Postman. Em seguida, processe o id_crm no cron de atualizar cliente: GET https://updatecenter.alterdata.com.br/api/cron/atualizar-cliente/?id_externo= com o id_crm inserido. Após isso, busque a atualização no UpdaterManager.exe do cliente para verificar se a versão baixa32.
Verificação de Máquina Master/Slave:

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

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

Essa máquina é uma slave e possui um master? 34

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)35.
Não: Vá para o item "b" (acesso à internet).

Essa máquina possui acesso à internet e ao UpdateCenter? 36

Sim: Vá para o item 3 (desativar antivírus)3737.
Não: Verifique o acesso à internet em outros sites e a existência de proxy na rede (configure-o se houver)38383838.

Antivírus:

A máquina possui antivírus? 39

Sim: Desative o antivírus e repita o teste40.

Funcionou? Ótimo41.
Não: Vá para o item 4 (reiniciar Updater)42.

Não: Vá para o item 4 (reiniciar Updater)43.

Reinício Forçado do Updater:

Reinicie o Updater forçando-o como master e acompanhe os logs até o fim das verificações de atualização44.
Identificou o log que corresponde à versão esperada? 45

Sim: Se souber resolver, siga em frente; caso contrário, peça ajuda46.
Não: Peça ajuda47.

2.2. Acesso ao Sistema: Segurança

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

Verificação:

O campo logradouro está sendo informado com mais de 50 caracteres? 49

Sim: Esse é o problema, pois o limite para esse campo no Bimer é de 50 caracteres50.
Não: Vá para o item 2 (licenças adicionais).

Verifique no Manager se a licença do cliente está carregando as licenças adicionais corretas51.

Sim: Consulte o bureau do cliente utilizando a aplicação de teste da DLL de segurança52.
Não: Force a atualização da licença na máquina e verifique se o problema persiste53.

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

Verificação:

O cliente tem o produto cadastrado no CRM? 55

Sim: Verifique no UpdateCenter se o aplicativo está cadastrado corretamente, conforme a licença do cliente56. Se não estiver cadastrado, entre em contato com o setor responsável e solicite a criação do aplicativo57.
Não: Peça para verificar com a ADM e STAFF para incluir o produto no CRM corretamente58.

Problema 3: Bloqueios de licença. 59

Verificação:

Pergunte se o cliente tem o produto em questão no CRM60.

Não: O cliente deve entrar em contato com o setor responsável pela inclusão61.
Sim: Verifique se há alguma restrição, como inadimplência, produto cancelado, ou outros problemas de cadastro no CRM (ex: falta de CPF/CNPJ)62.

Pergunte se está apresentando a mensagem "Não foi possível obter a licença para o cliente com identificador"63.

Sim: Verifique se a versão foi liberada para esse cliente64.
Não: Execute o Diagnóstico65.

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

Verificação:

Pergunte se o cliente tem proxy na rede/máquina67.

Sim: Vá no Manager do Updater e configure as informações de proxy, solicitando ao cliente que preencha esses dados68.
Não: Possível falha de conexão; verifique se há antivírus, Warsaw, firewall ou outros aplicativos bloqueando o acesso69.

Verificar categoria do cliente: Usuários com categoria de funcionário não vinculados a pessoas relacionadas (representação ou grupos internos da matriz, como Alterdata Suporte), somente vinculados ao código 900000, não conseguem acesso, pois o Updater não enxerga o 900000 para essa categoria70.
Às vezes, o código do cliente realmente não existe na base de dados. Force a licença do cliente e verifique se a API traz a licença corretamente71.
Verifique se o cliente tem bureau vinculado (clientes da linha Pack não podem ter essa informação em branco no cadastro)72.
Verifique se o passaporte do cliente tem o código do passaporte vinculado73.

Problema 5: Este computador não pode ser identificado. 74

Ao clicar em alterar autenticação, apresenta o erro: "o inicializador de tipo de 'Alterdata. Updater. Aucrmditoria. AuditoriaUpdater' acionou uma exceção".

Solução: Em um caso similar, onde o redfrom.dll apresentava a mesma mensagem (problema para ler a DLL de segurança), o sistema acessou normalmente após reiniciar a máquina75.

Problema 6: "Object reference not set to an instance of an object.". 76

Ao tentar autenticar o passaporte na abertura do sistema, apresenta o erro: "Object reference not set to an instance of an object.".

Solução: Quando o Redfrom.dll retornava o mesmo erro como código http-3, mas com outro passaporte funcionava, a base do Updater em C:\ProgramData\Alterdata\AutoUpdater\dados foi apagada e o problema não ocorreu mais77. Isso ocorre, pois alguma informação nula foi preenchida na licença78.

2.3. Acesso ao Sistema: Updater Parado

Problema 1: Serviço do Updater parado. 79

Verificação:

É possível iniciar o serviço manualmente? 80

Sim: Quando a máquina é reiniciada, o serviço volta a ficar parado? 81

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: 82

"Tempo limite esgotado (30000 milissegundos) ao aguardar a conexão do serviço Alterdata Updater." 83
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." 84
Encontrou esse log?

Sim: Realize o procedimento de criação da chave no regedit (...\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control, Chave: ServicesPipeTimeout do tipo DWORD (32 bits), valor Hexadecimal 240000) OU instale uma versão do Updater que possua o NSSM85.
b. Procure no log de eventos do aplicativo por algum log de erro do Updater que possa ter encerrado o processo. 86 Se encontrar, informe a equipe de desenvolvimento87.

Não: O serviço Alterdata Updater está instalado nos serviços do Windows? 88

Sim: Procure nos logs de eventos do aplicativo por algum log de erro do Updater que possa ter encerrado o processo89. Se encontrar, informe a equipe de desenvolvimento90. Desabilite firewall, Warsaw e antivírus, pois podem bloquear o serviço91.
Não: Execute o arquivo install.bat na pasta de instalação do Updater92. Se não resolver, vá para a dica 393.

3. O serviço do Updater não instala. 94

Desabilite firewall, Warsaw e antivírus (principalmente AVG)95.
Caso não resolva, verifique o .NET Framework96. Peça para o cliente desinstalar e rode o instalador full97. Para reparar o framework nativo, utilize o link: https://support.microsoft.com/pt-br/help/306160/how-to-repair-an-existing-installation-of-the-net-framework98.

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

Solução:

Execute o Diagnóstico100.
Conseguiu localizar o problema pelo Diagnóstico? 101

Sim: Se souber resolver, vá em frente; caso contrário, peça ajuda102.
Não: Peça ajuda103.

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

Verificação:

Pergunte se a máquina/rede possui algum proxy105.

Sim: Vá no Manager do Updater e configure as informações de proxy, solicitando ao cliente que preencha esses dados106.
Não: Possível falha de conexão; verifique se há antivírus, Warsaw, firewall ou outros aplicativos bloqueando o acesso107.

2.4. Updater não inicia o download da versão. 108

Verificações:

A versão desejada foi liberada no Update Center para o cliente? 109
A versão do sistema instalado na máquina já se comunicou com o Updater? 110
O sistema está registrado com o código do cliente corretamente? 111
A versão que precisa ser baixada está liberada para o código do cliente corretamente no site? 112
O cliente em questão possui mais de um CRM com o mesmo CNPJ? Se sim, o cadastro deve ser acertado na administração113.
Procure no log de eventos do master algum log referente ao download em questão114.
O sistema já está cadastrado na base do Updater master? Verifique na área "Licenças" do Updater Manager do master, clicando em detalhes da licença do cliente, aba "Aplicativos Registrados no Updater"115.

Se nenhuma inconsistência for encontrada após as verificações acima: Salve e limpe o log de eventos da máquina do master e clique no botão "Buscar Atualizações Agora" do Updater Manager. Dois minutos depois, acompanhe o log de eventos para verificar se o download da versão iniciou ou se ocorreu algum erro ou alerta referente ao Updater116.

2.5. O download da versão está na pasta mas o Updater não entrega para o sistema. 117

Verificações:

Verifique se o sistema está registrado com o código do cliente corretamente118.
Verifique na base do Updater se o download em questão está vinculado ao código do cliente corretamente119.

2.6. O sistema não está se comunicando com o Updater.

Constatação: Verifique na área "Licenças" do Updater Manager do master, clicando em detalhes da licença do cliente, aba "Aplicativos Registrados no Updater". Se o sistema não for apresentado na lista, provavelmente não está se comunicando com o Updater120. Antes de verificar no Updater Manager, feche e abra o sistema novamente121.
Causas possíveis:

Bonjour não está instalado ou com o serviço paralisado122.
Presença de Malware/Vírus na máquina que possa estar influenciando na comunicação entre o sistema e o Updater123.

Se as dicas acima não resolverem: Verifique o log de eventos do Windows para ocorrências do Updater que possam ajudar124.

2.7. Travamento tela de passaporte. 125

Ao tentar autenticar o passaporte no acesso ao sistema e ficar travada na tela do site Alterdata.com.br, realize as seguintes verificações:

Redefinir o Internet Explorer126.
Verificar acesso aos sites Passaporte2.alterdata.com.br e Passaporte2-basico.alterdata.com.br127.
Verificar instalação do Updater128.
Verificar o diagnóstico e ver se aponta algum tipo de bloqueio como proxy, firewall ou domínio129.
Caso não funcione, testar acesso no redfrom130.
Verificar acesso ao passaporte Test.dll (funciona colocando na %temp% quando o installer está em execução)131.
Verificar o link com https://passaporte2-basico.alterdata.com.br/passaporte-rest-api/rest/admin/usuarios/info?include=assinantes&info=eyJjaGF2ZSI6IjBDM0q5cGFSX2RJcG9jMi16Vnk1ejRDajYwZ3BfWndsTjBUR3BIQmt0Z210a2VGeTFqTmFZTE9adFo2SUZSYmJHZkJIZy0yS2pCQWVVa29CeDlyUzBUekkzaVhnN2J2UFd3cm9iTjZFM25DVzIMd2VmcWcxTENTT2IBcWNXNTNJMVQwR0NhSF9MVFAtTTIfRUqtLVh5Q0cydXh2SUpST0tPeUhidHV0WVJCdTBITzFxbHB0MGZjZzNBWHdLWVFXU0NnbjlnVzRESGpFbzlsNU IZPaXNMUnNjNHVnR0htcEtNdUY0NnpBcjVTSjdCRml6LUppcWluWIRIMnB2ZW1jck1EUk15bGRUMHqxZTFWcGstR1YyUnIZZS1qa1NWcFJocUR3N3N PVkZGX2RIbFBBdylsInRva2VueiI6ImMtdl9jMG5ETWZOR3BO MnNlIQTIIbGFqRkdpbWduemhjLWQ3cHBiV1ladVRycUxqSnRibnByVlYlQjEtQXZCS3M3cnVIYk9mOUc0R0JpQlk5TzN5d1hRVnNza0JZSFNMcTZRZVpMT2dzTWw3Sk10WktGVTVjc2VEdjlUZOjWEg3WU1nUmNxTHJaTVRvbE56T KOTIECFpIYXg1cFNSMzFIQ3RUdWFCR1IMbjWJsaTBzc3ZXaFh4dXNXY2NKdWI1F2bFFJSG1icWpuNRuaUwzcGNuMWpQV2VDMWg1N001RUNpMkx3T3NXOGEzejlyUGVFS1QtZnNkU115WXINNXFxdIBDV01ORUJFcFJvRXBxcEZSdnBiTzM4c2Q3MXV2QVoxeVFHZVRCOTI1bE1mUVBzQ3NfV0UtSUZIenICMFExaUpEdnE4MzVHWkhrSWF FZUIMWEtJdUp6WTNFUnJ3bzIOTVktVkxjSWVCMkMwZTFjYjRtdzh4TnJ6OG1rUkxtV2ZDY0dTeWtYdFdLa3Z4QnkySDh OYONMOFF1RIMyeTZmMFVMWUtGeUhMMWItOE93TIN6SEljeWs2YWICcnMtRkdhTzNJM29pVFVRN2RCMEtXY0hfUjBpTVlicnc4S0VYNklxQTdxYkhGaEE1MEZSejIZUm12djZmZGptUVVrTIVRa3MifQ (lembrando de modificar com as informações de chave de autenticação do cliente)132.
Não passando, verificar se a chave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\fipsalgorithmpolicy no regedit está com valor 0. Caso esteja com valor 1, modificar para 0 conforme dica do link https://support.microsoft.com/pt-br/help/981119/fix-you-cannot-run-an-asp-net-3-5-based-application-that-uses-a-script133.

2.8. Erro na rotina 'Procurar NovasAtualizacoes OnLine'. 134

Log de Erro: System.Reflection.TargetInvocationException: Uma exceção foi acionada pelo destino de uma chamada. ---> System.InvalidOperationException: Esta implementação não faz parte dos algoritmos criptográficos validados por FIPS da Plataforma Windows. 135
Solução: É necessário fazer uma configuração no gpedit do Windows136:

Com credenciais administrativas, clique em Iniciar, Executar, digite gpedit.msc e pressione Enter137.
No Editor de Diretiva de Grupo Local, clique em Configuração do Computador, clique duas vezes em Configurações do Windows e, em seguida, clique duas vezes em Configurações de Segurança138.
Clique em Definições de segurança, faça duplo clique em Políticas locais e, em seguida, clique em Opções de segurança139.
No painel de detalhes, clique duas vezes em "Criptografia do sistema: Use algoritmos compatíveis com FIPS para criptografia"140.
Clique em "Habilitado" e em OK para fechar a caixa de diálogo141.
Feche o Editor de Diretiva de Grupo Local142.

Alternativamente: Altere a chave de registro HKLM\System\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Habilitado para 1143.

2.9. Updater não inicia (Erros diversos).

Log de Erro: "...System.IO.FileNotFoundException: Não foi possível carregar arquivo ou assembly 'System.EnterpriseServices.Wrapper.dll' ou uma de suas dependências. De: Não foi Possível Encontrar o módulo Especificado..." 144

Problema: Problema com o .NET Framework do cliente145.
Solução: Reinstalar o Framework (NÃO REPARAR)146.

Log de Erro: "Erro ao abrir a conexão com o servidor: Uma tentativa de conexão falhou porque o componente conectado não respondeu corretamente após um período de tempo ou a conexão estabelecida falhou porque o host conectado não respondeu xx.x.x.x:8767" 147

Problema: A porta 8767 não está liberada no firewall148.
Solução: Liberar as portas 8767 e 8766 nas regras de entrada e saída do firewall. Reiniciar o serviço do Updater149.

Consta em nossos cadastros que xxxx possui 0 licenças para utilização..... 150

Updater funcionando sem nenhum erro nos logs?

Não: Contingência não está funcionando nesta versão - resolver updater151.
Sim: Verifique se a quantidade de usuários entregue está de acordo com o cadastro no CRM152.

Verifique pela endpoint: {{host}}/api/licenca quantas licenças são retornadas (pesquisar pela palavra "usuarios")153.
Compare se a quantidade de usuários retornada pelo Postman é igual à quantidade de usuários no Updater do cliente (consultar licença ativada pelo botão escondido do Updater Manager e pesquisar por "usuários")154.
Normalmente, quando o cliente não tem controle de usuários, a quantidade retornada é 999 (ilimitado)155.
Se houver dúvida, consulte o CRM do cliente, clicando no produto pai e na aba "complemento do produto" (deve apresentar "usuários/conexões simultâneas = x")156.
A quantidade de usuários é determinada pelo cadastro do cliente no CRM. Inconsistências devem ser alteradas pela ADM157.

Este computador não pode ser identificado. 158

Verificações (sem erro aparente): IE, Antivírus, Proxy, Domínio, Versão do Updater, Atualizações do Windows, Logs de eventos159.
Solução: Em um caso, o Read From foi testado, e o passaporte não abriu, dando erro no System.auditoria. Verificou-se no CMD (arquivo regasm.exe em C:\Windows\Microsoft.NET\Framework\v4.0.30319) que o .NET Framework do cliente estava desatualizado. Baixar e atualizar para a versão mais recente do .NET Framework, e reiniciar a máquina, resolveu160.

2.10. Installer Erro: "Error connecting with SSL. EOF was observed that violates the protocol." 161161161161

Causa: O pfSense (ou outro firewall) pode estar bloqueando o SSL TSL 2.
Solução: Em um caso, a troca de rede resolveu, indicando um bloqueio pelo firewall do pfSense162.

2.11. Error: System.Net.WebException: A conexão subjacente estava fechada: Erro inesperado em um recebimento. ---> System.ComponentModel.Win32Exception: O cliente e o servidor não podem se comunicar porque não possuem um algoritmo em comum. 163

Dica: Renan pediu para guardar essa dica com a vida. Possivelmente relacionado a problemas de comunicação de algoritmo entre cliente e servidor. A referência citada é "Multiple Products: SQL Server service will not start, error code-2146893007-Knowledgebase / Software - Wasp Helpdesk"164.

3. APIs Consultadas pelo Updater

O Updater se comunica com diversas APIs para realizar suas funções. As principais APIs e seus usos são:

API	Função Principal	Funções Adicionais
Licença	Acesso ao sistema 165	Atualização de licença 166
		Geração de licença 167
		Listagem de produtos no installer 168
		Validação do passaporte 169
Verificar Atualizações	Última versão liberada para o cliente 170	Download de versões (installer e Updater) 171
Versão	Solicitação de URL 172	Confirmação de download 173
Maior versão installer	Última versão instalada no cliente 174	Download de versão com installer 175

Ambientes e URLs das APIs: Para verificar os serviços nas demais APIs, basta trocar o link do Post, sem necessidade de alterar o corpo (body)176.

Oficial:

https://updatecenter.alterdata.com.br/api/licenca 177
http://updatecenter.alterdata.com.br/api/verificar_atualizacoes 178
http://updatecenter.alterdata.com.br/api/maiorversaoinstaller 179

Homologação:

http://updatecenter-homolog.alterdatasoftware.com.br/api/licenca 180
http://updatecenter-homolog.alterdatasoftware.com.br/api/verificar_atualizacoes 181
http://updatecenter-homolog.alterdatasoftware.com.br/api/maiorversaoinstaller 182

http://updatecenter-qa.alterdatasoftware.com.br/api/licenca 183
http://updatecenter-qa.alterdatasoftware.com.br/api/verificar_atualizacoes 184
http://updatecenter-qa.alterdatasoftware.com.br/api/maiorversaoinstaller 185

4. Dicas Úteis para Diagnóstico

4.1. Detecção de Proxy

Tentar acessar sites como: g1, facebook, globo.com186.
Executar comando ping no CMD: ping + dominio (ex: updatecenter.alterdata.com.br / alterdata.com.br)187.
Utilizar sites de detecção de IP/Proxy como:

http://www.ipaddressloactnio.org/ 188
http://www.find-ip-address.org/ 189
Computador com proxy: Exibe "Proxy Server Detection Real IP Address X.X.X.X Transparent Proxy detected Y.Y.Y.Y"190.
Computador sem proxy: Exibe "Proxy Server Detection No Proxy detected or you use High Anonymous Proxy"191.

4.2. Detecção de Firewall Externo

Localizar o gateway da estação pelo comando ipconfig192.
Digitar o gateway no navegador e verificar se abre uma página de firewall ou do roteador193.

4.3. Detecção de Domínio (Workgroup)

Acesse: Meu computador -> Propriedades -> "Computer name, domain, and workgroup settings". A informação estará em "Workgroup"194.

4.4. Desconectar um Usuário em Edição de Versão

Antes de qualquer procedimento, o analista deve tentar resolver a situação via aplicação, verificando se a versão realmente não está em edição em alguma estação195.
Através da URL {{host}}/api/aplicativo_versao/id da versão/lock é possível recuperar e desconectar um usuário que está em edição em uma versão196.
Exemplo:

Para saber o ID da versão que está sendo editada197.
GET {{host}}/api/aplicativo_versao/5286/lock retorna o usuário editando a versão (ex: "usuario": "renan.dsn.cir", "blocked": true)198.
DELETE {{host}}/api/aplicativo_versao/5286/lock remove o usuário da edição, e ele só poderá retornar à fila de edição 30 segundos após ser desconectado199.

Este recurso deve ser usado quando a versão estiver com uma sessão "presa". Em caso de recorrência, deve-se averiguar a causa200.

4.5. Configuração do Updater (No Update Manager)

Para configurações no Update Manager (como parar o serviço para realizar alterações):

Parar o serviço201.
Pressionar Win+R202.
Digitar regedit203.
Acessar: HKEY_LOCAL_MACHINE > SOFTWARE > ALTERDATA > UPDATER204.
No campo em branco ao lado, clique com o botão direito do mouse, selecione Novo -> Valor da Cadeia de Caracteres205.

4.6. Como descobrir a versão do .NET Framework

Opção 1 - Windows Explorer: 206

Pressione Win+R para abrir o Executar, digite windir%\Microsoft.NET\Framework\ e pressione Enter, ou navegue até C:\Windows\Microsoft.NET\Framework207.
Você verá pastas com as versões do .NET Framework instaladas208.
Para Windows de 64 bits, verifique também a pasta C:\Windows\Microsoft.NET\Framework64209.

Opção 2 - Linha de comando (PowerShell ou Prompt de Comando): 210

Pesquise por "PowerShell" no menu iniciar e abra o "Windows Powershell"211.
Cole o comando wmic product get description | findstr /C:.NET e pressione Enter212.
Aguarde a lista de versões instaladas213.
No Prompt de Comando, use: wmic product where "Name like 'Microsoft .Net%" get Name, Version214.

Opção 3 - Editor de Registro: 215

Pressione Win+R, digite regedit e Enter216.
Navegue até a chave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP. Você verá chaves para cada versão instalada217.

Opção 4 - Programa (.NET Version Detector): 218

Baixe o .NET Version Detector (clique na seta verde para baixo ao lado do nome)219.
Extraia o conteúdo do arquivo ZIP para uma pasta e execute o arquivo dotnet.exe220.
Clique em "OK" para aceitar os termos de uso e ele exibirá as versões do .NET Framework no seu PC221