Agentes privados Jitterbit no Microsoft Windows

Introdução

Esta página mostra como instalar e executar um agente privado no Microsoft Windows. A seção Solução de problemas fornece uma lista de problemas comuns e suas soluções.

Instalar

Para instalar um agente privado, verifique os Pré-requisitos e siga as etapas nas seções Download e Executar instalador.

Pré-requisitos

Você deve ter o seguinte:

• Um host que atenda aos requisitos do sistema.

• Seu nome de usuário e senha da conta Harmony.

• O nome da sua organização Harmony.

• O nome e ID de um grupo de agentes privados.

• Acesso a uma conta de administrador do Microsoft Windows no host. Use-a para todas as ações nesta página.

• Se habilitado, desative a autenticação de dois fatores (TFA). Você pode reativar a TFA após a instalação.

Os seguintes itens são opcionais:

• Adicionar um agente no Console de Gerenciamento. Se você não tiver nenhum agente privado não registrado no grupo de agentes, um será criado automaticamente com um nome que inclui o nome do host e o endereço IP.

• Um servidor de banco de dados PostgreSQL é instalado automaticamente. Para usar o seu próprio, configure-o antes de instalar o agente privado e tenha em mãos seu nome ou endereço IP, número da porta e os detalhes da conta do administrador do banco de dados.

Os seguintes itens são recomendados:

• Desative a compactação e criptografia do Windows nas seguintes pastas:

  Descrição	Local padrão
  Pasta do agente privado	C:\Program Files\Jitterbit Agent\
  Pasta temporária do sistema	C:\Windows\Temp\
  Pasta de dados PostgreSQL	C:\PostgreSQL\*\data\

• Siga o guia de configuração de ajuste de desempenho.

Download

Para baixar o software do agente privado, acesse a página Downloads do Portal Harmony. (Se você já tiver adicionado um agente na página Agentes do Console de Gerenciamento, clique no ícone Baixar Agente Jitterbit do agente.)

Baixe um dos seguintes pacotes do Windows do agente privado:

• Windows (x64): (Recomendado) O pacote instalador padrão (arquivo .exe). O modo Instalação Rápida instala todos os componentes em seus locais padrão. No modo Avançado, você pode definir o local de instalação e configurar seu próprio servidor de banco de dados PostgreSQL.

• Windows Quiet Agent Installer (x64): O instalador silencioso (arquivo .zip). Usa um arquivo de configuração para permitir instalação autônoma.

Executar instalador

Siga as etapas para o tipo de instalador:

