Agentes privados Jitterbit no Linux

Introdução

Esta página mostra como instalar e executar um agente privado no Linux. 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, Executar instalador e Configurar 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.

• Uma conta com privilégios de root. Use-a para todas as ações nesta página.

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:

• 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 de agente privado Linux:

• Linux Debian (x64): O .deb arquivo de pacote, para instalação no Debian ou Ubuntu Linux como root.

• Linux RPM: O .rpm arquivo de pacote, para instalação no Red Hat Linux como root.

• Linux Redhat não root (x64): O .tar arquivo, que pode ser descompactado no Red Hat Linux por um usuário não root.

Executar instalador

Em um terminal, execute os seguintes comandos para o tipo de instalador baixado:

apt-get install <PATH>/jitterbit-agent_<VERSION>_amd64.deb
update-alternatives --install /usr/bin/python python /usr/bin/python2 1

yum install <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
alternatives --set python /usr/bin/python2

yum install python2 tar unixODBC unzip
alternatives --set python /usr/bin/python2
useradd -U jitterbit -b /opt -G wheel
passwd jitterbit
# Set a password

. scripts/set.env.sh scripts/install.sh ```

Configurar

Para configurar, registrar e reiniciar um agente privado no Linux, siga estas etapas:

1. Execute este comando:

   jitterbit-config
   

   Para permitir que o agente se comunique por meio de um servidor proxy, adicione as opções necessárias.

2. Quando solicitado, digite seu nome de usuário e senha da conta Harmony e selecione as opções correspondentes à sua organização, grupo de agentes e agente.

   Se você instalou o tar pacote como o jitterbit usuário, digite y no seguinte prompt:

   Warning: this tool requires root privileges.
   Hint: Use sudo or log on as the root user.
   Do you want to continue as the current user?`[s/n]:`
   

3. Execute este comando:

   jitterbit restart
   

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 Linux, 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
   /opt/jitterbit/	jitterbit.conf
   /opt/jitterbit/	JdbcDrivers.conf
   /opt/jitterbit/Resources/	jitterbit-agent-config.properties
   /opt/jitterbit/apache/conf/	httpd.conf
   /opt/jitterbit/apache/conf/	*.crt
   /opt/jitterbit/apache/conf/	*.key
   /opt/jitterbit/apache/conf/extra/	*.conf
   /opt/jitterbit/jre/lib/security/	cacerts

5. Em um terminal, execute o seguinte comando para o tipo de instalador baixado:

   Linux Debian (x64)RPM Linux Linux Redhat não root (x64)

   apt-get upgrade <PATH>/jitterbit-agent_<VERSION>_amd64.deb
   

   yum upgrade <PATH>/jitterbit-agent-<VERSION>.x86_64.rpm
   

   as jitterbit

   tar -C /opt -xf <PATH>/jitterbit-agent-<VERSION>.x86_64.tar
   

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

   Localização	Arquivo
   /opt/jitterbit/	jitterbit.conf
   /opt/jitterbit/	JdbcDrivers.conf
   /opt/jitterbit/Resources/	jitterbit-agent-config.properties
   /opt/jitterbit/apache/conf/	httpd.conf
   /opt/jitterbit/apache/conf/extra/	*.conf
   /opt/jitterbit/jre/lib/security/	cacerts

7. Se você tiver backup .crt ou .key arquivos que ainda não estão em /opt/jitterbit/apache/conf/, copie-os para esse local.

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

9. Reinicie o agente:

   jitterbit restart
   

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

Desinstalar

Para desinstalar um agente privado no Linux, siga estas etapas:

1. Parar o agente.

2. (Opcional) Faça cópias de segurança dos seguintes arquivos:

   Localização	Arquivo
   /opt/jitterbit/	jitterbit.conf
   /opt/jitterbit/	JdbcDrivers.conf
   /opt/jitterbit/Resources/	jitterbit-agent-config.properties
   /opt/jitterbit/apache/conf/	httpd.conf
   /opt/jitterbit/apache/conf/	*.crt
   /opt/jitterbit/apache/conf/	*.key
   /opt/jitterbit/apache/conf/extra/	*.conf
   /opt/jitterbit/jre/lib/security/	cacerts

3. Para remover os arquivos de instalação (incluindo o PostgreSQL e seu diretório de dados), o arquivo de inicialização do serviço e o jitterbit conta de usuário, execute estes comandos:

   Linux Debian (x64)RPM Linux Linux Redhat não root (x64)

   apt-get remove --autoremove jitterbit-agent
   userdel --remove --force jitterbit
   

   yum remove jitterbit-agent
   userdel --remove --force jitterbit
   

   as root or with sudo

   yum remove python2 tar unixODBC unzip
   userdel --remove --force jitterbit
   

Gerenciar

Você pode começar, parar, e mostrar o status de um agente privado com o jitterbit comando. Você também pode usar o Management Console para parar um agente remotamente, mas só pode reiniciá-lo novamente em um terminal no hospedar. Exceto para instalações não root, você também pode reiniciar o agente reiniciando o hospedar.

Os agentes começaram com registro automático cancela o registro automaticamente quando parado.

Começar

Agentes privados instalados a partir de um .deb ou .rpm arquivo de pacote inicia automaticamente com o hospedar. Para não-root .tar instalações de arquivo, você deve adicionar um script de sistema para iniciar o agente ou iniciá-lo manualmente.

Para iniciar um agente privado no Linux, execute este comando:

jitterbit start

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.

Pausa de drenagem

Para pausar um agente privado no Linux, execute o seguinte comando em um terminal:

jitterbit-utils --drain-pause

No Management Console, o status é exibido como Parando.

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

Parada de drenagem

Para interromper o esgotamento de um agente privado no Linux, 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 terminal, execute o seguinte comando:

  jitterbit-utils --drain-stop
  

Parada brusca

Para interromper um agente privado no Linux, execute este comando:

jitterbit stop

Status

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

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

• Em uma sessão de terminal, execute este comando:

  jitterbit status
  

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 Linux:

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