Atualizar ou desinstalar um agente privado Linux Jitterbit

Introdução

A atualização de um agente privado de uma versão anterior 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 um 11.x.

Revertendo um agente e desinstalar 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 mais informações, veja Debian ou RPM instruções para instalar um agente privado.

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

Pequena atualização

Pequenas atualizações 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.

Se você tiver adicionado certificados ao arquivo repositório de chaves (/opt/jitterbit/jre/lib/security/cacerts), restaure-o da sua cópia de backup e reinicie o agente.

Grande atualização de 10.x para 11.x

Os agentes privados do 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 ODBC PostgreSQL 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 ODBC do PostgreSQL será atualizado para o PostgreSQL ODBC 13.2.0.0.

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

  Cuidado

  O tempo que leva para executar 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 sincronizar. Se uma interrupção for uma preocupação, consulte as recomendações para grandes implantações abaixo.

• O agendador tem um atraso de inicialização de 10 minutos, conforme indicado em Scheduler.log. Durante esse tempo, as operações programadas não serão acionadas para execução. Uma vez que o atraso for concluído, as operações programadas que teriam sido acionadas para execução durante o atraso serão acionadas para execução.

Recomendações de atualização para grandes implantações

Se uma interrupção for uma preocupação durante uma atualização 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 tiver 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 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 um backlog 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 arquivo, adicione o agent.starting.standby propriedade definida para true para forçar o agente a permanecer em Iniciando status do agente e evitar que ele entre em um estado Em execução onde ele pode aceitar solicitações.

3. Reinicie o agente.

4. Conforme o agente é inicializado, você pode monitorar o status de sincronização no agente jitterbit-agent.log arquivo, procurando por linhas semelhantes às abaixo que indicam quando a sincronização começou e foi 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 logs 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 relatar o status Em execução, descomissione um antigo agente no grupo de agentes.

7. Repita esse processo para cada agente no grupo de agentes para garantir que as solicitações continuem sendo roteadas para um agente capaz durante o processo de atualização.

Reverter um agente

Não é esperado 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 (veja Uninstall agent abaixo).
4. Instale a versão selecionada do agente. Veja Instalar um agente Linux (Debian ou RPM).

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

   1. Pare os serviços do agente (consulte Reiniciar um agente privado do 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 em seus arquivos salvos.

      Aviso

      Copiar diretamente os arquivos de configuração salvos após uma alteração de versão do agente pode causar erros. Em vez disso, use ferramentas como o plugin Notepad++ Compare para ajudar você a comparar e atualizar manualmente as configurações. Não altere as configurações com senhas ou portas definidas, como as encontradas no credentials.txt arquivo e sob o [[DbInfoseçã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 do Linux).

Desinstalar um agente

Antes de desinstalar, é recomendado salvar os arquivos de configuração e certificados de segurança para sua instalação atual para fins referenciais. Eles geralmente 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 apt-get remove jitterbit-agent

$ yum remove jitterbit-agent

$ rpm --erase jitterbit-agent

Remova todos os arquivos relacionados ao Jitterbit

A desinstalação removerá os arquivos instalados durante a instalação. O /opt/jitterbit diretório e o banco de dados do agente privado Jitterbit não são apagados automaticamente e podem incluir arquivos de log e arquivos de aplicativo gerados ao executar 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