1. No prompt Select Install Mode, selecione Quick Install ou Advanced:

   -   **Quick Install:** Este modo instala o agente privado no local padrão (`C:\Program Files\Jitterbit Agent`), instala um servidor de banco de dados PostgreSQL, instala o driver psqlODBC, cria um usuário local do Microsoft Windows `jitterbitpostgres` e instala pacotes do Microsoft Visual C++ Redistributable. Se uma instalação PostgreSQL existente for encontrada, o instalador muda para o modo avançado.
   
       1.  Digite e confirme uma [senha válida](/pt/agent/postgresql/#password-character-restrictions) para o servidor de banco de dados PostgreSQL sendo instalado. Esta senha também é usada para a conta de serviço `jitterbitpostgres`.
   
           !!! note "Versão do agente 12.8 e posterior: validação de senha PostgreSQL"
               A partir da versão 12.8 do agente privado, o instalador valida a senha da conta de serviço PostgreSQL (`jitterbitpostgres`) em relação às [restrições de caracteres](/pt/agent/postgresql/#password-character-restrictions) e exibe um prompt se contiver um caractere não permitido. Versões anteriores não validam a senha nesta etapa, e uma senha inválida causa falha na instalação com [Erro 1722](/pt/agent/troubleshooting/#win-error) após o PostgreSQL já ter sido instalado.
   
       2.  Em cada etapa da instalação do PostgreSQL, clique em **Next >**.
   
       3.  Na última página do instalador, clique em **Finish**. Você pode confirmar a organização, o grupo de agentes e o registro do agente na página **Installation Summary**.
   
   -   **Advanced:** Este modo permite instalar o software do agente em um local diferente e escolher um servidor PostgreSQL existente.
   
       4.  (Opcional) Na página **Choose Destination Folder**, clique em **Change** para definir o local de instalação.
   
       5.  Na página **Database administrative credentials**, digite os detalhes de um servidor de banco de dados PostgreSQL existente.
   

   1. Na última página do instalador, clique em Finish. (Se a instalação falhar, ative a opção Show the Windows Install log antes de clicar em Finish.)

1. Edite silent_install64.ps1, localize o parâmetro $JitterbitArgList e verifique ou altere o valor de KO_INSTALL_MODE:

   • KO_INSTALL_MODE=\"1\": Instala um agente privado e um servidor de banco de dados PostgreSQL.

   • KO_INSTALL_MODE=\"2\": (Padrão) Instala apenas um agente privado. Para esta opção, você deve ter um servidor de banco de dados PostgreSQL existente instalado.

2. Em um prompt de comando, execute os seguintes comandos:

   Set-ExecutionPolicy Unrestricted
   silent_install64.ps1
   

   • Linha 1: Permite a execução de scripts do PowerShell.
   • Linha 2: Executa o instalador silencioso.

Se os valores configurados estiverem corretos, a instalação prossegue sem intervenção adicional e o agente privado é iniciado. Você pode verificar seu status no Console de Gerenciamento ou observando o arquivo de log C:\Program Files\Jitterbit Agent\log\jitterbit-agent.log.

Se a instalação falhar, verifique o arquivo de log log\Installer.log para obter mais informações.

Atualização

As versões do agente privado usam versionamento semântico, expresso na forma X.Y, onde X é o número da versão principal e Y é o número da versão secundária. Existem dois tipos de atualização:

• Principal: Quando você atualiza 10.x → 11.x ou 11.x → 12.x, considera-se uma atualização de versão principal. Nesses casos, você deve parar e reiniciar o agente e aguardar a conclusão de uma sincronização completa dos ambientes. Durante uma sincronização completa, o ambiente fica bloqueado e não pode processar operações. Se os projetos no ambiente forem grandes, isso pode levar algum tempo.

• Secundária: Quando você atualiza 10.x → 10.y, 11.x → 11.y ou 12.x → 12.y, trata-se de uma atualização de versão secundária. Nesses casos, você só precisa parar e reiniciar o agente.

  Atualizações da versão 11.48 e anteriores para 11.49+ incluem atualizações necessárias de conectores

  Atualizações de agentes privados 11.48 e anteriores para 11.49 e posteriores incluem uma atualização necessária para conectores baseados em Connector SDK.

  Você será solicitado a aceitar isso durante o processo de atualização ao usar o instalador padrão. As atualizações feitas usando o instalador silencioso aceitam automaticamente esse pré-requisito.

Atualizações de 11.x para 12.x

Atualizações de plug-in são necessárias para usar os plug-ins Multipart Pipeline ou AWS S3 Create em agentes 12.x. Conectores personalizados do Connector SDK também podem precisar de atualizações.

Atualizações de plug-in para agentes privados 12.x

Se você usar qualquer um dos seguintes plug-ins, deve substituir qualquer uso existente dos plug-ins incompatíveis pelas novas versões necessárias para 12.x, ou as operações usando esses plug-ins começarão a falhar quando você atualizar o agente:

As versões de plug-in necessárias são compatíveis com versões anteriores com agentes 11.x, portanto você pode atualizar os plug-ins antes da atualização do agente. Para atualizar um plug-in, siga estas etapas:

1. Associe a nova versão do plug-in ao grupo de agentes privados no Console de Gerenciamento, página Customizações > Plug-ins.
2. Desatribua o plug-in incompatível da atividade em seus projetos do Studio ou Design Studio.
3. Atribua a nova versão compatível.
4. Teste e implante a operação.

Verificação de conectores personalizados para agentes privados 12.x

Conectores personalizados criados por terceiros usando o Connector SDK podem precisar de alterações para serem compatíveis com agentes privados 12.x. Você deve verificar a compatibilidade de conectores personalizados antes de atualizar agentes privados para 12.x.

Instruções de atualização

Para atualizar um agente privado no Windows, siga estas etapas:

1. Baixe um pacote instalador.

2. Se o agente ainda estiver processando operações, pause-o com drenagem.

   Ou, se você tiver certeza de que nada está em execução no agente, interrompa-o com drenagem.

3. Monitore o arquivo de log do agente. Continue quando todas as operações tiverem concluído o processamento.

4. Faça cópias de backup dos seguintes arquivos:

   Local	Arquivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos os arquivos .conf
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos os arquivos .crt
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos os arquivos .key

5. Faça uma cópia de backup da seguinte entrada de registro:

   HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Jitterbit Tomcat Server\Parameters\Java
   

6. (Opcional) Durante o período de sincronização de ambiente, os agentes não aceitarão operações de projeto de integração para processamento. Você pode minimizar o impacto desse tempo de inatividade com uma abordagem de atualização contínua.

7. Execute o instalador:

   Instalador padrãoInstalador silencioso

   Execute o instalador padrão baixado e responda aos prompts do assistente InstallShield.

   Prompts do PostgreSQL e comportamento durante a atualização

   • Se o instalador solicitar a senha da conta de serviço do Windows jitterbitpostgres e você não a souber, você pode cancelar o instalador. A instalação do agente existente não é afetada. Redefina a senha da conta de serviço jitterbitpostgres antes de tentar novamente a atualização.
   • A partir do agente 12.5, se UseInternalPooling não estiver já definido em jitterbit.conf, o instalador solicita: Deseja ativar o pool interno para otimizar e melhorar o desempenho do agente privado Jitterbit? Selecionar Sim adiciona UseInternalPooling=true à seção [DbInfo]. Selecionar Não deixa a chave indefinida (desativada). Se UseInternalPooling já estiver definido, o instalador não altera seu valor.
   • Se o PostgreSQL foi instalado anteriormente em um local personalizado, a atualização ainda instala a nova versão do PostgreSQL no local padrão (C:\Program Files\PostgreSQL\<VERSION>\), em vez do local personalizado existente.

   Siga as etapas de instalação para o instalador silencioso, mas no arquivo silent_install64.ps1, defina KO_INSTALL_MODE=0.

   O agente inicia automaticamente.

8. (Opcional) Se você estiver fazendo uma atualização contínua com o valor de propriedade agent.starting.standby=true e, antes de atualizar outro agente no mesmo grupo, monitore o arquivo de log do agente para a seguinte mensagem:

   Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
   

   Esta mensagem indica que o agente concluiu a sincronização de ambiente. Quando ela aparecer, edite jitterbit-agent-config.properties novamente, delete a propriedade agent.starting.standby (ou defina-a como false) e reinicie o agente.

9. Compare os seguintes arquivos com suas cópias de backup e restaure as configurações alteradas:

   Local	Arquivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos os arquivos .conf

   Dica

   Use uma ferramenta de comparação e mesclagem, como WinMerge.

10. Se você tiver arquivos de backup .crt ou .key que ainda não estão em C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\ ou C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\ respectivamente, copie-os para esses locais.

11. Interrompa e inicie o agente.

Desinstalar

Para desinstalar completamente um agente privado e seu servidor de banco de dados PostgreSQL, siga estas etapas:

1. Interrompa o agente.

2. Faça cópias de backup dos seguintes arquivos:

   Local	Arquivo
   C:\Program Files\Jitterbit Agent\	jitterbit.conf
   C:\Program Files\Jitterbit Agent\	JdbcDrivers.conf
   C:\Program Files\Jitterbit Agent\Resources\	jitterbit-agent-config.properties
   C:\Program Files\Jitterbit Agent\apache\conf\	httpd.conf
   C:\Program Files\Jitterbit Agent\apache\conf\extra\	Todos os arquivos .conf
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos os arquivos .crt
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos os arquivos .key

3. Desinstale os seguintes programas:

   • Jitterbit Agent: O software do agente privado Jitterbit.

   • PostgreSQL: O servidor de banco de dados PostgreSQL do agente privado. (A versão depende da versão do agente privado.)

   • psqlodbc: O driver de banco de dados ODBC do PostgreSQL.

4. Exclua a conta de usuário do serviço PostgreSQL do Jitterbit:

   Exemplo de comando PowerShell

   net user /delete jitterbitpostgres
   

5. (Opcional) Exclua os serviços do Jitterbit:

   sc delete Jitterbit Apache Server
   sc delete Jitterbit Cleanup
   sc delete Jitterbit Process Engine
   sc delete Jitterbit Scheduler
   sc delete Jitterbit Tomcat Server
   sc delete JitterbitPgbouncer
   sc delete Jitterbit-Verbose-Log-Shipper
   

6. Reinicie o Windows.

7. Exclua o diretório de dados do PostgreSQL C:\Program Files\PostgreSQL\<VERSION>\data para a versão do banco de dados desinstalada.

8. (Opcional) Exclua o diretório inicial da conta de serviço C:\Users\jitterbitpostgres.

9. (Opcional) Exclua as seguintes chaves no editor do Registro do Windows:

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL

   • HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL Global Development Group

Gerenciar

Um agente privado é gerenciado por meio de entradas no menu Iniciar do Microsoft Windows, ou com comandos inseridos em um prompt de comando. Você também pode usar o Console de Gerenciamento para interromper um agente remotamente, mas só pode reiniciá-lo novamente no host ou reiniciando o host.

Iniciar

Um agente privado inicia automaticamente com o host.

Para iniciar um agente, use uma destas opções:

• No menu Iniciar do Microsoft Windows, selecione Jitterbit Agent > Start Jitterbit Services.

• Em um prompt de comando, execute este comando:

  "C:\Program Files\Jitterbit Agent\StartServices.bat"
  

Parar

Existem três maneiras de parar um agente privado, cada uma diferindo em como as operações em execução são tratadas:

• Pausa com drenagem: o agente rejeita novas operações e permite que as operações em execução continuem até a conclusão.

• Parada com drenagem: o agente rejeita novas operações e permite que as operações em execução continuem por um período de tempo limite configurável, controlado por agent.drain.stop.database.poll.no.of.retries e agent.drain.stop.database.poll.interval.in.millisec (por padrão, 100 sondagens em intervalos de 10.000 ms). Operações baseadas em API recebem até agent.drainstop.api.wait (por padrão, 180 segundos). Após o tempo limite, qualquer operação que não tenha sido concluída é cancelada e seu status é sincronizado com a nuvem antes do agente desligar. Se as operações forem operações agendadas, elas serão automaticamente recriadas em outro agente do grupo (no caso de múltiplos grupos de agentes) ou definidas para serem recriadas no agente quando ele retomar (no caso de grupos de agente único).

• Parada forçada: o agente rejeita novas operações, encerra as operações em execução e as marca como canceladas. Se as operações forem operações agendadas, elas serão automaticamente recriadas em outro agente do grupo (no caso de múltiplos grupos de agentes) ou definidas para serem recriadas no agente quando ele retomar (no caso de grupos de agente único).

  Aviso

  Parar um agente privado de forma forçada pode resultar em perda de dados.

É necessário iniciar um agente privado parado fazendo login no servidor e executando um comando, ou reiniciando o host. Agentes não podem ser iniciados remotamente.

Se o agente foi iniciado com registro automático, ele é automaticamente desregistrado quando parado.

Pausa com drenagem

Para fazer uma pausa com drenagem em um agente privado no Windows, execute o seguinte comando em um prompt de comando:

"C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-pause

No Console de Gerenciamento, o status é exibido como Parando.

Para retomar um agente pausado no Windows, use o comando Iniciar.

Parada com drenagem

Durante uma parada com drenagem, o agente rejeita novas operações e permite que as operações em execução continuem por um período de tempo limite configurável, controlado por agent.drain.stop.database.poll.no.of.retries e agent.drain.stop.database.poll.interval.in.millisec (por padrão, 100 sondagens em intervalos de 10.000 ms). Operações baseadas em API recebem até agent.drainstop.api.wait (por padrão, 180 segundos). Após o tempo limite, qualquer operação que não tenha sido concluída é cancelada e seu status é sincronizado com a nuvem antes do agente desligar.

Para fazer uma parada com drenagem em um agente, use uma destas opções:

• No menu do Harmony Portal, selecione Console de Gerenciamento > Agentes. Na coluna Ação do agente a ser parado, selecione Ação > Parada com Drenagem e clique em OK na caixa de diálogo de confirmação.

• Em um prompt de comando, execute o seguinte comando:

  "C:\Program Files\Jitterbit Agent\bin\JitterbitUtils.exe" --drain-stop
  

Parada forçada

Para fazer uma parada forçada em um agente, use uma destas opções:

• No menu Iniciar do Microsoft Windows, selecione Jitterbit Agent > Parar Serviços Jitterbit.

• Em um prompt de comando, execute este comando:

  "C:\Program Files\Jitterbit Agent\StopServices.bat"
  

Pausar

Um agente privado pode ser pausado. Neste estado, o agente conclui qualquer operação sendo processada e não processa operações adicionais. No Console de Gerenciamento, o status é exibido como Parando.

Para pausar um agente privado no Microsoft Windows, execute este comando em um prompt de comando:

JitterbitUtils.exe --drain-pause

Para retomar um agente pausado no Microsoft Windows, use o comando Start.

Status

Para ver o status do agente, use uma destas opções:

• No menu do Harmony Portal, selecione Management Console > Agents.

• Procure pelos seguintes serviços no utilitário Computer Management do Microsoft Windows, ou em um prompt de comando com sc.exe query "<SERVICE>":

  • Jitterbit Apache Server

  • Jitterbit Cleanup

  • Jitterbit Process Engine

  • Jitterbit Scheduler

  • Jitterbit Tomcat Server

  • JitterbitPgBouncer

  • JitterbitVerboseLogShipper (nome do serviço Jitterbit-Verbose-Log-Shipper)

Troubleshooting

Estas seções na página Troubleshoot podem ajudar ao solucionar problemas de instalações de agentes privados no Windows:

• Agent offline or unreachable

• Agent showing different versions or IP addresses

• Connection, websocket, and I/O errors on Jitterbit private agents using Azure VMs

• IPv6 issue on Windows

• Apache Server error: No installed ConfigArgs

• PostgreSQL service removed after failed upgrade on Windows

• Error 1720 or 1722 on Windows installation

• TFA prevents 64-bit Windows agent installation

• TranDb connection failures

• Recover a failed Windows installation

• Cleanup service cannot remove locked log files on Windows