Atualizar Ou Desinstalar um Agente Privado Linux¶

Introdução¶

A atualização de um Agente Privado de uma versão anterior do Agente Privado para uma posterior pode ser feita sem desinstalar a versão anterior do agente, conforme descrito em Atualizar um Agente abaixo. No entanto, há considerações adicionais ao atualizar de um Agente Privado Linux 10.x para 11.x.

Revertendo um agente e desinstalando um agente também são abordados nesta página.

Atualizar um Agente¶

A atualização de um Agente Privado no Linux pode ser realizada 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.

Para obter mais informações, consulte Debian ou RPM instruções para instalação de um Agente Privado.

As subseções a seguir fornecem instruções para pequenas atualizações e grandes atualizações, juntamente com recomendações para grandes implantações.

Atualização Secundária¶

Atualizações secundárias da mesma versão principal (ou seja, 10.x para 10.x ou 11.x para 11.x) levam apenas alguns minutos para serem concluídas.

Atualização Principal de 10.x para 11.x¶

Os Agentes Privados Linux podem ser atualizados para 11.x a partir de qualquer versão de agente 10.x suportada sem quaisquer comandos adicionais. Uma atualização do banco de dados PostgreSQL e uma atualização do driver PostgreSQL ODBC serão concluídas automaticamente quando o agente for atualizado, desde que os requisitos do PostgreSQL são atendidas.

Ao atualizar para uma versão 11.x do agente, ocorrerá o seguinte:

• O driver PostgreSQL ODBC será atualizado para PostgreSQL ODBC 13.2.0.0.

• Ocorrerá uma sincronização completa dos ambientes. Durante uma sincronização completa, todos os projetos e metadados em cada ambiente são baixados novamente da nuvem Harmony para preencher o banco de dados PostgreSQL.

  Cuidado

  O tempo necessário para realizar uma sincronização completa depende do número e da complexidade dos projetos em cada ambiente. Para uso típico do ambiente, uma sincronização completa normalmente leva até 10 minutos para ser concluída. No entanto, ambientes com um número muito grande de projetos podem levar várias horas para serem sincronizados. Se uma interrupção for uma preocupação, consulte as recomendações para grandes implantações abaixo.

• O agendador tem uma inicialização atrasada de 10 minutos, conforme indicado em Scheduler.log. Durante esse período, as operações agendadas não serão acionadas para execução. Assim que o atraso for concluído, as operações agendadas que teriam sido acionadas para execução durante o atraso serão acionadas para execução.

Recomendações de Atualização para Implantações Grandes¶

Se uma interrupção for uma preocupação durante um upgrade de agente, recomendamos usar alta disponibilidade (dois ou mais agentes) para que as solicitações sejam roteadas para outro agente disponível no grupo de agentes. Se sua assinatura atual não possui agrupamento de agentes, entre em contato com seu Gerente de sucesso do cliente (CSM).

Quando se espera que ocorra uma sincronização completa, como ao atualizar de uma versão de agente 10.x para uma versão 11.x, recomendamos uma abordagem de atualização contínua, na qual você instala novos agentes no modo de espera, um de cada vez, em um grupo de agentes existente. antes de descomissionar os agentes existentes. Essa abordagem fornece um caminho de reversão limpo, caso seja necessário.

Iniciar agentes no modo de espera envolve adicionar uma configuração ao arquivo de propriedades de um agente (jitterbit-agent-config.properties) para garantir que o agente fique fora de serviço e não comece a acumular uma lista de pendências de solicitações antes que a sincronização completa seja concluída.

Para implementar uma abordagem de atualização contínua:

1. Instale um novo agente em um grupo de agentes existente seguindo o Debian ou RPM instruções para instalar um Agente Privado Linux.

2. No novo agente jitterbit-agent-config.properties, adicione o arquivo agent.starting.standby propriedade definida como true para forçar o agente a permanecer em Iniciando status do agente e evitar que ele entre em um estado Running onde possa aceitar solicitações.

3. Reinicie o agente.

4. À medida que o agente é inicializado, você pode monitorar o status de sincronização no arquivo jitterbit-agent.log arquivo, procurando linhas semelhantes às abaixo que indicam quando a sincronização foi iniciada e concluída:

   Agent synchronization for environment <123456> and agent group ID <987654> started at ...
   . . .
   Agent synchronization for environment <123456> and agent group ID <987654> completed at ...
   

5. Assim que os registros indicarem que a sincronização foi concluída, remova o agent.starting.standby propriedade ou alterar seu valor para false e reinicie o agente.

6. Quando o novo agente reportar o status Em execução, desative um agente anterior no grupo de agentes.

7. Repita esse processo para cada agente do grupo de agentes para garantir que as solicitações continuem a ser roteadas para um agente capaz durante o processo de upgrade.

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

1. Faça backup dos arquivos de configuração e certificados de segurança para referência (opcional; consulte Desinstalar Agente abaixo).
2. Desinstale o agente (consulte Desinstalar Agente abaixo).
3. Remova todos os arquivos relacionados ao Jitterbit (consulte Desinstalar Agente abaixo).
4. Instale a versão selecionada do agente. Consulte Instalar um Agente Harmony Linux (Debian ou RPM).

5. Para usar seus arquivos de backup (opcional):

   1. Interrompa os serviços do agente (consulte Reiniciar 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 Reiniciar um Agente Privado Linux).

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

/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

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

$ sudo dpkg --remove jitterbit-agent

$ sudo apt-get remove jitterbit-agent

$ yum remove jitterbit-agent

$ rpm --erase jitterbit-agent

Remover Todos os Arquivos Relacionados ao Jitterbit¶

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