Problemas com o Agente ETL no Windows

Tipo

Solução de problemas

Para

Engenharia de dados

Na tela

Windows › Configurador HorusFlow

Falhas de instalação, de serviço e de atualização do Agente ETL instalado pelo .msi. No Windows o Agente leva o nome HorusFlow: é assim que ele aparece em Aplicativos instalados, no atalho Configurador HorusFlow do menu Iniciar e no serviço Horus Flow Service. Para falhas de carga e de conexão com o banco, ver Problemas no HorusETL.

A instalação falha ou desfaz tudo no fim

Causa: uma etapa do instalador deu erro e o Windows desfez a instalação inteira. A janela do instalador mostra só uma mensagem genérica; o motivo fica no log, e o instalador só grava log quando você pede.

Como confirmar: rode o instalador de novo gravando o log. Abra o Prompt de Comando como administrador (no menu Iniciar, digite cmd, clique com o botão direito e escolha Executar como administrador) e rode o comando abaixo, trocando o caminho pelo do arquivo que você baixou:

msiexec /i "%USERPROFILE%\Downloads\Horus.ETL.Setup.msi" /L*V "%USERPROFILE%\Downloads\horusflow-instalacao.log"

/L*V grava no .log tudo o que o instalador faz. Quando a instalação falhar, abra o arquivo no Bloco de Notas e procure por Valor de retorno 3 (Return value 3 num Windows em inglês). A primeira ocorrência traz o nome da etapa que falhou, e as linhas logo acima dela mostram o erro. Se for pedir ajuda ao suporte, mande o .log junto.

Conserto: depende do que o log mostra.

No log	O que fazer
A etapa ExtractPython com valor de retorno 3	O antivírus bloqueou a extração do Python que vem no instalador, ou faltou espaço em disco. Libere a pasta C:\Program Files\HorusFlow no antivírus, confira o espaço livre e instale de novo
Erro 1618, outra instalação em andamento	O Windows Update ou outro instalador estava rodando. Espere terminar e instale de novo
Erro 1925, privilégios insuficientes	O instalador rodou sem administrador. Rode o msiexec num Prompt aberto como administrador
Erro 1923 no serviço HorusFlow	Uma desinstalação anterior deixou o serviço marcado para exclusão. Feche a tela Serviços do Windows, ou reinicie a máquina, e instale de novo

O Configurador HorusFlow não abre e o Windows pede o .NET

Causa: falta o .NET Desktop Runtime 8 na máquina. O serviço do Agente roda com o .NET Runtime 8, mas o Configurador, a janela onde se cola o token, precisa da versão Desktop. Sem o Configurador, o token não é registrado e o Agente não fica online.

Como confirmar: ao abrir o Configurador HorusFlow, o Windows avisa que é preciso instalar o .NET. Em Aplicativos instalados não aparece Microsoft Windows Desktop Runtime - 8 (x64).

Conserto: instale o .NET Desktop Runtime 8, versão x64; ele já inclui o .NET Runtime. Depois abra o Configurador HorusFlow pelo menu Iniciar e registre o token como em O Agente fica Offline logo depois da instalação. Não é preciso reinstalar o Agente.

O Agente fica Offline logo depois da instalação

Causa: o token não foi registrado. O instalador sobe o serviço antes de você colar o token, e sem token o serviço para em seguida. Acontece quando a janela HorusFlow - Chave de Ativação é fechada sem clicar em Registrar Token, ou numa instalação silenciosa (/qn), que não abre o Configurador.

Como confirmar: o arquivo C:\Program Files\HorusFlow\key.dat, onde o token fica guardado, não existe. Na tela Serviços do Windows, Horus Flow Service está parado.

Conserto: abra o Configurador HorusFlow pelo menu Iniciar e aceite o pedido de administrador. Cole o token, copiado da tela do Agente no Lumo, e clique em Registrar Token. O Configurador confere o token com o Lumo, grava o arquivo, sobe o serviço e mostra HorusFlow Rodando. A Situação do agente: muda para Online.

Numa instalação silenciosa, grave o token sem abrir janela, num Prompt de Comando aberto como administrador:

echo SEU_TOKEN> "C:\Program Files\HorusFlow\key.dat"
sc start HorusFlow

Para trocar o token, por exemplo depois de excluir o Agente no Lumo e criar outro, apague o key.dat e abra o Configurador de novo. Enquanto o arquivo tem um token que o Lumo não reconhece, o Configurador abre com Erro na validação e comunicação da chave!.

Se o key.dat existe e o Agente continua Offline, o problema é a rede. O serviço se encerra quando passa 30 s sem resposta do Lumo, e o Windows o sobe de novo 30 s depois, até três vezes seguidas; ver O Agente ETL precisa estar online.

A versão não muda depois de Atualizar Agente ETL

Causa: Atualizar Agente ETL baixa o mesmo instalador .msi e o roda em segundo plano. Se ele falha, o Windows desfaz a instalação, o Agente volta na versão anterior e a tela do Lumo não mostra o erro.

Como confirmar: na máquina do Agente, abra C:\ProgramData\HorusFlow\update\updater.log. A linha msiexec exit code: traz o código do instalador: 0 é sucesso. O log completo do instalador fica na mesma pasta, em msiexec.log, e se lê como em A instalação falha. A pasta C:\ProgramData é oculta: digite o caminho na barra de endereço do Explorador de Arquivos.

Conserto: resolva o que o msiexec.log apontar e clique em Atualizar Agente ETL de novo. O código 1618 já ganha uma segunda tentativa automática, dois minutos depois. Se a falha se repetir, baixe o instalador em Baixar instalador (.msi), na tela do Agente, e rode à mão com o comando de log de A instalação falha. O token continua gravado na pasta do Agente.

Python não encontrado neste agente.

Causa: sumiu a pasta PythonEmbed, onde fica o Python que o instalador põe junto do Agente. A atualização automática das versões até a 1.29.12 apagava essa pasta. Se a máquina tem um Python próprio instalado, o Agente usa esse no lugar e o erro muda: o nó Python falha por versão ou por biblioteca que falta (ver Python).

Como confirmar: o fim da mensagem traz PythonEmbed: NÃO existe.

Conserto: clique em Atualizar Agente ETL. O instalador das versões novas recria a pasta quando ela falta. Se o Agente já está na versão mais nova, desinstale o HorusFlow em Aplicativos instalados e instale de novo: reinstalar a mesma versão por cima não recria a pasta. Tenha o token à mão, caso o Configurador peça.

Onde fica cada coisa

O quê	Onde
Pasta do Agente	C:\Program Files\HorusFlow
Token	C:\Program Files\HorusFlow\key.dat
Python embutido	C:\Program Files\HorusFlow\PythonEmbed
Log do serviço	C:\ProgramData\HorusBI\HorusFlow\logs, o mesmo do painel Logs do Agente ETL
Log da atualização automática	C:\ProgramData\HorusFlow\update: updater.log e msiexec.log
Serviço do Windows	Horus Flow Service, nome HorusFlow, conta Sistema Local, início automático
Configurador	Configurador HorusFlow, no menu Iniciar; pede administrador para abrir