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, em seguida, siga os passos nas seções Baixar 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 reabilitar 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 agentes privados não registrados no grupo de agentes, um será criado automaticamente com um nome que inclui o nome e o endereço IP do host.

• Um servidor de banco de dados PostgreSQL é instalado automaticamente. Para usar o seu, você deve configurá-lo antes de instalar o agente privado e ter pronto 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 compressão e a criptografia do Windows nas seguintes pastas:

  Descrição	Localização padrão
  Pasta do agente privado	C:\Program Files\Jitterbit Agent\
  Pasta temporária do sistema	C:\Windows\Temp\
  Pasta de dados do PostgreSQL	C:\PostgreSQL\14\data\ (Agente Privado 11, versão 11.0 e superior.)
  	C:\PostgreSQL\9.6\data\ (Agente Privado 10, versão 10.37 e superior.)

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

Baixar

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

Baixe um dos seguintes pacotes do agente privado para Windows:

• Windows (x64): (Recomendado) O pacote de instalação padrão (.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.

• Instalador Silencioso do Agente para Windows (x64): O instalador silencioso (.zip). Este usa um arquivo de configuração para permitir a instalação não assistida.

Executar instalador

Siga os passos para o tipo de instalador:

Se os valores configurados estiverem corretos, a instalação prossegue sem mais intervenções, 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 mais informações.

Upgrade

Você deve parar e reiniciar um agente para atualizações de versão menores (11.x para 11.y, ou 10.x para 10.y) e atualizações de versão maior (10 para 11). Atualizações de versão maior também requerem uma desinstalação completa e reinstalação, e uma sincronização completa dos ambientes.

Se você tiver dois ou mais agentes em um grupo de agentes, recomenda-se atualizá-los um de cada vez, para que seus projetos de integração sempre tenham pelo menos um agente para processar operações. Se você tiver apenas um agente no grupo, as operações ficam na fila em Status Pendente até que o agente esteja online e pronto para processá-las.

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

1. Baixe um pacote de instalador.

2. Se o agente ainda estiver processando operações, pause o dreno.

   Ou, se você tiver certeza de que nada está sendo executado no agente, pare o dreno.

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

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

   Localização	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. (Opcional) Durante o período de sincronização do ambiente, os agentes não aceitarão operações de projetos de integração para processamento. Você pode minimizar o impacto desse tempo de inatividade com uma abordagem de atualização contínua.

   Para fazer isso, abra o arquivo jitterbit-agent-config.properties para edição e adicione ou defina a propriedade agent.starting.standby=true. (Isso mantém o agente no status Iniciando e impede que ele processe operações até que o valor da propriedade seja definido como false.)

6. Execute o instalador:

   Instalador padrãoInstalador silencioso

   Execute o instalador padrão baixado e responda às solicitações do assistente InstallShield.

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

   O agente inicia automaticamente.

7. (Opcional) Se você estiver realizando uma atualização gradual com o valor da 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:

   Sincronização do agente para o ambiente <123456> e ID do grupo de agentes <987654> concluída em ...
   

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

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

   Localização	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.

9. Se você tiver arquivos de backup .crt ou .key que 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.

10. Parar e iniciar o agente.

Desinstalar

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

1. Parar o agente.

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

   Localização	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 desinstalado.

8. (Opcional) Exclua o diretório home 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 parar 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 das seguintes opções:

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

• 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 com uma abordagem diferente em relação às operações em execução:

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

• Parada de drenagem: o agente rejeita novas operações e permite que as operações em execução continuem até a conclusão por um período definido pelo parâmetro agent.drainstop.api.wait (por padrão, 180 segundos).

• Parada forçada: o agente rejeita novas operações e termina as operações em execução.

  Atenção

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

Você deve 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 de drenagem

Para pausar a drenagem de um agente privado no Windows, execute o seguinte comando em um prompt de comando:

```bat
"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 de drenagem

Para parar a drenagem de um agente, use uma das seguintes opções:

• No menu do Portal Harmony, selecione Console de Gerenciamento > Agentes. Na coluna Ação do agente a ser parado, selecione Ação > Parada de 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 parar forçadamente um agente, use uma das seguintes 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. Nesse estado, o agente finaliza quaisquer operações que estão sendo processadas atualmente e não processa mais operações. 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 Iniciar.

Status

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

• No menu do Portal Harmony, selecione Console de Gerenciamento > Agentes.

• Procure os seguintes serviços na ferramenta Gerenciamento do Computador do Microsoft Windows, ou em um prompt de comando com sc.exe query "<SERVICE>":

  • Servidor Apache Jitterbit

  • Limpeza Jitterbit

  • Motor de Processos Jitterbit

  • Agendador Jitterbit

  • Servidor Tomcat Jitterbit

  • JitterbitPgBouncer

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

Solução de Problemas

Estas seções na página de Solução de Problemas podem ajudar ao solucionar instalações de agentes privados no Windows:

• Agente privado Jitterbit não está em execução, está parado ou inacessível.

• Agente privado Jitterbit mostrando versões ou IPs diferentes.

• Erros de conexão, websocket e I/O em agentes privados Jitterbit usando VMs Azure.

• Erro 1722 com agentes privados Jitterbit no Windows.

• Problema de IPv6 em agentes privados Jitterbit no Windows.

• Erro de Servidor Apache em agentes privados Jitterbit.

• Erros de PostgreSQL com agentes privados Jitterbit no Windows.

• Incapaz de instalar agentes privados Jitterbit de 64 bits no Windows com autenticação de dois fatores (TFA).

• Erro de slots de conexão com agentes privados Jitterbit de 64 bits no Windows.

• Recuperar uma instalação de agente privado com falha no Windows.