Atualizar Ou Desinstalar um Agente Privado Linux¶

Visão Geral¶

Estas são as instruções sobre como atualizar ou desinstalar um Agente Privado Linux em distribuições Linux baseadas em 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.

Atualizando um Agente¶

Aviso

Atualizando de um Agente Privado Linux de 32 bits para um de 64 bits

As versões existentes do agente de 32 bits devem ser desinstaladas antes da atualização (consulte as instruções para Desinstalação do Linux).
As instalações existentes do PostgreSQL e do driver PostgreSQL (psqlODBC ou pODBC) devem ser desinstaladas.
Drivers ODBC de 32 bits existentes não são suportados.

Nota

Se você estiver atualizando um agente de versão existente de 64 bits para um agente de versão superior de 64 bits, não será necessário desinstalar o agente existente antes de atualizar.

Nota

Se você estiver atualizando da versão 10.37 para 10.38, consulte 10.38 Linux Agentes Privados em Problemas conhecidos do Agente Privado para obter informações sobre um problema conhecido que ocorre durante a atualização do Agente Privado.

A atualização do pacote Agente Privado no Linux pode ser executada usando os mesmos comandos usados durante a instalação inicial. Você não precisa executar o script de configuração ao atualizar um Agente Privado existente. Os Agentes Privados do Linux podem ser atualizados para 11.x a partir de qualquer versão do agente 10.x sem quaisquer comandos adicionais.

Ao atualizar um Agente Privado Linux de uma versão anterior à 10.37 para uma versão 10.37 ou posterior, o banco de dados PostgreSQL será reinicializado à medida que for atualizado para a versão 9.6. Esta atualização recriará o banco de dados em seu Agente Privado e seus dados serão recuperados durante o processo de atualização. Após a atualização, quaisquer backups criados usando uma versão anterior do PostgreSQL não serão compatíveis. O processo de atualização pode levar mais de 30 minutos dependendo do número de projetos e do tamanho dos ambientes associados ao seu grupo de Agente Privado. Quaisquer trabalhos pendentes serão colocados em uma fila pendente para serem executados após a conclusão da atualização.

Um Agente Privado leva pouco tempo para atualizar – aproximadamente três minutos – dependendo do servidor. Se uma interrupção for uma preocupação, você poderá usar alta disponibilidade (dois ou mais agentes) e não têm tempo de inatividade. Se sua assinatura atual não tiver agentes adicionais disponíveis para isso, entre em contato com seu Gerente de Sucesso do Cliente (CSM).

Para atualizar um Agente Privado, siga estas etapas:

Verifique se você precisa desinstalar o agente primeiro, com base no tipo de Agente Privado instalado: é 32 bits ou 64 bits? (opcional; consulte Determinando o tipo de Agente instalado e Desinstalar Agente abaixo)
Instale a nova versão do agente. Para obter mais informações, consulte Instalando um Agente Harmony Linux (Debian ou RPM)

Nota

Todos os arquivos de configuração são retidos durante uma atualização do Agente Privado.

Determinando o Tipo de Agente Instalado¶

Para determinar o tipo de agente que você instalou (32 bits ou 64 bits), você pode usar um comando para verificar quais pacotes estão instalados. Se você estiver atualizando do Agente Privado de 32 bits para 64 bits, deverá desinstalar o agente atual primeiro.

DebianRPM

Use o dpkg comando para verificar o instalado jitterbit-agent pacote:

$ dpkg -l | grep 'jitterbit-agent'

Isso retornará uma saída que inclui i386 (para 32 bits) ou amd64 (para 64 bits), como:

ii  jitterbit-agent:i386      10.xx.x.x      i386       Jitterbit Agent
ii  jitterbit-agent:amd64     10.xx.x.x      amd64      Jitterbit Agent

Use o rpm comando para verificar o instalado jitterbit-agent pacote:

$ rpm -qi `rpm -qa | grep jitterbit-agente` | grep Architecture:

