Atualize 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 pequenas atualizações abaixo.

No entanto, há vários casos em que uma desinstalação completa do agente é necessária para atualizar. Essas são consideradas atualizações importantes e são descritas com mais detalhes nas seções a seguir:

• Atualização de um Agente Privado do Windows 10.x para um Agente Privado do Windows 11.x
• Atualização de Agentes Privados do Windows de 32 bits para 64 bits

Agentes Privados também podem ser revertidos para uma versão anterior, conforme descrito no final desta página em Reverter um Agente Privado.

Atualização Secundária¶

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

Um Agente Privado leva muito pouco tempo para atualizar - na ordem de três minutos - dependendo do servidor. Se qualquer interrupção for uma preocupação, você pode 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).

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. Verifique se você precisa desinstalar o agente primeiro após a grande atualização, com base no tipo e na versão do agente instalado:

   • Se atualizar para uma versão de 64 bits (localizada em C:\Program Files\Jitterbit Agent) de uma versão de 32 bits (localizada em C:\Program Files (x86)\Jitterbit Agent).
   • Se atualizar para uma versão 11.x de uma versão 10.x.

3. Instale a nova versão do agente (consulte Instalar um Agente Privado).

4. 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 de seus arquivos salvos.

      Aviso

      A cópia direta de 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 plug-in Notepad++ Compare para ajudá-lo 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 [[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).

Grande Atualização¶

Esta seção descreve as circunstâncias e instruções sob as quais uma desinstalação completa do Agente Privado existente é necessária para atualizar.

Atualize de um Agente Privado do Windows 10.x para um Agente Privado do Windows 11.x¶

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 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 deseja desinstalar o banco de dados PostgreSQL, ele pode permanecer instalado, mas será desabilitado quando um Agente Privado do Windows 11.x for instalado. Neste caso, veja PostgreSQL 9.6 and 14.5 Parallel Installations 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, o driver PostgreSQL ODBC será atualizado para PostgreSQL ODBC 13.2.0.0. Todos os projetos serão baixados novamente pelo agente.

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 de seus arquivos salvos.

      Aviso

      A cópia direta de 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 plug-in Notepad++ Compare para ajudá-lo 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 [[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).

Instalações Paralelas do PostgreSQL 9.6 e 14.5¶

Quando você instala um Agente Privado do Windows 11.x, a instalação detecta uma instalação existente do PostgreSQL 9.6 no registro e avisa que ela será desativada.

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

Atualize de um Agentes Privados do Windows de 32 Bits para um de 64 Bits¶

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

Além disso, as instalações existentes do driver PostgreSQL e PostgreSQL (psqlODBC ou pODBC) devem ser desinstaladas.

Os drivers ODBC de 32 bits existentes não são suportados em Agentes Privados de 64 bits.

Reverter um Agente Privado¶

Não é esperado a necessidade de reverter para uma versão anterior de um Agente Privado. No entanto, caso seja necessário, as etapas são fornecidas abaixo para um rebaixamento menor e um grande rebaixamento.

Rebaixamento 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 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 de seus arquivos salvos.

      Aviso

      A cópia direta de 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 plug-in Notepad++ Compare para ajudá-lo 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 [[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).

Grande Rebaixamento¶

Siga estas etapas para fazer o 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 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 do 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 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 de seus arquivos salvos.

      Aviso

      A cópia direta de 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 plug-in Notepad++ Compare para ajudá-lo 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 [[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).