Ir para o conteúdo

Configurar um agente privado Linux

Visão geral

Estas são as instruções sobre como configurar um agente privado Linux em distribuições Debian e RPM Linux.

Para obter informações adicionais sobre agentes privados do Linux, consulte estes recursos:

Para obter documentação sobre como realizar determinadas tarefas com agentes privados Jitterbit, consulte Como tutoriais agentes privados.

Para documentação sobre como superar desafios com agentes privados Jitterbit, consulte Solução de problemas de agentes privados.

Importante

Os agentes privados Jitterbit instalados em servidores Microsoft Azure exigem um intervalo de pulsação do agente reduzido.

Configurar um agente

Os agentes privados Jitterbit não podem ser iniciados sem concluir a etapa de configuração.

Cuidado

Antes de executar o script de configuração, você deve garantir que o grupo de agentes, o agente e o ambiente correspondentes tenham sido criados no Management Console Agentes página. O script de configuração fornecerá uma lista de agentes que você pode configurar.

Iniciar o agente privado Jitterbit sem configurar resultará neste erro:

NOTE: Agent credentials have not been configured.
Run the Jitterbit configuration tool /opt/jitterbit/bin/jitterbit-config

Execute o script jitterbit-config e insira as informações necessárias no prompt:

$ sudo jitterbit-config

Você precisará destas informações:

  1. Suas credenciais Harmony (o endereço de email e a senha que você usa para fazer login no portal Harmony).

    Cuidado

    Se sua organização e conta usam logon único (SSO), suas credenciais normais de SSO não funcionarão. Você deve usar credenciais Harmony para instalar agentes privados.

  2. O nome da organização para a qual você está instalando o agente.

    Nota

    Você deve ser membro de uma papel que tenha permissões Admin ou Agent-Install.

  3. O nome do grupo de agentes ao qual o agente será atribuído.

  4. O nome do agente que você está instalando como.

    Nota

    O script exibirá a lista de agentes que não estão em execução.

Aqui está um exemplo de execução do script de configuração:

jitterbit-config
Please enter your Jitterbit Harmony user name
This is the email that you used to register on the Jitterbit Harmony platform
Enter your Jitterbit Harmony user name: john.doe@example.com
You entered: john.doe@example.com
Please enter your Jitterbit Harmony password:
There is only one organization available
Do you want to use 'Example, Inc'`[s/n]: `y
Select agent group:
[1] Agent Group 1
[2] Agent Group 2
Please select an agent group`[1-2]: `1
You selected: Agent Group 1
Select agent:
[1] Linux Agent 1
[2] Linux Agent 2
Please select an agent`[1-2]: `2
You selected: Linux Agent 2

Agent successfully configured
Restart your agent for the changes to take effect

Conforme observado no script, você deve reiniciar o agente privado para que a configuração entre em vigor. Para obter informações sobre como reiniciar um agente privado, consulte Reiniciar um agente privado Linux.

Opções de configuração avançadas

Usando SELinux

O processo de instalação do agente privado Jitterbit adicionará uma configuração SELinux que permite que o agente privado Jitterbit seja instalado em kernels SELinux. No entanto, ele pode interferir no banco de dados do agente privado Jitterbit (PostgreSQL). Se você não conseguir instalar e configurar com sucesso o agente privado Jitterbit, você deve desabilitar o SELinux.

Use este comando para verificar se o SELinux está habilitado:

$ /usr/sbin/sestatus

Para desabilitar o SELinux você deve editar o /etc/sysconfig/selinux arquivo para ler SELINUX=disabled e reinicie seu sistema.

Configurar PostgreSQL

O agente privado Jitterbit inclui um banco de dados PostgreSQL empacotado com a instalação. A instância do banco de dados é criada durante a instalação e é configurada para rodar na porta 46914.

A versão do banco de dados PostgreSQL existente deve corresponder à esperada pela versão do agente:

  • Para agentes privados Linux 11.0 e posteriores, um banco de dados PostgreSQL existente que é a versão 14.5-1 foi confirmado para funcionar. Espera-se que outras versões 14.x do PostgreSQL funcionem, mas não foram testadas.
  • Para agentes privados Linux 10.x que sejam pelo menos 10.37, o banco de dados PostgreSQL existente deve ser da versão 9.6.x.

