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 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 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\*\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á 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 do Agente Silencioso 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

As versões do agente privado utilizam 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 upgrades:

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

• Secundário: Quando você atualiza de 10.x → 10.y, 11.x → 11.y, ou 12.x → 12.y, é um upgrade de versão secundária. Nesses casos, você só precisa parar e reiniciar o agente.

  Atualizações de 11.48 e anteriores para 11.49+ incluem atualizações necessárias do conector

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

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

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

Atualizações de plugins são necessárias para usar os plugins Multipart Pipeline ou AWS S3 Create em agentes 12.x. Conectores do SDK de Conector Personalizado também podem precisar de atualizações.

Atualizações de plugins para agentes privados 12.x

Se você usar qualquer um dos seguintes plugins, deve substituir quaisquer usos existentes dos plugins incompatíveis pelas novas versões exigidas para 12.x, ou as operações que utilizam esses plugins começarão a falhar quando você atualizar o agente:

As versões de plugin exigidas são compatíveis com agentes 11.x, portanto, você pode atualizar os plugins antes da atualização do agente. Para atualizar um plugin, siga estas etapas:

1. Associe a nova versão do plugin ao grupo de agentes privados no Console de Gerenciamento página Personalizações > Plugins.
2. Desassocie o plugin 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 construídos por terceiros usando o SDK de Conector podem precisar de alterações para serem compatíveis com agentes privados 12.x. Você deve verificar a compatibilidade do conector personalizado antes de atualizar os agentes privados para 12.x.

Instruções de atualização

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 a drenagem.

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

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. Faça uma cópia de backup da seguinte entrada do registro:

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

6. (Opcional) Durante o período de sincronização do 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 às solicitações do assistente InstallShield.

   Nota

   Se o instalador solicitar a senha da conta de serviço do Windows jitterbitpostgres e você não souber, pode cancelar o instalador. A instalação existente do agente não será afetada. Redefina a senha da conta de serviço jitterbitpostgres antes de tentar a atualização novamente.

   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.

8. (Opcional) Se você estiver fazendo uma atualização contínua 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 concluiu 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.

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

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

11. Pare e inicie o agente.

Desinstalar

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

1. Pare 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 ODBC do banco de dados 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 para as 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), momento em que são marcadas como canceladas. Se as operações forem operações agendadas, elas são automaticamente recriadas em outro agente no grupo (no caso de múltiplos grupos de agentes), ou definidas para serem recriadas no agente quando ele retomar (no caso de grupos de agentes únicos).

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

  Cuidado

  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 drenar a pausa de 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.

Drenar parada

Para drenar a parada 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 > Drenar Parada, 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 forçar a parada de 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. Neste estado, o agente conclui 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 de Computador do Microsoft Windows, ou em um prompt de comando com sc.exe query "<SERVICE>":

  • Servidor Apache Jitterbit

  • Limpeza Jitterbit

  • Motor de Processos Jitterbit

  • Jitterbit Scheduler

  • Jitterbit Tomcat Server

  • 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 ou 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 do Servidor Apache em agentes privados Jitterbit.

• Serviço PostgreSQL removido após falha na atualização no Windows.

• Erros do 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 que falhou no Windows.