Worker - Instalação e configuração

Disponível a partir da versão Worker 6.60.20.0 ou superior.

Para instalar e configurar o Promob Worker, realize os procedimentos abaixo:

 

IMPORTANTE:

• Para ter acesso ao instalador do Promob Worker entre em contato com o suporte ou consultoria.
• O Promob Worker não pode ser instalado em máquinas virtuais. Consulte aqui os requisitos mínimos.
• A partir da versão 6.6.20.0 do Promob Worker, não é mais necessária a instalação do serviço QueueProject. Todo o gerenciamento da fila será executado pelo Worker. No entanto, mantém-se obrigatória a instalação do serviço BuilderHub no mesmo computador em que o Worker está instalado.

 

Instalação

Após instalar o Promob Worker, é necessário proceder com a instalação de alguns serviços essenciais para o processamento do Worker: BuilderHub, LogDatabase, DocumentDatabase e, o QueueERP (opcional).

Todos os instaladores se encontram na pasta do Promob Worker, em: Disco C:/Arquivos de Programas/Promob/Promob Worker/Program/ bin, abaixo segue informações para instalação de cada serviço:

1. Instalar o serviço Promob.BuilderHUB

 

IMPORTANTE: Durante a instalação é solicitado login de senha do usuário do Windows.

Disponível a partir da versão Worker - 6.60.0.18 e do Builder - 1.60.17.2.

Para a opção de Nome de Usuário deve ser colocado o nome do usuário do Windows logado e o domínio. 

• IMPORTANTE: Essa informação pode ser identificada em Painel de Controle\Contas de Usuário\Contas de Usuário.

Para verificar a informação de domínio e usuário que deve ser inserido, consulte através do Prompt de Comando:

1. Acesse o Prompt de Comando do Windows (tecla Windows + R, em seguida cmd + enter);

2. Digite o comando whoami e pressione enter;

3. Veja as informações de domínio e usuário.

 

Para a opção de Senha e Confirmar senha deve ser colocado a mesma senha utilizada para logar na conta do Windows que a máquina está funcionando.

• IMPORTANTE: não pode ser criada uma senha nova, a senha utilizada deve ser a mesma senha utilizada para logar no Windows.

 

2. Instalar o SQL Compact 4.0, caso não esteja instalado. Para baixar pacote Clique aqui.

IMPORTANTE: caso o Windows for 64 bits, instale a versão X64 e caso for 32 bits, instale a versão X86. Para mais informações de como identificar os requisitos do seu computador, clique aqui. 

• Após acessar o link acima, clique em Baixar

• Escolha uma das versões do serviço a ser baixada e clique em Next.

3. Instalar o serviço Promob.LogDatabase

 

4. Instalar o serviço Promob.QueueERP

IMPORTANTE: Necessário somente se tiver plugin de integração Promob: Plugin ERP Promob.

 

5. Caso algum serviço não esteja ativo, deve-se iniciar o serviço na janela de serviços Windows.

 

Configuração

Na tela inicial, deve-se clicar em Configurações

A tela de configurações é dividida nas seguintes áreas:

• Serviços
• Gerais
• Logs
• Versões de biblioteca
• Fila Worker
• Fila ERP

 

Serviços

Na aba de serviços, deve ser informado o IP (como, por exemplo, 192.168.1.1) do local de cada serviço. Para buscar o IP, aconselha-se usar o Prompt de comando (cmd.exe) e digitar ipconfig.

Na aba de serviços, deve ser informado o IP (como, por exemplo, 192.168.1.1) do local de cada serviço. Para buscar o IP, aconselha-se usar o Prompt de comando (cmd.exe) e digitar ipconfig.

 

Deve-se sempre usar a informação de Endereço IPv4.
Após digitar o IP, deve-se clicar em verificar. Ao realizar essa ação, o serviço mostrará a versão atual e a comparação com a versão mínima.

 

Gerais

Nas configurações da aba "Gerais", é possível configurar as seguintes informações:

• Tempo máximo para processar arquivo .Promob, em minutos: Determine o tempo máximo para o processamento de arquivos *.promob, em minutos. Esse intervalo define quando o Promob será reiniciado.
• Número de arquivos .Promob para reiniciar o Promob: Configure a quantidade de arquivos *.promob a serem processados antes do reinício do Promob.
• Habilitar o envio de e-mail sobre projetos não processados: Ao marcar essa opção, habilita-se a função de envio de e-mails.
• E-mail de contato para log de projetos não processados /Login: Insira o(s) e-mail(s) de contato para receber logs de projetos não processados. Caso ocorra algum erro, o Worker enviará um e-mail detalhando o motivo e o arquivo .promob ou .xml. Para inserir mais de um e-mail, utilize ; (ponto e vírgula). Exemplo: teste@promob.com; teste1@promob.com

• Tempo para reenvio de e-mail, em minutos: Defina o intervalo de tempo para o Worker reenviar e-mails.
• Usar serviço do ERP: Esta função verifica se é necessário ter o serviço do QueueERP instalado e configurado para o funcionamento do Worker.
• Validar nodo máquina: Esta função verifica se há informações no nodo máquina no XML gerado. Se o projeto não possuir informações de nodo máquina, a geração do XML de integração será interrompida, e um e-mail será enviado ao responsável.
• Validar roteiro produtivo: Esta opção verifica se o roteiro produtivo gerado no XML de integração contém erros ou informações ausentes. É importante destacar que essas validações ocorrem apenas no XML gerado. Mesmo que o setup do cliente não tenha máquinas ativas ou se a peça não contiver operações, elas serão validadas.
• Atualizar Worker: Abre o Promob Update para atualização do Worker.
• Gerenciamento e configuração de plugins: Abre o Promob para gerenciamento de plugins, onde é possível ativar novos plugins e fazer configurações.

 

 

