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 do Agente Privado 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 Windows Agente Privado 10.x para 11.x, será necessária uma desinstalação completa do agente.

Revertendo um agente para uma versão anterior também é abordada 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.

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.

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

Siga estas instruções para atualizações secundárias de 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 (consulte Instalar um Agente Privado).

  3. Para usar os arquivos de backup (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 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).

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

Uma desinstalação completa dos Windows Agentes Privados 10.x existentes é necessária para atualizar para a versão 11.x Windows Agentes Privados.

Para atualizar de um Windows Agente Privado 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 (consulte 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 (consulte 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. 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 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).

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

  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 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.xe 14.5.x do PostgreSQL forem instaladas em paralelo, a instalação do Windows Agente Privado 11.x forçará o driver PostgreSQL ODBC a ser atualizado para o PostgreSQL 13.2.0.0.

Reverter um Agente Privado

Não se espera 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.

Downgrade Menor

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 (consulte Desinstalar um Agente Privado).

  4. Instale a versão selecionada do agente (consulte Instalar um Agente Privado).

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

Rebaixamento Importante

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