Você pode configurar o agente privado Jitterbit para ser configurado em um banco de dados PostgreSQL separado executando o script de configuração com o -c opção:

$ sudo /opt/jitterbit/bin/jitterbit-config -c

Você precisará da configuração do PostgreSQL. Ao configurar o banco de dados PostgreSQL, um driver ODBC PostgreSQL-jitterbit está instalado. Recomendamos usar este driver e não o padrão para o driver PostgreSQL incluído com a distribuição Linux.

Reconfigurar o agente privado Jitterbit

Você pode configurar um agente privado Jitterbit existente para ser executado como um agente diferente (como em um grupo de agentes diferente). Para fazer isso, você deve parar os serviços, reinicializar o banco de dados do agente privado Jitterbit e executar o script de configuração novamente. Use esses comandos nesta sequência específica (observe que todos os comandos devem ser executados como root):

$ sudo jitterbit stop
$ sudo jitterbit initdb
$ sudo jitterbit-config
$ sudo jitterbit start

Assim que o agente privado Jitterbit for reiniciado, ele será sincronizado automaticamente para poder processar todas as operações atendidas pelo novo grupo de agentes.

Adicionar certificados ao repositório de chaves do agente privado

Os agentes privados Jitterbit usam HTTPS padrão para se comunicar com segurança pela internet. Todos os agentes privados são instalados com um repositório de chaves confiável contendo todos os certificados necessários para se comunicar com segurança.

Um novo certificado pode ser adicionado pelo usuário ao repositório de chaves do agente privado. A capacidade de adicionar um novo certificado é importante se um agente privado estiver configurado para usar um servidor proxy. Quaisquer certificados originários do servidor proxy que precisem ser incluídos no repositório de chaves do agente privado podem ser adicionados para permitir que o agente privado se comunique com segurança por meio do servidor proxy.

Para configurar o agente privado Jitterbit para usar um servidor proxy, consulte Habilitando proxy para agentes privados.

  • Java KeyStore (JKS): Agentes privados usam o repositório Java KeyStore (JKS) padrão empacotado com Java como o repositório de todos os certificados. O repositório de chaves é chamado de "cacerts" e, por padrão, está localizado em:

    /opt/jitterbit/jre/lib/security/cacerts

  • Senha Padrão: A senha padrão para o repositório de chaves do agente privado é a senha padrão para qualquer JKS, que é "changeit". Recomendamos que você altere a senha usando este comando, substituindo <new_storepass> com a nova senha:

    $ sudo /opt/jitterbit/jre/bin/keytool -storepasswd -new <new_storepass> -keystore /opt/jitterbit/jre/lib/security/cacerts

  • Lista de certificados: Este comando listará todos os certificados no repositório de chaves do agente privado:

    $ sudo /opt/jitterbit/jre/bin/keytool -list -keystore /opt/jitterbit/jre/lib/security/cacerts

  • Adicionar um novo certificado: Use este comando para adicionar um novo certificado ao repositório de chaves do agente privado, substituindo <alias> e <certfile>:

    $ sudo /opt/jitterbit/jre/bin/keytool -importcert -trustcacerts -alias <alias> -file <certfile> -keystore /opt/jitterbit/jre/lib/security/cacerts

  • Configurar um agente privado para não aceitar todos os certificados por padrão: Ao instalar um agente privado usando um servidor proxy, todos os certificados são aceitos por padrão para acelerar os processos de instalação e desenvolvimento. Se você não quiser aceitar todos os certificados por padrão, consulte as instruções em Configurar um agente privado para não aceitar todos os certificados por padrão em Adicionando certificados ao repositório de chaves para agentes privados.

Use software antivírus

É possível usar um software antivírus com um agente privado. Para isso, você deve excluir o \<JITTERBIT_HOME> e diretórios PostgreSQL localizados em /opt/jitterbit/.

Próximos passos

Para obter informações adicionais sobre agentes privados do Linux, consulte estes recursos:

Para obter documentação sobre como realizar determinadas tarefas com agentes privados Jitterbit, consulte Como tutoriais agentes privados.

Para documentação sobre como superar desafios com agentes privados Jitterbit, consulte Solução de problemas de agentes privados.