Logs

Na aba de Logs será informado os seguintes campos:

• Pasta do banco de dados: Pasta onde está localizado o arquivo de banco de dados (LogDatabase.sdf).
• Frequência de backup, em dias: Qual a frequência que será gerado um backup do banco de dados.
• Quantidade de Backup: Números de backups será salvo.
• Pasta do Backup: Pasta onde serão salvos os backups do banco de dados.

 

 

Versões da Biblioteca

Esta seção permite a configuração de diferentes versões de bibliotecas que podem ser processadas pelo Worker. Para mais informações, clique aqui.

 

 

Fila Worker

• Pasta de entrada de arquivos .Promob no Worker: Pasta de entrada dos projetos .promob para serem processados pelo Worker.
• Pasta de sucesso de arquivos .Promob no Worker: Pasta onde será salvo o .promob processado com sucesso e o arquivo xml de integração.
• Pasta de erro de arquivos .Promob no Worker: Pasta onde será salvo o .promob não importado com sucesso e o arquivo de retorno de erro.

 

 

Fila ERP

• Pasta de entrada de arquivos .XML para serem processados: Pasta de entrada dos projetos xml gerados pelo Plugin ERP Promob ou Plugin ERP Promob Start.
• Pasta de retorno de arquivos .XML para serem processados: Pasta de retorno do processo de importação para o ERP. O ERP retornará um arquivo .json.
• Pasta de sucesso de arquivos .XML para serem processados: Pasta onde será salvo o xml importado com sucesso, o arquivo de retorno, e o arquivo .promob, caso existir.
• Pasta de erro de arquivos .XML para serem processados: Pasta onde será salvo o xml não importado com sucesso, o arquivo de retorno, e o arquivo .promob, caso existir.
• Caminho do executável do ERP: Caminho do executável do Promob ERP para realizar a integração. O executável é o menuWorkerPromob.exe.
• Tempo de espera do ERP, em minutos: Tempo de espera da resposta pelo ERP, isto é, o arquivo .json na pasta de retorno. Caso exceder, ele irá tentar importar o próximo projeto da fila e será gerado uma informação de tempo excedido na pasta de erro.
• Números de envios simultâneos: Quantidade de arquivos .xml que será enviado simultaneamente ao Promob ERP.

 

Observação: A resposta do ERP pode acontecer após a mensagem de erro por tempo excedido e será retirado da pasta de erro.

Após alterar as configurações, deve-se salvar as configurações realizadas, clicando no botão Salvar.

IMPORTANTE: Após essas etapas concluídas, deve-se instalar os plug-ins necessários para o funcionamento do Promob Worker.

Os plugins obrigatórios são: Plugin Builder, Plugin Builder Budget, Plugin Builder View, Plugin de Integração (Plugin ERP Promob, Plugin ERP Promob Start, Plugin ERP Standard e Plugin ERP Focco).

Após a instalação dos plug-ins, deve-se configurar o caminho do banco de dados. Caso já tenha um banco de dados instalado, configure o caminho deste. Caso não tenha um banco de dados, é necessário instalar o serviço de banco de dados para isso clique aqui.

 

Utilização de VPN (Virtual Private Network) para comunicação dos serviços

Conforme foi visto neste artigo existem alguns serviços que são essenciais para o processamento do Worker, são eles: BuilderHub, LogDatabase, DocumentDatabase e, o QueueERP(depende de configuração). E nem todos eles precisam estar instalados no mesmo computador que o Worker, conforme pode ser analisado na tabela abaixo:

Máquina	Local de Instalação	Serviços Instalados
Worker	Mesma máquina que o Worker está instalado	BuilderHub
ERP	Mesma máquina que o ERP está instalado	QueueERP
Qualquer	Indiferente (preferencialmente a Worker)	LogDatabase e DocumentDatabase

 

O que pode ocorrer na infraestrutura é ter a máquina do Worker em uma rede e a do ERP em outra rede e fazer a interligação delas por meio de VPN e sobre isso gostaríamos de informá-lo sobre algumas considerações importantes ao utilizar serviços Windows em redes separadas, interconectadas por meio de VPN.

Embora o uso de VPNs possa proporcionar uma solução temporária para unir redes distintas, esta abordagem ocasiona diversas situações incorretas, impactando a performance e a estabilidade dos serviços. Aqui estão algumas situações principais que podem ocorrer:

• Desempenho e Latência:
  • Conexões Lentas: As VPNs podem introduzir latência adicional devido à criptografia e à necessidade de roteamento dos dados através de um túnel seguro. Isso pode resultar em uma performance reduzida, especialmente para aplicações que requerem alta velocidade de rede.
  • Variação de Velocidade: A velocidade da conexão VPN pode variar significativamente, afetando a consistência e a confiabilidade do acesso aos serviços.

• Confiabilidade e Estabilidade:
  • Quedas de Conexão: Conexões VPN são suscetíveis a quedas de conexão, o que pode interromper serviços críticos e causar períodos de inatividade.
  • Complexidade de Configuração: A configuração adequada de VPNs pode ser complexa e propensa a erros, o que pode resultar em problemas de conectividade e segurança.

Sendo assim, recomendamos a utilização de todos os serviços na mesma rede.