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

Uma atualização de agente privado de versão secundária (10.x para 10.y ou 11.x para 11.y) requer que o agente seja parado e reiniciado.

Para uma atualização de versão principal (10.x para 11.y), você deve desinstalar e reinstalar o agente privado, o servidor de banco de dados PostgreSQL e o driver de banco de dados PostgreSQL. Você também deve fazer backup e restaurar manualmente os arquivos de configuração do agente privado.

Atualização de versão secundária

Para uma atualização de versão secundária, siga estas etapas:

1. Download um pacote instalador.

2. Parar o agente.

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

4. (Opcional) Se você precisar atualizar outros agentes no mesmo grupo, você pode minimizar o impacto do tempo de inatividade do agente usando 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.)

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

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

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

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

9. Parar e início o agente.

Atualização da versão principal

Para uma atualização de versão principal, siga estas etapas:

1. Download um pacote instalador.

2. Parar o agente.

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

4. Desinstale os seguintes programas:

   • Agente Jitterbit: O software agente privado Jitterbit.
   • PostgreSQL 9.6: O servidor de banco de dados PostgreSQL do agente privado.
   • psqlodbc: O driver de banco de dados ODBC do PostgreSQL.

5. (Opcional) Exclua o diretório de dados do PostgreSQL C:\Program Files\PostgreSQL\9.6\data.

6. Instalar o novo agente privado. O agente inicia automaticamente.

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

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

9. 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. Reinicie o Windows.

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

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

8. (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 parado, 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.