Ir para o conteúdo

Atualizar um Agente Privado do Windows

Introdução

A atualização de um agente privado de uma versão anterior para uma posterior geralmente pode ser feita sem desinstalar a versão anterior do agente, conforme descrito em Atualizar um agente abaixo. No entanto, ao atualizar de um agente privado do Windows 10.x para um 11.x, uma desinstalação completa do agente é necessária.

Revertendo um agente para uma versão anterior também é abordado nesta página.

Atualizar um Agente

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

Pequena Atualização

Atualizações menores 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.

Para uma atualização menor, geralmente, você usa as instruções para instalar um agente privado e siga os prompts para atualizar a instalação do agente existente.

Siga estas instruções para atualizações secundárias do agente:

  1. Faça backup dos arquivos de configuração e certificados de segurança para referência (opcional; consulte Desinstalar um agente privado).

  2. Instale a nova versão do agente (veja Instalar um agente privado).

  3. Para usar os arquivos de backup (opcional):

    1. Pare os serviços do agente (veja Reiniciar um agente privado).

    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).

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

Uma desinstalação completa dos agentes privados do Windows 10.x existentes é necessária para atualizar para os agentes privados do Windows versão 11.x.

Para atualizar de um agente privado do Windows 10.x para 11.x, siga estas etapas:

  1. Faça backup dos arquivos de configuração do agente e dos certificados de segurança para referência (opcional, consulte Desinstalar um agente privado).
  2. Desinstale o agente 10.x existente (consulte Desinstalar um agente privado).
  3. Remova todos os arquivos relacionados ao Jitterbit (veja Desinstalar um agente privado).

  4. Além de desinstalar o agente, é altamente recomendável desinstalar o banco de dados PostgreSQL 9.6.x existente. Se você não quiser desinstalar o banco de dados PostgreSQL, ele poderá permanecer instalado, mas será desativado quando um agente privado do Windows 11.x for instalado. Neste caso, consulte Instalações paralelas do PostgreSQL 9.6 e 14.5 abaixo.

  5. Instale a versão 11.x do agente (veja Instalar um agente privado). 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.

  6. Para usar os arquivos de backup de configuração do agente (opcional):

    1. Pare os serviços do agente (consulte Reiniciar um agente privado).

    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).

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 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 as instruções para instalação de um agente privado do Windows.

  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.

Instalações Paralelas do PostgreSQL 9.6 e 14.5

Ao instalar um agente privado do Windows 11.x, a instalação detectará uma instalação existente do PostgreSQL 9.6 no registro e avisará que ela será desabilitada.

Ao reconhecer o aviso, o banco de dados PostgreSQL 9.6 existente será interrompido, a execução automática do serviço PostgreSQL 9.6 do Windows será desabilitada e a versão 14.5-1 do PostgreSQL será instalada com a instalação do agente 11.x.

Nota

Se as versões 9.6.x e 14.5.x do PostgreSQL forem instaladas em paralelo, a instalação do agente privado do Windows 11.x forçará o upgrade do driver ODBC do PostgreSQL para o PostgreSQL 13.2.0.0.

Reverter um Agente Privado

Não é esperado que seja necessário reverter para uma versão anterior de um agente privado. No entanto, caso seja necessário, as etapas são fornecidas abaixo para um pequeno downgrade e um grande rebaixamento.

Pequeno Rebaixamento

Siga estas etapas para fazer downgrade de um agente 11.x para um agente 10.x anterior, ou de um agente 10.x para um agente 10.x anterior:

  1. Faça backup dos arquivos de configuração do agente e dos certificados de segurança para referência (opcional, consulte Desinstalar um agente privado).
  2. Desinstale o agente (consulte Desinstalar um agente privado).
  3. Remova todos os arquivos relacionados ao Jitterbit (veja Desinstalar um agente privado).

  4. Instale a versão selecionada do agente (veja Instalar um agente privado).

  5. Para usar os arquivos de backup de configuração do agente (opcional):

    1. Pare os serviços do agente (consulte Reiniciar um agente privado).

    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).

Grande Rebaixamento

Siga estas etapas para fazer downgrade de um agente privado do Windows 11.x para um agente privado do Windows 10.x:

  1. Faça backup dos arquivos de configuração do agente e dos certificados de segurança para referência (opcional, consulte Desinstalar um agente privado).
  2. Desinstale o agente (consulte Desinstalar um agente privado).
  3. Remova todos os arquivos relacionados ao Jitterbit (veja Desinstalar um agente privado).

  4. Desinstale o driver ODBC PostgreSQL 13.2.0.0.

  5. Desinstale o driver Microsoft Visual C++.

  6. Instale o PostgreSQL 9.6 antes de instalar o agente 10.x. A instalação do PostgreSQL 9.6 pode existir ao mesmo tempo que a instalação do PostgreSQL 14.5; não há necessidade de desinstalar o PostgreSQL 14.

  7. Instale a versão 10.x do agente (consulte Instalar um agente privado). Durante a instalação, a presença do PostgreSQL 9.6 será detectada automaticamente e o processo de instalação o direcionará para realizar uma instalação avançada.

  8. Para usar os arquivos de backup de configuração do agente (opcional):

    1. Interrompa os serviços do agente (consulte Reiniciar um agente privado).

    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)