Isso retornará uma saída que inclui i386 (para 32 bits) ou amd64 (para 64 bits), como:

Architecture: i386
Architecture: amd64

Revertendo um Agente¶

Não se espera que seja necessário reverter para uma versão anterior de um Agente Privado. No entanto, caso seja necessário, estas são as etapas:

Faça backup dos arquivos de configuração e certificados de segurança para referência (opcional; consulte Desinstalar Agente abaixo).
Desinstale o agente (consulte Desinstalar Agente abaixo).
Remova todos os arquivos relacionados ao Jitterbit (consulte Desinstalar Agente abaixo).
Instale a versão selecionada do agente. Consulte Instalando um Agente Harmony Linux (Debian ou RPM).
Para usar seus arquivos de backup (opcional):
1. Interrompa os serviços do agente (consulte Reiniciando um Agente Privado Linux).
2. Coloque seus certificados de segurança salvos no diretório de instalação. Atualize manualmente os arquivos de configuração recém-instalados com base nas configurações dos arquivos salvos.
  
  Aviso
  
  Copiar diretamente os arquivos de configuração salvos após uma alteração na versão do agente pode causar erros. Em vez disso, use ferramentas como o plugin Notepad++ Compare para ajudá-lo a comparar e atualizar manualmente as definições de configuração. Não altere configurações com senhas ou portas definidas, como as encontradas no credentials.txt arquivo e sob o [[DbInfo seção do jitterbit.conf arquivo]](/pt/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).
3. Inicie os serviços do agente (consulte Reiniciando um Agente Privado Linux).

Desinstalando um Agente¶

Antes de desinstalar, é recomendável salvar os arquivos de configuração e os certificados de segurança da instalação atual para fins de referência. Eles normalmente estão localizados em:

Files

/opt/jitterbit/jitterbit.conf
/opt/jitterbit/apache/conf/httpd.conf
/opt/jitterbit/JdbcDrivers.conf
/opt/jitterbit/Resources/jitterbit-agent-config.properties
/opt/jitterbit/Resources/credentials.txt

Directories

/opt/jitterbit/apache/conf/extra/
/opt/jitterbit/apache/conf/ssl.crt/
/opt/jitterbit/apache/conf/ssl.key/

Cuidado

Para poder usar seus arquivos de backup em uma instalação futura, você deve interromper os serviços enquanto move os arquivos e, em seguida, reiniciar os serviços quando concluídos (consulte Reiniciando um Agente Privado Linux).

Aviso

Copiar diretamente os arquivos de configuração salvos após uma alteração na versão do agente pode causar erros. Em vez disso, use ferramentas como o plugin Notepad++ Compare para ajudá-lo a comparar e atualizar manualmente as definições de configuração. Não altere configurações com senhas ou portas definidas, como as encontradas no credentials.txt arquivo e sob o [[DbInfo seção do jitterbit.conf arquivo]](/pt/agent/private-agents/private-agent-how-tos/edit-the-configuration-file-jitterbit-conf/#editingtheconfigurationfilejitterbit.conf-db-info).

DebianRPM

Use isto dpkg comando para desinstalar o Harmony Agente Privado:

$ sudo dpkg --remove jitterbit-agent

Você também pode usar o apt-get comando para desinstalar o Harmony Agente Privado:

$ sudo apt-get remove jitterbit-agent

Use isto yum comando para desinstalar o Harmony Agente Privado:

$ yum remove jitterbit-agent

Você também pode usar este rpm comando para desinstalar o Harmony Agente Privado:

$ rpm --erase jitterbit-agent

A desinstalação removerá os arquivos instalados durante a instalação. O /opt/jitterbit O diretório e o banco de dados do Harmony Agente Privado não são apagados automaticamente e podem incluir arquivos de log e arquivos de aplicativos gerados durante a execução de operações. Para remover completamente todos os arquivos relacionados ao Jitterbit, use estes dois comandos:

$ sudo rm -rf /opt/jitterbit
$ sudo rm -rf /tmp/jitterbit

Próximos Passos¶