Configurar um Agente Privado Linux¶

Visão Geral¶

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

Para obter informações adicionais sobre Linux Agentes Privados, consulte estes recursos:

Para obter documentação sobre como realizar determinadas tarefas com Harmony Agentes Privados, consulte Como Tutoriais para Agente Privado.

Para obter documentação sobre como superar desafios com Harmony Agentes Privados, consulte Solução de problemas de Agente Privado.

Importante

Os Harmony Agentes Privados instalados em servidores Microsoft Azure exigem um intervalo de pulsação do agente reduzido.

Configurando um Agente¶

Os Harmony Agentes Privados 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, Agente e ambiente correspondentes tenham sido criados usando o Harmony Management Console. O script de configuração fornecerá uma lista de agentes que você pode configurar. Se você ainda não os configurou, consulte a documentação em Agentes > Grupos de Agente e Agentes > Agentes.

Iniciar o Harmony Agente Privado 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:

Suas credenciais do Harmony (o endereço e-mail e a senha que você usa para fazer login no Portal Harmony).

Cuidado

Se sua organização e conta usarem login único (SSO), suas credenciais normais de SSO não funcionarão. Você deve usar credenciais Harmony para instalar Agente Privado(s). Consulte Instalando um Agente Privado em Registrando e fazendo login usando o Harmony SSO Para maiores informações.
O nome da organização para a qual você está instalando o agente.

Nota

Você deve ser membro de uma papel organizacional que tenha permissões Admin ou Agent-Install. Consulte Organizações e a seção sobre Gerenciamento de permissões, funções e membros Para maiores informações.
O nome do Grupo de Agentes ao qual o agente será atribuído.
O nome do agente no qual você está instalando.

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 tenha efeito. Para obter informações sobre como reiniciar um Agente Privado, consulte Reiniciando um Agente Privado Linux.

Opções de Configuração Avançada¶

Usando SELinux¶

O processo de instalação do Harmony Agente Privado adicionará uma configuração SELinux que permite que o Harmony Agente Privado seja instalado em kernels SELinux. No entanto, pode interferir no banco de dados do Harmony Agente Privado (PostgreSQL). Se você não conseguir instalar e configurar com êxito o Harmony Agente Privado, você deverá 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.

Configurando o PostgreSQL¶

O Harmony Agente Privado inclui um banco de dados PostgreSQL incluído na instalação. A instância do banco de dados é criada durante a instalação e configurada para execução 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 da 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 a versão 9.6.x.

Você pode configurar o Harmony Agente Privado 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 usar como padrão o driver PostgreSQL incluído na distribuição Linux.

Reconfigurando o Agente Privado Harmony¶

Você pode configurar um Agente Privado Harmony existente para ser executado como um agente diferente (como em um Grupo de Agentes diferente). Para fazer isso, você deve interromper os serviços, reinicializar o banco de dados do Harmony Agente Privado e executar o script de configuração novamente. Use estes 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 Harmony Agente Privado for reiniciado, ele será automaticamente sincronizado para poder processar todas as operações atendidas pelo novo Grupo de Agentes.

Adicionando Certificados ao Keystore de Agente Privado¶

Os Agentes Privados Harmony 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 a comunicação segura.

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 originados do servidor proxy que precisem ser incluídos no repositório de chaves do Agente Privado podem ser incluídos para permitir que o Agente Privado se comunique com segurança por meio do servidor proxy.

Para configurar o Harmony Agente Privado para usar um servidor proxy, consulte Ativando proxy para Agentes Privados.

Java KeyStore (JKS): Agentes Privados usam o repositório Java KeyStore (JKS) padrão fornecido com Java como o repositório de todos os certificados. O repositório de chaves é denominado "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 por <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 Keystore para Agentes Privados.

Usando Software Antivírus¶

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

Próximos Passos¶

Para obter informações adicionais sobre Linux Agentes Privados, consulte estes recursos:

Para obter documentação sobre como realizar determinadas tarefas com Harmony Agentes Privados, consulte Como Tutoriais para Agente Privado.

Para obter documentação sobre como superar desafios com Harmony Agentes Privados, consulte Solução de problemas de Agente Privado.