Worker - Instalação e configuração

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

Confira abaixo, o procedimento para a instalação e configuração do Promob Worker.

IMPORTANTE:

• Para ter acesso ao instalador do Promob Worker, entre em contato com o suporte ou consultoria.

• Não é possível instalar o Promob Worker 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:

Instalação do 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 a serem inseridos, 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 inserida a mesma senha utilizada para logar na conta do Windows em 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.

Instalação do SQL Compact 4.0

Caso não esteja instalado. Para baixar o 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. 

1. Após acessar o link acima, clique em Baixar

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

Instalção do serviço Promob.LogDatabase

Instalação do serviço Promob.QueueERP

IMPORTANTE: somente necessário, caso tenha plugin de integração Promob: Plugin ERP Promob.

• 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, clique 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.

Deve-se sempre usar a informação de Endereço IPv4.

Após digitar o IP, clique 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.

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

Opções do Projeto

Na aba de Opções do Projeto, é possível configurar os seguintes campos:

• 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.
• Permitir processamento de múltiplas versões de Program Proomb: Esta opção habilita o processamento de até três versões diferentes de Program Promob do projeto.
• Manter nome do arquivo local (.promob) para o projeto: Com essa opção habilitada, o nome do arquivo .promob é mantido durante todo o processamento e geração do xml de integração.
• Número de tentativas de processamento para um projeto: O numero configurado nessa opção faz com que o Worker encerre as tentativas de processamento de um projeto que ficou em loop ou trancado por qualquer motivo, depois de X tentativas de processamento.

Logs

Na aba de Logs, serão informados 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.

IMPORTANTE: 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, é necessário configurar o caminho do banco de dados. Caso já tenha um banco de dados instalado, configure o caminho deste. Caso não tenha um, é necessário instalar o serviço. 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:

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.