Ir para o conteúdo

Instale um Agente Privado Linux no Debian

Visão Geral

Estas são as instruções sobre como baixar e instalar o Harmony Agente Privado em um sistema Linux baseado em Debian. Antes da instalação, recomendamos revisar Alta disponibilidade e balanceamento de carga de grupos de Agente e Conversa técnica sobre práticas recomendadas para Agentes Privados.

Para obter informações sobre os requisitos do sistema, consulte Requisitos do sistema para Agentes Privados Linux.

Para obter informações sobre como configurar o Agente Privado Linux instalado, consulte Configurando um Agente Privado Linux.

Para sistemas Linux baseados em RPM, consulte Instalando um Agente Privado Linux em RPM.

Nota

A partir da versão 10.34 do Harmony, os Agentes Privados de 32 bits não estão mais disponíveis para download. Se você estiver usando um agente de 32 bits, atualize para um agente de 64 bits seguindo as instruções do Linux.

Pré-requisitos de Software

Comandos Necessários

Para instalar o jitterbit-agent pacote, estes comandos devem estar disponíveis:

Required Commands
python
sed
sudo
tar
unixodbc
unzip

Você pode testar a disponibilidade de um comando executando o which comando.

Nota

O usuário root em seu servidor deve ter acesso ao sudo comando.

Bibliotecas Necessárias

Os Agentes Privados Linux baseados em Debian requerem que estas bibliotecas sejam instaladas:

Required Libraries
libc.so.6
libgcc_s.so.1
libm.so.6
librt.so.1
libstdc++.so.6
libuuid.so.1
libz.so.1

Nota

As bibliotecas listadas e os pacotes que as contêm podem ter nomes diferentes dependendo da distribuição Linux usada.

Instalando Bibliotecas Necessárias

Para instalar as bibliotecas necessárias e atualizar os pacotes necessários nos sistemas operacionais Debian ou Ubuntu de 64 bits, execute estes comandos:

$ sudo apt-get update

# Required for Ubuntu 22.04:
$ sudo apt-get install odbcinst

# Required for all operating systems:
$ sudo apt-get install python2
$ sudo ln -s /usr/bin/python2.7 /usr/bin/python
$ sudo apt-get install libc6 libgcc1 libstdc++6 libuuid1 zlib1g unixodbc sed unzip tar

Solução de Problemas

Se a instalação de bibliotecas falhar com uma mensagem de que você quebrou pacotes (como libgcc1), você pode corrigir a instalação e continuar com estes comandos. Siga todas as instruções que você receber:

$ sudo apt --fix-broken install
$ sudo apt-get install libc6 libgcc1 libstdc++6 libuuid1 zlib1g unixodbc python sed sudo unzip tar

Erros GLIBC: Se você não conseguir instalar devido a "GLIBC_2.14 not found"em certos sistemas mais antigos, edite /etc/apt/sources.list e adicione esta linha:

$ deb http://ftp.debian.org/debian/ jessie main

Então corra:

$ sudo apt-get update
$ sudo apt-get -t experimental install libc6-dev

# Check that GLIBC is greater than or equal to 2.14:
$ ldd --version

Dependência quebrada ou ausente: Se você tiver uma biblioteca com uma dependência quebrada ou ausente, verifique se há links adequados para a fonte usando o comando ldd comando para retornar uma lista de dependências. Por exemplo:

$ ldd /opt/jitterbit/lib/libkonga-zip.so

Você também pode usar o nome do pacote para verificar o status de instalação da dependência, usando a mesma convenção de nomenclatura da instalação:

$ dpkg -s zlib1g

Baixando o Agente Privado Linux

Estas instruções sobre como baixar um Agente Privado Linux pressupõem que você já criou um Grupo de Agentes, Agente(s) e um ambiente para sua organização no Management Console. Consulte Agentes > Grupos de Agente e Agentes > Agentes Para maiores informações.

  1. Faça login no Portal Harmony e vá para o Management Console > Agentes > Grupos de Agente.
  2. Na parte superior da tela, selecione a linha Grupo de Agentes. A metade inferior da tela agora deve listar os Agentes Disponíveis dentro do Grupo de Agentes selecionado.
  3. Na parte inferior da tela, selecione a linha do agente. Em seguida, clique no menu suspenso Ação na extrema direita e selecione Baixar para Linux DEB.
  4. O executável do agente Linux pode ser baixado uma vez, armazenado localmente e reutilizado para instalar quaisquer Agentes Privados adicionais à medida que forem adicionados.

Instalando um Agente

Todos os comandos de instalação requerem acesso root. Recomendamos usar uma linha de comando para instalação, pois a instalação gera mensagens importantes.

Nota

O usuário root em seu servidor deve ter acesso ao sudo comando.

Para instalar um Agente Privado usando um sistema operacional Linux baseado em Debian, siga estas etapas:

  1. Use este comando para navegar até o diretório onde o download do Agente Privado está localizado:

    $ sudo cd <DIRECTORY>
    
  2. Use isto dpkg comando para instalar o pacote Debian:

    $ dpkg --install jitterbit-agent_<VERSION>_amd64.deb
    

    Se o comando falhar devido à falta de dependências, o pacote Harmony Agente Privado será instalado, mas não configurado. Certifique-se de que todas as dependências sejam satisfeitas (conforme descrito acima), limpe o pacote e instale-o novamente:

    $ sudo dpkg --purge jitterbit-agent
    $ sudo dpkg --install jitterbit-agent_<VERSION>_amd64.deb
    
  3. O Harmony Agente Privado está instalado em /opt/jitterbit. Este local não pode ser alterado.

  4. Após a instalação bem-sucedida, o nome do pacote instalado é jitterbit-agent.

Instalando um Agente com wget

Alternativamente, você pode instalar um Agente Privado Linux usando o wget comando seguindo estas etapas:

  1. Faça login no Portal Harmony e navegue até Downloads página.

  2. Na linha Jitterbit Agente, clique com o botão direito em Linux Debian (x64) na coluna Download e copie o endereço do link.

  3. Instale o Agente Privado usando estes comandos:

    $ sudo wget <URL FROM DOWNLOADS PAGE>
    $ sudo dpkg --install jitterbit-agent_<VERSION>_amd64.deb
    
  4. O Harmony Agente Privado está instalado em /opt/jitterbit. Este local não pode ser alterado.

  5. Após a instalação bem-sucedida, o nome do pacote instalado é jitterbit-agent.

Próximos Passos

Para obter informações sobre como configurar o Agente Privado Linux instalado, consulte Configurando um Agente Privado Linux.

Nota

Os Harmony Agentes Privados não podem ser iniciados sem concluir a configuração etapa.

Importante

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

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