Agentes privados Jitterbit no Microsoft Windows

Introdução

Esta página mostra como instalar e executar um agente privado no Microsoft Windows. O Solucionar problemas fornece uma lista de problemas comuns e suas soluções.

Instalar

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

Pré-requisitos

Você deve ter o seguinte:

• Um hospedar que atenda aos requisitos do sistema.

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

• Nome da sua organização Harmony.

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

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

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

Os seguintes são opcionais:

• Adicionar um agente no Management Console. 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, você deve configurá-lo antes de instalar o agente privado e ter pronto seu nome ou endereço IP, seu número de porta e os detalhes da conta do administrador do banco de dados.

Recomenda-se o seguinte:

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

  Descrição	Localização padrão
  Pasta de 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 a configuração de ajuste de desempenho guia.

Download

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

Baixe um dos seguintes pacotes do agente privado do Windows:

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

• Instalador do Windows Quiet Agente (x64): O instalador silencioso (.zip arquivo). Isso usa um arquivo de configuração para permitir instalação autônoma.

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 inicia. Você pode verificar seu status no Management Console ou observando o arquivo de log C:\Program Files\Jitterbit Agent\log\jitterbit-agent.log.

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

Atualizar

Você deve parar e reiniciar um agente para atualizações de versão secundária (11.x para 11.y ou 10.x para 10.y) e principal (10 para 11). As atualizações de versão principal também exigem uma desinstalação completa) e reinstalar, e uma sincronização completa de ambientes.

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

1. Baixar um pacote instalador.

2. Se o agente ainda estiver processando operações, drenar pausa isso.

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

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:

   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 .conf arquivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos .crt arquivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos .key arquivos

5. (Opcional) Durante a 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.

   Para fazer isso, abra jitterbit-agent-config.properties arquivo para edição e adicionar ou definir a propriedade agent.starting.standby=true. (Isso mantém o agente no status Iniciando e o impede de processar 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 aos prompts do assistente do InstallShield.

   Siga o install etapas para o instalador silencioso, mas no silent_install64.ps1 arquivo, conjunto KO_INSTALL_MODE=0.

   O agente inicia automaticamente.

7. (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:

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

   Esta mensagem indica que o agente concluiu a sincronização do ambiente. Quando aparecer, edite jitterbit-agent-config.properties novamente, exclua a propriedade agent.starting.standby(ou defina-o para false), então 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 .conf arquivos

   Dica

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

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

10. Parar e início 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 segurança 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 .conf arquivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.crt\	Todos .crt arquivos
   C:\Program Files\Jitterbit Agent\apache\conf\ssl.key\	Todos .key arquivos

3. Desinstale os seguintes programas:

   • Agente Jitterbit: O software 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 Jitterbit PostgreSQL:

   Example PowerShell command

   net user /delete jitterbitpostgres
   

5. (Opcional) Exclua os serviços 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 desinstalada do banco de dados.

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

9. (Opcional) Exclua as seguintes chaves no editor de 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 Management Console para parar um agente remotamente, mas só pode reiniciá-lo novamente no hospedar ou reiniciando o hospedar.

Começar

Um agente privado inicia automaticamente com o hospedar.

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

• No menu Iniciar do Microsoft Windows, selecione Jitterbit Agente > Iniciar 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:

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

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

• Parada brusca: o agente rejeita novas operações e encerra as operações em execução.

  Cuidado

  Parar bruscamente um agente privado pode resultar em perda de dados.

Você deve iniciar um agente privado parado efetuando login no servidor e executando um comando, ou reiniciando o hospedar. Os agentes não podem ser iniciados remotamente.

Se o agente começou com registro automático, ele é automaticamente desregistrado quando parado.

Pausa de drenagem

Para pausar 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 Management Console, o status é exibido como Parando.

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

Parada de drenagem

Para interromper o esgotamento de um agente, use uma destas opções:

• No menu do Harmony Portal, selecione Management Console > Agents. Na coluna Action do agente a ser interrompido, selecione Action > Drain Stop 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 brusca

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

• No menu Iniciar do Microsoft Windows, selecione Jitterbit Agente > Parar serviços Jitterbit.

• Em um prompt de comando, execute este comando:

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

Pausa

Um agente privado pode ser pausado. Nesse estado, o agente finaliza todas as operações que estão sendo processadas no momento e não processa mais operações. No Management Console, o status é exibido como Stopping.

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 Iniciar comando.

Status

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

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

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

  • Servidor Apache Jitterbit

  • Limpeza Jitterbit

  • Mecanismo de Processo Jitterbit

  • Agendador Jitterbit

  • Servidor Tomcat Jitterbit

  • JitterbitPgBouncer

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

Solucionar problemas

Estas seções na página Solução de problemas pode ajudar na solução de problemas de instalações de agentes privados no Windows:

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

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

• Erros de conexão, websocket e E/S em agentes privados Jitterbit usando VMs do Azure.

• Erro 1722 com agentes privados do Windows Jitterbit.

• Problema de IPv6 em agentes privados do Windows Jitterbit.

• Erro do Apache Server em agentes privados Jitterbit.

• Erros do PostgreSQL com agentes privados do Windows Jitterbit.

• Não é possível instalar agentes privados do Windows Jitterbit de 64 bits com autenticação de dois fatores (TFA).

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

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